Create Muse Image task

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>"
    }
  }
}

Create a Muse Image task. Poll with Query image task and read result.image_url when completed. Generation is usually fast, so the create response may already be completed. For GPT Image 2, see Create GPT Image 2 task. For Seedream 5.5, see Create Seedream 5.5 task.

Models

`model`	Notes	Billing
`muse-image`	Text-to-image / reference images; 1 image per request; native size	`muse-image` (per task)

Billed once per request, one image. The live price is the model catalog value and the cost on the create response. Underscore form muse_image is accepted. Omit the ratio to let the model choose the size. 1:1 is about 1600×1600 and 16:9 about 2048×1152. Images are not upscaled.

Request fields

Field	Type	Required	Notes
`model`	string	yes	`muse-image`
`prompt`	string	yes	What to draw. With reference images, say what to keep and what to change. Max 4000 characters
`n`	int	no	Fixed at 1
`ratio`	string	no	`1:1` / `16:9` / `9:16` / `4:3` / `3:4` / `3:2` / `2:3`
`size`	string	no	Alias of `ratio`. A pixel size such as `1024x1024` or `2048x1152` is reduced to its ratio
`images`	string[]	no	Public reference image URLs, up to 10
`style`	string	no	Free-text style, for example `photorealistic`, `anime`, `cinematic`. Max 1000 characters
`negative_prompt`	string	no	What should not appear, for example `watermark, text`. Max 1000 characters
`smart_queue`	bool	no	Default `false`. When `true`, a very low recent success rate keeps the task `queued` until recovery (up to about 2 hours). See Smart queue

If both ratio and size are set, they must describe the same ratio.

Examples

Text to image

curl -X POST 'https://sigrunai.com/v1/images' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "muse-image",
    "prompt": "A misty forest at dawn, photorealistic",
    "ratio": "16:9",
    "style": "photorealistic",
    "negative_prompt": "watermark, text"
  }'

Reference image

curl -X POST 'https://sigrunai.com/v1/images' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "muse-image",
    "prompt": "Replace the background with a seaside sunset and keep the person",
    "images": ["https://example.com/photo.png"]
  }'

Example success response:

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

Authorizations

Authorization

string

header

required

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

Body

application/json

model

string

required

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

Example:

"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>

default:auto

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

Available options:

auto,

low,

medium,

high,

xhigh,

max

integer

default:1

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

Required range: 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

Available options:

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

default:false

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

Response

200 - application/json

提交成功

code

integer

Example:

20000

msg

string

data

object

Show child attributes

Last modified on November 14, 2026

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>"
    }
  }
}