gpt-image-2.6-sunburst API - Image Generation with LinkModel

POST

images

generations

gpt-image-2.6-sunburst

curl --request POST \
  --url https://api.linkmodel.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "extends.edit.mask": "<string>",
  "extends.edit.markup": "<string>",
  "extends.edit.mask_is_base64": true,
  "extends.edit.markup_is_base64": true,
  "size": "auto",
  "max_images": 1,
  "output_format": "png",
  "frame_count": 9,
  "frame_duration_ms": 21,
  "output_compression": 50,
  "moderation": "<string>"
}
'

import requests

url = "https://api.linkmodel.ai/v1/images/generations"

payload = {
    "model": "gpt-image-2.6-sunburst",
    "prompt": "<string>",
    "images": ["<string>"],
    "extends.edit.mask": "<string>",
    "extends.edit.markup": "<string>",
    "extends.edit.mask_is_base64": True,
    "extends.edit.markup_is_base64": True,
    "size": "auto",
    "max_images": 1,
    "output_format": "png",
    "frame_count": 9,
    "frame_duration_ms": 21,
    "output_compression": 50,
    "moderation": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'gpt-image-2.6-sunburst',
    prompt: '<string>',
    images: ['<string>'],
    'extends.edit.mask': '<string>',
    'extends.edit.markup': '<string>',
    'extends.edit.mask_is_base64': true,
    'extends.edit.markup_is_base64': true,
    size: 'auto',
    max_images: 1,
    output_format: 'png',
    frame_count: 9,
    frame_duration_ms: 21,
    output_compression: 50,
    moderation: '<string>'
  })
};

fetch('https://api.linkmodel.ai/v1/images/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.linkmodel.ai/v1/images/generations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'gpt-image-2.6-sunburst',
    'prompt' => '<string>',
    'images' => [
        '<string>'
    ],
    'extends.edit.mask' => '<string>',
    'extends.edit.markup' => '<string>',
    'extends.edit.mask_is_base64' => true,
    'extends.edit.markup_is_base64' => true,
    'size' => 'auto',
    'max_images' => 1,
    'output_format' => 'png',
    'frame_count' => 9,
    'frame_duration_ms' => 21,
    'output_compression' => 50,
    'moderation' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.linkmodel.ai/v1/images/generations"

	payload := strings.NewReader("{\n  \"model\": \"gpt-image-2.6-sunburst\",\n  \"prompt\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ],\n  \"extends.edit.mask\": \"<string>\",\n  \"extends.edit.markup\": \"<string>\",\n  \"extends.edit.mask_is_base64\": true,\n  \"extends.edit.markup_is_base64\": true,\n  \"size\": \"auto\",\n  \"max_images\": 1,\n  \"output_format\": \"png\",\n  \"frame_count\": 9,\n  \"frame_duration_ms\": 21,\n  \"output_compression\": 50,\n  \"moderation\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.linkmodel.ai/v1/images/generations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"gpt-image-2.6-sunburst\",\n  \"prompt\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ],\n  \"extends.edit.mask\": \"<string>\",\n  \"extends.edit.markup\": \"<string>\",\n  \"extends.edit.mask_is_base64\": true,\n  \"extends.edit.markup_is_base64\": true,\n  \"size\": \"auto\",\n  \"max_images\": 1,\n  \"output_format\": \"png\",\n  \"frame_count\": 9,\n  \"frame_duration_ms\": 21,\n  \"output_compression\": 50,\n  \"moderation\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.linkmodel.ai/v1/images/generations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"gpt-image-2.6-sunburst\",\n  \"prompt\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ],\n  \"extends.edit.mask\": \"<string>\",\n  \"extends.edit.markup\": \"<string>\",\n  \"extends.edit.mask_is_base64\": true,\n  \"extends.edit.markup_is_base64\": true,\n  \"size\": \"auto\",\n  \"max_images\": 1,\n  \"output_format\": \"png\",\n  \"frame_count\": 9,\n  \"frame_duration_ms\": 21,\n  \"output_compression\": 50,\n  \"moderation\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "code": 0,
  "data": {
    "task_id": "aurora_abc123",
    "order_id": "019da9cf-d1db-78e1-ac23-526774d01193",
    "status": "Processing",
    "price": 0.074
  },
  "msg": "success",
  "request_id": "250b66dd-e1fb-4bb6-b5f6-c668efadc35d"
}

{
  "code": 400,
  "msg": "task_id is required",
  "request_id": "96be7a7d-3e81-4916-a6b8-19b32773a693"
}

{
  "code": 401,
  "data": {},
  "msg": "invalid api key",
  "request_id": "bff4c295-c7da-4507-9708-4627cb6373ba"
}

{
  "code": 500,
  "msg": "create task failed: billing: code=100601: insufficient balance",
  "request_id": "3409f6fb-fa9a-4534-b530-195b5f6f4e32"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

model

enum<string>

default:gpt-image-2.6-sunburst

required

Must be one of: gpt-image-2.6-sunburst. Defaults to gpt-image-2.6-sunburst.

Available options:

gpt-image-2.6-sunburst

prompt

string

required

Length must be between 1 and 32000.

Required string length: 1 - 32000

images

string<url>[]

Temporary platform limit: 1-14 reference images. Full 16-image support awaits Aurora code fix.

Conditional limits:

svg is text-to-image only; input images are not supported

Required array length: 1 - 14 elements

extends.edit.mask

string

Optional URL or Base64 edit mask. Requires images, unsupported for gif/svg, and mutually exclusive with markup.

Conditional limits:

mask requires at least one input image
gif and svg do not support mask

extends.edit.markup

string

Independent transparent PNG layer for the first input image. HTTPS URL or Base64 PNG selected by markup_is_base64. Requires images; mutually exclusive with mask. Server checks PNG, alpha, corrected dimensions, <=50 MB and <=16777216 pixels.

Conditional limits:

markup requires at least one input image
svg does not support markup

extends.edit.mask_is_base64

boolean

Set true for Base64 mask; omit or false for URL. The typed edit DTO validates this flag.

This field's allowed values depend on: extends.edit.mask.

extends.edit.markup_is_base64

boolean

Set true for Base64 PNG markup; omit or false for HTTPS URL. The typed edit DTO validates this flag.

This field's allowed values depend on: extends.edit.markup.

size

enum<string>

default:auto

Choose a preset size. GIF supports only auto. Defaults to auto.

Conditional limits:

GIF currently supports only size=auto when size is provided

Available options:

1008x1792,

1024x1024,

1024x1536,

1280x960,

1536x1024,

1792x1008,

2048x1152,

960x1280,

auto

quality

enum<string>

Optional. Omit to use upstream behavior; no platform quality default.

Available options:

auto,

high,

low,

max,

medium,

xhigh

complexity

enum<string>

Optional and independent of quality. Omit to use upstream default high; no platform default.

Available options:

high,

low,

medium

max_images

integer

default:1

Must be between 1 and 10. Defaults to 1.

Conditional limits:

svg requires max_images=1

Required range: 1 <= x <= 10

output_format

enum<string>

default:png

png is default. GIF animation or SVG text-to-image needs only output_format; no svg.model. Defaults to png.

Available options:

gif,

jpeg,

png,

webp

frame_count

integer

GIF only, integer 2-16. Omit to use upstream default 9; explicit zero is invalid.

Conditional limits:

frame_count is only supported with gif

Required range: 2 <= x <= 16

frame_duration_ms

integer

GIF only, integer >=20. Omit to use upstream default 200. Preserve the submitted integer without rounding.

Conditional limits:

frame_duration_ms is only supported with gif

Required range: x >= 20

output_compression

integer

Integer 0-100, including 0. Only set for jpeg or webp; omit for png.

Conditional limits:

output_compression is only supported with jpeg or webp

Required range: 0 <= x <= 100

background

enum<string>

transparent requires png or webp. Omitted output_format uses png.

Conditional limits:

transparent background requires png or webp

Available options:

auto,

opaque,

transparent

moderation

string

Length must be at most 0.

Response

Business response. code=0 means the task was accepted; validation failures can return HTTP 200 with code=400.

Option 1
Option 2

code

enum<integer>

required

Available options:

0

Example:

0

data

object

required

Show child attributes

msg

string

required

Example:

"success"

request_id

string<uuid>

Example:

"250b66dd-e1fb-4bb6-b5f6-c668efadc35d"

gpt-image-2.6-sunburst

curl --request POST \
  --url https://api.linkmodel.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "<string>",
  "images": [
    "<string>"
  ],
  "extends.edit.mask": "<string>",
  "extends.edit.markup": "<string>",
  "extends.edit.mask_is_base64": true,
  "extends.edit.markup_is_base64": true,
  "size": "auto",
  "max_images": 1,
  "output_format": "png",
  "frame_count": 9,
  "frame_duration_ms": 21,
  "output_compression": 50,
  "moderation": "<string>"
}
'

import requests

url = "https://api.linkmodel.ai/v1/images/generations"

payload = {
    "model": "gpt-image-2.6-sunburst",
    "prompt": "<string>",
    "images": ["<string>"],
    "extends.edit.mask": "<string>",
    "extends.edit.markup": "<string>",
    "extends.edit.mask_is_base64": True,
    "extends.edit.markup_is_base64": True,
    "size": "auto",
    "max_images": 1,
    "output_format": "png",
    "frame_count": 9,
    "frame_duration_ms": 21,
    "output_compression": 50,
    "moderation": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'gpt-image-2.6-sunburst',
    prompt: '<string>',
    images: ['<string>'],
    'extends.edit.mask': '<string>',
    'extends.edit.markup': '<string>',
    'extends.edit.mask_is_base64': true,
    'extends.edit.markup_is_base64': true,
    size: 'auto',
    max_images: 1,
    output_format: 'png',
    frame_count: 9,
    frame_duration_ms: 21,
    output_compression: 50,
    moderation: '<string>'
  })
};

fetch('https://api.linkmodel.ai/v1/images/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.linkmodel.ai/v1/images/generations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => 'gpt-image-2.6-sunburst',
    'prompt' => '<string>',
    'images' => [
        '<string>'
    ],
    'extends.edit.mask' => '<string>',
    'extends.edit.markup' => '<string>',
    'extends.edit.mask_is_base64' => true,
    'extends.edit.markup_is_base64' => true,
    'size' => 'auto',
    'max_images' => 1,
    'output_format' => 'png',
    'frame_count' => 9,
    'frame_duration_ms' => 21,
    'output_compression' => 50,
    'moderation' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.linkmodel.ai/v1/images/generations"

	payload := strings.NewReader("{\n  \"model\": \"gpt-image-2.6-sunburst\",\n  \"prompt\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ],\n  \"extends.edit.mask\": \"<string>\",\n  \"extends.edit.markup\": \"<string>\",\n  \"extends.edit.mask_is_base64\": true,\n  \"extends.edit.markup_is_base64\": true,\n  \"size\": \"auto\",\n  \"max_images\": 1,\n  \"output_format\": \"png\",\n  \"frame_count\": 9,\n  \"frame_duration_ms\": 21,\n  \"output_compression\": 50,\n  \"moderation\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.linkmodel.ai/v1/images/generations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"gpt-image-2.6-sunburst\",\n  \"prompt\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ],\n  \"extends.edit.mask\": \"<string>\",\n  \"extends.edit.markup\": \"<string>\",\n  \"extends.edit.mask_is_base64\": true,\n  \"extends.edit.markup_is_base64\": true,\n  \"size\": \"auto\",\n  \"max_images\": 1,\n  \"output_format\": \"png\",\n  \"frame_count\": 9,\n  \"frame_duration_ms\": 21,\n  \"output_compression\": 50,\n  \"moderation\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.linkmodel.ai/v1/images/generations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"gpt-image-2.6-sunburst\",\n  \"prompt\": \"<string>\",\n  \"images\": [\n    \"<string>\"\n  ],\n  \"extends.edit.mask\": \"<string>\",\n  \"extends.edit.markup\": \"<string>\",\n  \"extends.edit.mask_is_base64\": true,\n  \"extends.edit.markup_is_base64\": true,\n  \"size\": \"auto\",\n  \"max_images\": 1,\n  \"output_format\": \"png\",\n  \"frame_count\": 9,\n  \"frame_duration_ms\": 21,\n  \"output_compression\": 50,\n  \"moderation\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "code": 0,
  "data": {
    "task_id": "aurora_abc123",
    "order_id": "019da9cf-d1db-78e1-ac23-526774d01193",
    "status": "Processing",
    "price": 0.074
  },
  "msg": "success",
  "request_id": "250b66dd-e1fb-4bb6-b5f6-c668efadc35d"
}

{
  "code": 400,
  "msg": "task_id is required",
  "request_id": "96be7a7d-3e81-4916-a6b8-19b32773a693"
}

{
  "code": 401,
  "data": {},
  "msg": "invalid api key",
  "request_id": "bff4c295-c7da-4507-9708-4627cb6373ba"
}

{
  "code": 500,
  "msg": "create task failed: billing: code=100601: insufficient balance",
  "request_id": "3409f6fb-fa9a-4534-b530-195b5f6f4e32"
}

Models

Image Generation

Video Generation

Chat

Credits

API Keys

Files API

Audio Generation

API essentials

gpt-image-2.6-sunburst

Authorizations

Body

Response