创建 GPT Image 2.6 任务

POST

images

curl --request POST \
  --url https://sigrunai.com/v1/images \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-image-2",
  "prompt": "Minimal product still life, white background, soft light",
  "quality": "medium",
  "n": 1,
  "ratio": "1:1"
}
'

{
  "code": 20000,
  "msg": "<string>",
  "data": {
    "task_id": "<string>",
    "status": "<string>",
    "progress": 123,
    "model": "<string>",
    "created_at": 123,
    "completed_at": 123,
    "cost": 123,
    "error_message": "<string>",
    "result": {
      "image_url": "<string>",
      "video_url": "<string>"
    }
  }
}

创建 GPT Image 2.6 异步生图任务。成功后返回 task_id，请用查询图片任务轮询，完成后从 result.image_url 取图。 GPT Image 2 见创建 GPT Image 2 任务。Nano Banana 见创建 Nano Banana 任务。

模型

`model`	说明	计费
`gpt-image-2.6-flare`	更快	`per_task`
`gpt-image-2.6-sunburst`	更精细	`per_task`

两个模型各自按次计费。quality 只影响生成效果，不改变单价。实际单价以模型目录和创建响应里的 cost 为准。你也可以把质量写进模型名，例如 gpt-image-2.6-sunburst-max。这只是设置 quality，计费模型仍是 gpt-image-2.6-sunburst。

请求参数

字段	类型	必填	说明
`model`	string	是	见上表
`prompt`	string	是	提示词，1–32000 字符
`quality`	string	否	`auto`（默认）、`low`、`medium`、`high`、`xhigh`、`max`
`n`	int	否	只支持 1。省略时按 1 张计费
`ratio`	string	否	`auto`、`1:1`、`3:2`、`2:3`、`4:3`、`3:4`、`5:4`、`4:5`、`16:9`、`9:16`、`21:9`
`size`	string	否	`ratio` 别名。不接受像素尺寸，例如 `1024x1024`
`resolution`	string	否	只支持省略或 `1k`
`output_format`	string	否	`png`、`jpeg`、`webp`、`svg`、`gif`。`jpg` 按 `jpeg` 处理
`images`	string[]	否	参考图公网 URL，最多 16 张
`smart_queue`	bool	否	默认 `false`。为 `true` 时，近期成功率过低会先保持 `queued`，恢复后再提交（最长约 2 小时）。详见智能排队

svg 和 gif 不能带参考图。gif 的 size / ratio 只能省略或传 auto。

示例

文生图

curl -X POST 'https://sigrunai.com/v1/images' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-2.6-flare",
    "prompt": "极简产品静物，白色背景，柔光",
    "quality": "medium",
    "n": 1,
    "ratio": "1:1",
    "resolution": "1k",
    "output_format": "png"
  }'

参考图编辑

curl -X POST 'https://sigrunai.com/v1/images' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-2.6-sunburst",
    "prompt": "保持产品外观，换成摄影棚柔光背景",
    "quality": "high",
    "size": "16:9",
    "images": ["https://example.com/product.jpg"]
  }'

成功响应示例：

{
  "code": 20000,
  "msg": "提交成功",
  "data": {
    "task_id": "img_xxxxxxxx",
    "status": "queued",
    "progress": 0,
    "model": "gpt-image-2.6-flare",
    "cost": 0.4,
    "result": {}
  }
}

授权

Authorization

string

header

必填

控制台创建的 API Key，格式：Bearer sk_xxx

请求体

application/json

model

string

必填

gpt-image-2 (plus low/medium/high), gpt-image-2.6-flare / gpt-image-2.6-sunburst, nano-banana-2 / nano-banana-2.1 / nano-banana-pro, seedream-5.5, or muse-image

示例:

"nano-banana-2"

prompt

string

GPT Image 2 / Seedream 5.5 / Muse Image max 4000; GPT Image 2.6 max 32000; Nano Banana max 10000. Nano Banana / Seedream prompt is optional when images are provided. Muse Image prompt is always required

Required string length: 1 - 32000

quality

enum<string>

默认值:auto

GPT Image 2: auto / low / medium / high, billed by tier. GPT Image 2.6 also accepts xhigh / max without changing the price

可用选项:

auto,

low,

medium,

high,

xhigh,

max

integer

默认值:1

GPT Image 2 accepts 1–4. GPT Image 2.6, Nano Banana, Seedream 5.5, and Muse Image accept 1 only

必填范围: 1 <= x <= 4

ratio

string

size

string

Alias of ratio. GPT Image 2.6 accepts auto or an aspect ratio, not a pixel size. Muse Image reduces a pixel size such as 1024x1024 to its ratio

resolution

string

GPT Image 2.6 accepts 1k only. Nano Banana: 0.5k/1k/2k/4k depending on the model

images

string<uri>[]

Reference image URLs. GPT Image 2 max 15; GPT Image 2.6 max 16; Nano Banana max 5; Seedream 5.5 max 8; Muse Image max 10. GPT Image 2.6 svg and gif cannot include reference images

Maximum array length: 16

output_format

enum<string>

GPT Image 2.6 only. jpg is treated as jpeg. For gif, omit size or send auto

可用选项:

png,

jpeg,

webp,

svg,

gif

style

string

Muse Image only. Free-text style such as photorealistic, anime, or cinematic

Maximum string length: 1000

negative_prompt

string

Muse Image only. What should not appear, kept apart from prompt

Maximum string length: 1000

smart_queue

boolean

默认值:false

When true, a very low recent success rate keeps the task queued until recovery (up to about 2 hours)

响应

200 - application/json

提交成功

code

integer

示例:

20000

msg

string

data

object

Show child attributes

最后修改于 2026年11月6日

curl --request POST \
  --url https://sigrunai.com/v1/images \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-image-2",
  "prompt": "Minimal product still life, white background, soft light",
  "quality": "medium",
  "n": 1,
  "ratio": "1:1"
}
'

{
  "code": 20000,
  "msg": "<string>",
  "data": {
    "task_id": "<string>",
    "status": "<string>",
    "progress": 123,
    "model": "<string>",
    "created_at": 123,
    "completed_at": 123,
    "cost": 123,
    "error_message": "<string>",
    "result": {
      "image_url": "<string>",
      "video_url": "<string>"
    }
  }
}