seedream-5.0-pro

使用 doubao-seedream-5-0-pro-260628 调用同步图片生成接口。请切换能力 Tab 查看对应的请求和响应结构。

该模型不支持组图生成、联网搜索和流式输出。请勿传入 sequential_image_generation、sequential_image_generation_options、tools 或 stream。

文生图
图片编辑
透明背景
图层拆分

创建图片

POST /v1/images/generations

cURL

curl --request POST \
  --url https://www.anyfast.com.cn/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "一只白色陶瓷杯放在浅灰色背景上，居中构图，柔和阴影，产品摄影，无文字",
    "size": "1.5K",
    "response_format": "url",
    "output_format": "jpeg",
    "watermark": false,
    "optimize_prompt_options": { "mode": "fast" }
  }'

string

required

固定为 doubao-seedream-5-0-pro-260628。

string

required

图片生成提示词。中文建议不超过 300 字，英文建议不超过 600 词。

string

default:"2K"

1K、1.5K、2K 或合法的 宽x高。自定义尺寸总像素数须在 921,600–4,624,220，宽高比须在 [1/16, 16]。

string

default:"url"

url 或 b64_json。URL 有效期为 24 小时。

string

default:"jpeg"

jpeg 或 png。

boolean

default:true

是否添加“AI 生成”水印。

object

提示词优化配置。

string

default:"standard"

standard 或 fast，两种模式均支持。

创建响应

200

{
  "model": "doubao-seedream-5-0-pro-260628",
  "created": 1787562068,
  "data": [{
    "url": "https://example.com/generated-image.jpeg",
    "size": "1536x1536",
    "output_format": "jpeg"
  }],
  "usage": {
    "input_images": 0,
    "generated_images": 1,
    "output_tokens": 9216,
    "total_tokens": 9216
  }
}

编辑或融合图片

POST /v1/images/generations

cURL

curl --request POST \
  --url https://www.anyfast.com.cn/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "使用图 1 的构图，并采用图 2 的视觉风格。",
    "image": [
      "https://example.com/composition.png",
      "https://example.com/style.png"
    ],
    "size": "1K",
    "response_format": "url",
    "output_format": "jpeg",
    "watermark": false
  }'

string

required

固定为 doubao-seedream-5-0-pro-260628。

string

required

编辑或参考生成指令。坐标编辑可使用归一化 <point> 和 <bbox> 标签。

string | string[]

required

图片 URL、Base64 Data URI，或最多 10 张参考图组成的数组。

string

default:"2K"

1K、1.5K、2K 或合法的自定义像素尺寸。

string

default:"url"

url 或 b64_json。

string

default:"jpeg"

jpeg 或 png。

boolean

default:true

是否添加“AI 生成”水印。

string

default:"standard"

standard 或 fast。

创建响应

200

{
  "model": "doubao-seedream-5-0-pro-260628",
  "created": 1787562132,
  "data": [{
    "url": "https://example.com/fused-image.jpeg",
    "size": "1024x1024",
    "output_format": "jpeg"
  }],
  "usage": {
    "input_images": 2,
    "generated_images": 1,
    "output_tokens": 4096,
    "total_tokens": 4096
  }
}

普通参考图支持 jpeg、png、webp、bmp、tiff、gif、heic 和 heif。单张图片小于 30 MB，宽高比在 [1/16, 16]，宽和高均大于 14 px，总像素数不超过 36,000,000。

保留透明通道

POST /v1/images/generations

cURL

curl --request POST \
  --url https://www.anyfast.com.cn/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "保留主体并优化边缘，同时保持透明背景。",
    "image": "https://example.com/transparent-source.png",
    "background": "transparent",
    "size": "1K",
    "response_format": "url",
    "output_format": "png",
    "watermark": false
  }'

string

required

固定为 doubao-seedream-5-0-pro-260628。

string

required

图片编辑指令。

string

required

仅允许 1 张带 Alpha 通道的输入图。PNG 支持透明通道，JPEG 不支持。

string

default:"opaque"

transparent 表示保留透明背景，opaque 表示生成普通不透明背景。

string

default:"2K"

1K、1.5K、2K 或合法的自定义像素尺寸。

string

required

background 为 transparent 时必须使用 png。

string

default:"url"

url 或 b64_json。

boolean

default:true

是否添加“AI 生成”水印。

创建响应

200

{
  "model": "doubao-seedream-5-0-pro-260628",
  "created": 1787562204,
  "data": [{
    "url": "https://example.com/transparent-result.png",
    "size": "1024x1024",
    "output_format": "png"
  }],
  "usage": {
    "input_images": 1,
    "generated_images": 1,
    "output_tokens": 4096,
    "total_tokens": 4096
  }
}

拆分图片图层

POST /v1/images/generations

cURL

curl --request POST \
  --url https://www.anyfast.com.cn/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "仅将鹦鹉主体与背景分离为一个可编辑图层。",
    "image": "https://example.com/parrot-poster.png",
    "layer_decomposition": true,
    "size": "2K",
    "response_format": "url",
    "output_format": "jpeg",
    "watermark": false
  }'

string

required

固定为 doubao-seedream-5-0-pro-260628。

string

可选的拆层指令，可使用归一化 <bbox> 坐标指定元素。

string

required

仅允许 1 张 PNG 或 JPEG。

boolean

required

设为 true，返回 1 张底图和最多 16 个可编辑图层。

string

default:"auto"

auto、1K、1.5K 或 2K；该模式不支持自定义像素尺寸。

string

default:"url"

url 或 b64_json。

string

default:"jpeg"

仅控制底图格式；拆出的图层始终为 PNG。

boolean

default:true

是否添加“AI 生成”水印。

创建响应

200

{
  "model": "doubao-seedream-5-0-pro-260628",
  "created": 1787562257,
  "data": [
    {
      "url": "https://example.com/background.jpeg",
      "size": "2048x2048",
      "output_format": "jpeg",
      "z_index": 0
    },
    {
      "url": "https://example.com/parrot-layer.png",
      "size": "892x2179",
      "output_format": "png",
      "z_index": 1,
      "bounding_box": {
        "absolute": [730, 627, 1301, 2021],
        "normalized": [356, 306, 635, 986]
      },
      "name": "鹦鹉主体",
      "description": "从原图中拆出的透明背景鹦鹉主体"
    }
  ],
  "usage": {
    "input_images": 1,
    "generated_images": 2,
    "output_tokens": 33768,
    "total_tokens": 33768
  }
}

拆层输入图总像素数须在 512 × 512 到 6000 × 6000 之间，宽高比须在 [1/16, 16]，文件小于 30 MB。任一目标图层失败时，整个请求失败。

请求头

string

required

Bearer 鉴权，格式为 Bearer <token>。

string

default:"application/json"

required

请求体格式。

响应字段

string

实际使用的模型。响应可能返回上游规范化后的模型名称。

integer

Unix 秒级创建时间戳。

object[]

生成图片；拆层模式下为底图和拆出的图层。

string

response_format 为 url 时返回的临时图片链接。

string

response_format 为 b64_json 时返回的 Base64 图片数据。

string

输出图片格式。

string

输出图片尺寸。

integer

拆层模式下的图层顺序，底图为 0。

string

拆层模式下模型生成的图层名称。

string

拆层模式下模型生成的图层描述。

integer[]

图层在输出底图中的 [left, top, right, bottom] 像素坐标。

integer[]

图层边界映射到 1000 × 1000 坐标系后的坐标。

integer

生成结果数；拆层模式下包含底图和所有图层。

integer

输入图片数。

integer

输出 Token 数。

integer

总 Token 数。

object

请求级错误信息。

string

请求级错误码。

string

请求级错误说明。

错误响应

请求参数非法，或当前模型不支持传入的参数。

{
  "error": {
    "message": "The parameter is not supported by the current model.",
    "type": "BadRequest",
    "param": "sequential_image_generation",
    "code": "InvalidParameter"
  }
}

API Key 缺失或无效。

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

请求超过当前限流。

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded"
  }
}

概览

模型 API

seedream-5.0-pro

创建图片

创建响应

编辑或融合图片

创建响应

保留透明通道

创建响应

拆分图片图层

创建响应

请求头

响应字段

错误响应

​创建图片

​创建响应

​编辑或融合图片

​创建响应

​保留透明通道

​创建响应

​拆分图片图层

​创建响应

​请求头

​响应字段

​错误响应

创建图片

创建响应

编辑或融合图片

创建响应

保留透明通道

创建响应

拆分图片图层

创建响应

请求头

响应字段

错误响应