> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sigrunai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Seedream 5.5 task

> 创建 GPT Image 2、GPT Image 2.6、Nano Banana、Seedream 5.5 或 Muse Image 生图任务。

Create an async Seedream 5.5 image task. Poll with [Query image task](https://docs.sigrunai.com/en/api-reference/images/query.md) and read `result.image_url` when completed.

For GPT Image 2, see [Create GPT Image 2 task](https://docs.sigrunai.com/en/api-reference/images/create.md). For GPT Image 2.6, see [Create GPT Image 2.6 task](https://docs.sigrunai.com/en/api-reference/images/gpt-image-2.6.md). For Nano Banana, see [Create Nano Banana task](https://docs.sigrunai.com/en/api-reference/images/nano-banana.md). For Muse Image, see [Create Muse Image task](https://docs.sigrunai.com/en/api-reference/images/muse-image.md).

## Models

| `model` | Notes | `resolution` | Billing keys |
| - | - | - | - |
| `seedream-5.5` | Text-to-image / reference images; 1 image per request | `1K` / `2K` (also `1k` / `2k`) | `seedream-5.5-1k` / `seedream-5.5-2k` |

Billing is by resolution (`per_task`, 1 image per request). Check [Model catalog](https://docs.sigrunai.com/en/api-reference/common/model-catalog.md) and the create response `cost` for live prices. You may also pass a billing key as `model`.

## Request body

| Field | Type | Required | Description |
| - | - | - | - |
| `model` | string | yes | `seedream-5.5`, or `seedream-5.5-1k` / `seedream-5.5-2k` |
| `prompt` | string | conditional | Required for text-to-image; optional when `images` is set. Up to **4000** characters |
| `n` | int | no | Always **1** |
| `ratio` | string | no | Aspect ratio; `size` is an alias. Options: `1:1` / `16:9` / `9:16` / `4:3` / `3:4` / `3:2` / `2:3` / `21:9` / `5:4` / `4:5` |
| `size` | string | no | Alias of `ratio` |
| `resolution` | string | no | Resolution tier, default `1K` |
| `images` | string\[] | no | Public reference image URLs, max **8** |
| `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](https://docs.sigrunai.com/en/api-reference/common/smart-queue.md) |

## Examples

### Text-to-image (1K)

```bash theme={null}
curl -X POST 'https://sigrunai.com/v1/images' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedream-5.5",
    "prompt": "A blue cup on a wooden table, soft natural light",
    "ratio": "1:1",
    "resolution": "1K"
  }'
```

### Reference image (2K)

```bash theme={null}
curl -X POST 'https://sigrunai.com/v1/images' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedream-5.5",
    "prompt": "Keep the product look, soft studio lighting background",
    "ratio": "16:9",
    "resolution": "2K",
    "images": ["https://example.com/reference.jpg"]
  }'
```

Success response example:

```json theme={null}
{
  "code": 20000,
  "msg": "提交成功",
  "data": {
    "task_id": "img_xxxxxxxx",
    "status": "queued",
    "progress": 0,
    "model": "seedream-5.5-1k",
    "cost": 0.05,
    "result": {}
  }
}
```


## OpenAPI

````yaml POST /v1/images
openapi: 3.1.0
info:
  title: AI Platform OpenAPI
  description: 异步图片与视频生成。创建后轮询 task_id；结果 URL 约保留 3 天。
  version: 1.0.0
servers:
  - url: https://sigrunai.com
    description: AI Platform 生产环境
security:
  - bearerAuth: []
paths:
  /v1/images:
    post:
      tags:
        - Images
      summary: Create image task
      description: >-
        Create an async GPT Image 2, GPT Image 2.6, Nano Banana, Seedream 5.5,
        or Muse Image task.
      operationId: createImage
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageCreateRequest'
            examples:
              gptImage2:
                summary: gpt-image-2
                value:
                  model: gpt-image-2
                  prompt: Minimal product still life, white background, soft light
                  quality: medium
                  'n': 1
                  ratio: '1:1'
              gptImage26:
                summary: gpt-image-2.6-flare
                value:
                  model: gpt-image-2.6-flare
                  prompt: Minimal product still life, white background, soft light
                  quality: medium
                  'n': 1
                  ratio: '1:1'
                  resolution: 1k
                  output_format: png
              nanoBanana2:
                summary: nano-banana-2
                value:
                  model: nano-banana-2
                  prompt: >-
                    Cinematic sunset over a lake, golden light on distant
                    mountains
                  ratio: '16:9'
                  resolution: 2k
              nanoBananaPro:
                summary: nano-banana-pro
                value:
                  model: nano-banana-pro
                  prompt: Keep the product look, switch to soft studio lighting
                  ratio: '1:1'
                  resolution: 4k
                  images:
                    - https://example.com/product.jpg
              seedream55:
                summary: seedream-5.5
                value:
                  model: seedream-5.5
                  prompt: A blue cup on a wooden table, soft natural light
                  ratio: '1:1'
                  resolution: 1K
              museImage:
                summary: muse-image
                value:
                  model: muse-image
                  prompt: A misty forest at dawn, photorealistic
                  ratio: '16:9'
                  style: photorealistic
                  negative_prompt: watermark, text
      responses:
        '200':
          description: 提交成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskQueryResponse'
components:
  schemas:
    ImageCreateRequest:
      type: object
      required:
        - model
      properties:
        model:
          type: string
          description: >-
            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:
          type: string
          minLength: 1
          maxLength: 32000
          description: >-
            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
        quality:
          type: string
          enum:
            - auto
            - low
            - medium
            - high
            - xhigh
            - max
          default: auto
          description: >-
            GPT Image 2: auto / low / medium / high, billed by tier. GPT Image
            2.6 also accepts xhigh / max without changing the price
        'n':
          type: integer
          minimum: 1
          maximum: 4
          default: 1
          description: >-
            GPT Image 2 accepts 1–4. GPT Image 2.6, Nano Banana, Seedream 5.5,
            and Muse Image accept 1 only
        ratio:
          type: string
        size:
          type: string
          description: >-
            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:
          type: string
          description: >-
            GPT Image 2.6 accepts 1k only. Nano Banana: 0.5k/1k/2k/4k depending
            on the model
        images:
          type: array
          items:
            type: string
            format: uri
          maxItems: 16
          description: >-
            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
        output_format:
          type: string
          enum:
            - png
            - jpeg
            - webp
            - svg
            - gif
          description: >-
            GPT Image 2.6 only. jpg is treated as jpeg. For gif, omit size or
            send auto
        style:
          type: string
          maxLength: 1000
          description: >-
            Muse Image only. Free-text style such as photorealistic, anime, or
            cinematic
        negative_prompt:
          type: string
          maxLength: 1000
          description: Muse Image only. What should not appear, kept apart from prompt
        smart_queue:
          type: boolean
          default: false
          description: >-
            When true, a very low recent success rate keeps the task queued
            until recovery (up to about 2 hours)
    TaskQueryResponse:
      type: object
      properties:
        code:
          type: integer
          example: 20000
        msg:
          type: string
        data:
          $ref: '#/components/schemas/TaskQueryData'
    TaskQueryData:
      type: object
      properties:
        task_id:
          type: string
        status:
          type: string
          description: queued / processing / completed / failed 等
        progress:
          type: integer
        model:
          type: string
        created_at:
          type: integer
        completed_at:
          type: integer
        cost:
          type: number
        error_message:
          type: string
        result:
          $ref: '#/components/schemas/TaskResult'
    TaskResult:
      type: object
      properties:
        image_url:
          type: string
        video_url:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: 控制台创建的 API Key，格式：Bearer sk_xxx

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.