Seedream 5.5 - PoYo AI

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1794470400-abcd1234",
    "status": "not_started",
    "created_time": "2026-11-12T10:30:00"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

POST

api

generate

submit

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1794470400-abcd1234",
    "status": "not_started",
    "created_time": "2026-11-12T10:30:00"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

提交后会返回 task_id。如果提供了 callback_url，当任务状态变为 finished 或 failed 时，系统会向 callback_url 发送 POST 请求。
无论是否提供 callback_url，都可以通过统一的查询任务状态接口获取结果。

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

模型

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）：

{
  "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 中的顺序称呼每张图：

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

透明背景的贴纸：

{
  "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 秒内完成。

授权

Authorization

string

header

必填

所有 API 接口都需要 Bearer Token 认证。

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

在请求头中添加：

Authorization: Bearer YOUR_API_KEY

请求体

application/json

model

enum<string>

必填

Seedream 5.5 模型标识。省略 image_urls 为文生图；传 1–10 张 image_urls 为图片编辑。

可用选项:

seedream-5.5

input

object

必填

生成一张图片。传入 image_urls 时编辑或组合参考图。

Show child attributes

callback_url

string<uri>

可选的 Webhook URL，用于任务完成或失败时的通知。

响应

任务提交成功

code

enum<integer>

必填

业务状态码。200 表示成功，其他值都表示请求失败。请务必检查这个字段：部分参数校验错误会以 HTTP 200 返回，响应体里的 code 为 400。

200：成功
400：请求参数无效
401：API Key 缺失或无效
402：积分不足
403：没有权限
404：资源不存在
408：请求超时
429：请求频率超限
500：服务器内部错误
502：上游服务错误
503：服务暂不可用

详见错误码。

可用选项:

200,

400,

401,

402,

403,

404,

408,

429,

500,

502,

503

示例:

200

data

object

必填

Show child attributes

​模型

​功能

​输入模式

​必填参数

​可选参数

​尺寸

​示例

​文生图

​多参考图编辑

​透明背景 PNG

​注意事项

授权

请求体

响应

模型

功能