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

# Seedream 5.5

> Seedream 5.5 API 根据提示词生成图片，或基于最多 10 张参考图编辑图片，支持 1K、1.5K、2K 输出、8 种宽高比和透明背景 PNG。

> [!TIP]
>
> 1. 提交后会返回 `task_id`。如果提供了 `callback_url`，当任务状态变为 `finished` 或 `failed` 时，系统会向 `callback_url` 发送 POST 请求。
> 2. 无论是否提供 `callback_url`，都可以通过统一的[查询任务状态](https://docs.poyo.ai/zh/api-manual/task-management/status.md)接口获取结果。

使用 `seedream-5.5` 根据提示词制作产品图、海报、贴纸等各类图片，也可以用同一个 model ID 编辑和组合最多 10 张参考图。Seedream 5.5 是字节跳动 Seed 团队的图像创作模型，于 2026 年 11 月 9 日发布，多轮编辑时未改动的区域保持稳定，并可直接输出透明 PNG。

如需把一张图片拆成底图和透明图层，请使用 [Seedream 5.5 图层拆分](https://docs.poyo.ai/zh/api-manual/image-series/seedream-5-5-layerize.md)。

## 模型

* **seedream-5.5** — 省略 `image_urls` 时为文生图；传入 1 到 10 张参考图的 `image_urls` 时为图片编辑

## 功能

* 根据 5 到 5,000 个字符的提示词生成图片。
* 支持图片编辑和多参考图合成，最多 10 张参考图。
* 多轮编辑稳定：把上一轮结果作为下一轮的参考图，提示词里没提到的区域保持不变。
* 原生透明输出：`background` 设为 `transparent` 即返回带全透明或半透明背景的 RGBA PNG，文生图和图片编辑都可用。
* 提供 8 种宽高比，可选 `1K`、`1.5K` 或 `2K`（`21:9` 最高 3136×1344）。
* 输出 PNG 或 JPEG。

## 输入模式

* **文生图** — 省略 `image_urls`。`size` 默认为 `1:1`。
* **图片编辑** — 在 `image_urls` 中传入 1 到 10 个 URL。提示词里按顺序称呼参考图（图 1、图 2 等）。`size` 默认为 `auto`，按参考图输出。

## 必填参数

* `prompt`（string）：描述画面或编辑要求，5–5,000 个字符。编辑时写清改什么、保留什么。

## 可选参数

* `image_urls`（字符串数组）：1 到 10 个可公开访问的 HTTP(S) 参考图 URL（JPEG、PNG 或 WEBP，单张不超过 10 MB）。传入即为图片编辑模式。
* `size`（string）：`1:1`、`4:3`、`3:4`、`16:9`、`9:16`、`3:2`、`2:3`、`21:9` 或 `auto`。文生图默认 `1:1`，图片编辑默认 `auto`。`auto` 用于图片编辑。详见[尺寸](#尺寸)。
* `resolution`（string）：`1K`、`1.5K` 或 `2K`，默认 `2K`。决定所选 `size` 的像素档位。
* `background`（string）：`auto`、`transparent` 或 `opaque`，默认 `auto`，由提示词和输出格式决定背景。`transparent` 返回带 Alpha 通道的 RGBA 图片，需配合 `output_format` 为 `png`；`opaque` 返回 RGB 图片。
* `output_format`（string）：`png` 或 `jpeg`，默认 `png`。
* `enable_safety_checker`（boolean）：内容安全检查，默认 `true`。

## 尺寸

每种宽高比在所选 `resolution` 下对应固定像素尺寸：

| `size` | `1K` | `1.5K` | `2K` |
| - | - | - | - |
| `1:1` | 1024×1024 | 1536×1536 | 2048×2048 |
| `4:3` | 1152×864 | 1792×1344 | 2368×1776 |
| `3:4` | 864×1152 | 1344×1792 | 1776×2368 |
| `16:9` | 1424×800 | 2048×1152 | 2816×1584 |
| `9:16` | 800×1424 | 1152×2048 | 1584×2816 |
| `3:2` | 1248×832 | 1872×1248 | 2496×1664 |
| `2:3` | 832×1248 | 1248×1872 | 1664×2496 |
| `21:9` | 1568×672 | 2352×1008 | 3136×1344 |

* `auto`（图片编辑）：按参考图输出，像素面积约为所选 `resolution` 档位。

## 示例

### 文生图

一张 2K 16:9 的产品图（2816×1584）：

```json theme={"dark"}
{
  "model": "seedream-5.5",
  "input": {
    "prompt": "A ceramic pour-over coffee set on a walnut counter, soft morning window light, steam rising from the cup, minimalist product photography",
    "size": "16:9",
    "resolution": "2K"
  }
}
```

### 多参考图编辑

组合两张参考图，按 `image_urls` 中的顺序称呼每张图：

```json theme={"dark"}
{
  "model": "seedream-5.5",
  "input": {
    "prompt": "Put the handbag from image 2 on the wooden table in image 1. Keep the lighting, background, and camera angle of image 1 unchanged.",
    "image_urls": [
      "https://example.com/living-room.png",
      "https://example.com/handbag.png"
    ],
    "resolution": "2K"
  }
}
```

### 透明背景 PNG

透明背景的贴纸：

```json theme={"dark"}
{
  "model": "seedream-5.5",
  "input": {
    "prompt": "A red paper lantern with golden tassels, flat illustration sticker, isolated subject on a transparent background",
    "size": "1:1",
    "resolution": "1K",
    "background": "transparent",
    "output_format": "png"
  }
}
```

## 注意事项

* 每次请求生成一张图片。
* `image_urls` 使用数组格式，传一张图时也一样。
* 多轮编辑时，把上一轮结果作为下一轮参考图，最后一步再设 `background` 为 `transparent`，中间各轮用 `opaque` 或 `auto`。
* 一次请求通常在 20 到 35 秒内完成。


## OpenAPI

````yaml zh/api-manual/image-series/seedream-5-5.json POST /api/generate/submit
openapi: 3.0.0
info:
  title: PoYo AI - Seedream 5.5 API
  description: >-
    Seedream 5.5 API 根据提示词生成图片，或基于最多 10 张参考图编辑图片，支持 1K、1.5K、2K 输出、8 种宽高比和透明背景
    PNG。
  version: 1.0.0
servers:
  - url: https://api.poyo.ai
    description: 生产环境
security:
  - BearerAuth: []
paths:
  /api/generate/submit:
    post:
      tags:
        - Seedream 5.5
      summary: 提交 Seedream 5.5 任务
      description: Seedream 5.5 文生图，以及最多 10 张参考图的图片编辑。
      operationId: submitSeedream55Task
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitRequest'
            examples:
              text-to-image:
                summary: 文生图
                value:
                  model: seedream-5.5
                  input:
                    prompt: >-
                      A ceramic pour-over coffee set on a walnut counter, soft
                      morning window light, steam rising from the cup,
                      minimalist product photography
                    size: '16:9'
                    resolution: 2K
              multi-reference-edit:
                summary: 多参考图编辑
                value:
                  model: seedream-5.5
                  input:
                    prompt: >-
                      Put the handbag from image 2 on the wooden table in image
                      1. Keep the lighting, background, and camera angle of
                      image 1 unchanged.
                    image_urls:
                      - https://example.com/living-room.png
                      - https://example.com/handbag.png
                    resolution: 2K
              transparent-png:
                summary: 透明背景 PNG
                value:
                  model: seedream-5.5
                  input:
                    prompt: >-
                      A red paper lantern with golden tassels, flat illustration
                      sticker, isolated subject on a transparent background
                    size: '1:1'
                    resolution: 1K
                    background: transparent
                    output_format: png
      responses:
        '200':
          description: 任务提交成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmitResponse'
        '400':
          description: 请求参数无效
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: 未授权：API Key 无效
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    SubmitRequest:
      type: object
      required:
        - model
        - input
      additionalProperties: false
      properties:
        model:
          type: string
          enum:
            - seedream-5.5
          description: Seedream 5.5 模型标识。省略 image_urls 为文生图；传 1–10 张 image_urls 为图片编辑。
        callback_url:
          type: string
          format: uri
          description: 可选的 Webhook URL，用于任务完成或失败时的通知。
        input:
          type: object
          additionalProperties: false
          required:
            - prompt
          description: 生成一张图片。传入 image_urls 时编辑或组合参考图。
          properties:
            prompt:
              type: string
              minLength: 5
              maxLength: 5000
              description: 描述画面或编辑要求，5–5000 个字符。编辑时写清改什么、保留什么，并按顺序称呼参考图（图 1、图 2 等）。
            image_urls:
              type: array
              minItems: 1
              maxItems: 10
              items:
                type: string
                format: uri
              description: >-
                可选，1–10 张参考图 URL。传入即为图片编辑模式。传一张图时也使用数组格式。每个 URL 必须是可公开访问的
                HTTP/HTTPS 地址，图片为 JPEG、PNG 或 WEBP，单张不超过 10 MB。
              example:
                - https://example.com/living-room.png
                - https://example.com/handbag.png
            size:
              type: string
              enum:
                - '1:1'
                - '4:3'
                - '3:4'
                - '16:9'
                - '9:16'
                - '3:2'
                - '2:3'
                - '21:9'
                - auto
              description: >-
                宽高比或 auto。宽高比：1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9，像素尺寸由
                resolution 决定。auto 用于图片编辑，按参考图比例、以所选档位的像素面积输出。文生图默认 1:1，图片编辑默认
                auto。
              example: '16:9'
            resolution:
              type: string
              enum:
                - 1K
                - 1.5K
                - 2K
              default: 2K
              description: >-
                所选 size 的像素档位。1K: 1:1 1024x1024, 4:3 1152x864, 3:4 864x1152,
                16:9 1424x800, 9:16 800x1424, 3:2 1248x832, 2:3 832x1248, 21:9
                1568x672. 1.5K: 1:1 1536x1536, 4:3 1792x1344, 3:4 1344x1792,
                16:9 2048x1152, 9:16 1152x2048, 3:2 1872x1248, 2:3 1248x1872,
                21:9 2352x1008. 2K: 1:1 2048x2048, 4:3 2368x1776, 3:4 1776x2368,
                16:9 2816x1584, 9:16 1584x2816, 3:2 2496x1664, 2:3 1664x2496,
                21:9 3136x1344.
            background:
              type: string
              enum:
                - auto
                - transparent
                - opaque
              default: auto
              description: >-
                输出图片的背景。auto 由提示词和输出格式决定；transparent 返回带 Alpha 通道的 RGBA
                图片（支持全透明和半透明），需配合 output_format png；opaque 返回 RGB 图片。
            output_format:
              type: string
              enum:
                - png
                - jpeg
              default: png
              description: 输出图片格式。
            enable_safety_checker:
              type: boolean
              default: true
              description: 内容安全检查。
    SubmitResponse:
      type: object
      required:
        - code
        - data
      properties:
        code:
          type: integer
          example: 200
          description: >-
            业务状态码。`200` 表示成功，其他值都表示请求失败。请务必检查这个字段：部分参数校验错误会以 HTTP 200 返回，响应体里的
            `code` 为 `400`。


            - `200`：成功

            - `400`：请求参数无效

            - `401`：API Key 缺失或无效

            - `402`：积分不足

            - `403`：没有权限

            - `404`：资源不存在

            - `408`：请求超时

            - `429`：请求频率超限

            - `500`：服务器内部错误

            - `502`：上游服务错误

            - `503`：服务暂不可用


            详见[错误码](/zh/api-manual/error-codes)。
          enum:
            - 200
            - 400
            - 401
            - 402
            - 403
            - 404
            - 408
            - 429
            - 500
            - 502
            - 503
        data:
          type: object
          required:
            - task_id
            - status
            - created_time
          properties:
            task_id:
              type: string
              example: task-unified-1794470400-abcd1234
              description: 任务唯一标识，用于查询任务状态
            status:
              type: string
              enum:
                - not_started
                - running
                - finished
                - failed
              example: not_started
              description: >-
                任务状态。提交后立即返回时始终为
                `not_started`。后续状态请通过[查询任务状态](/zh/api-manual/task-management/status)接口或
                `callback_url` 获取。


                - `not_started`：排队中，等待处理

                - `running`：生成中

                - `finished`：已完成，结果在 `files` 或 `output` 中

                - `failed`：失败，详情见 `error_message`
            created_time:
              type: string
              format: date-time
              example: '2026-11-12T10:30:00'
              description: 任务创建时间，ISO 8601 格式
    ErrorResponse:
      type: object
      required:
        - code
        - error
      properties:
        code:
          type: integer
          example: 400
          enum:
            - 200
            - 400
            - 401
            - 402
            - 403
            - 404
            - 408
            - 429
            - 500
            - 502
            - 503
          description: >-
            业务状态码。`200` 表示成功，其他值都表示请求失败。请务必检查这个字段：部分参数校验错误会以 HTTP 200 返回，响应体里的
            `code` 为 `400`。


            - `200`：成功

            - `400`：请求参数无效

            - `401`：API Key 缺失或无效

            - `402`：积分不足

            - `403`：没有权限

            - `404`：资源不存在

            - `408`：请求超时

            - `429`：请求频率超限

            - `500`：服务器内部错误

            - `502`：上游服务错误

            - `503`：服务暂不可用


            详见[错误码](/zh/api-manual/error-codes)。
        error:
          type: object
          required:
            - message
            - type
          properties:
            message:
              type: string
              example: Invalid request parameters
            type:
              type: string
              example: invalid_request_error
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        所有 API 接口都需要 Bearer Token 认证。


        创建 API Key：登录 PoYo，进入 **仪表盘 → API
        密钥**（[poyo.ai/zh/dashboard/api-key](https://poyo.ai/zh/dashboard/api-key)），点击创建
        Key。


        在请求头中添加：


        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````

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