Seedream v5.0 Pro Edit

Model ID bytedance/seedream-v5.0-pro/edit

概览

支持 1 至 10 张参考图片及可选透明 PNG 输出的图像编辑模型。

ByteDance · image-to-image

接口

POST /v1/images/generations/async

认证

Authorization: Bearer <AIAPIAIAPI_API_KEY>

请求体

model

类型：string · 必填：是 · 可空：否

用于路由请求的模型 ID。

prompt

类型：string · 必填：是 · 可空：否

正向提示词，建议少于 600 个英文单词。

images

类型：array · 必填：是 · 可空：否

1 至 10 张参考图片，支持 JPEG、PNG、WEBP、BMP、TIFF、GIF、HEIC、HEIF；供应商对第一张参考图免费，其余另行收费。

size

类型：string · 必填：否 · 可空：否

从支持的预设中选择输出尺寸；供应商对不超过 261 万像素的输出按 1.5K 档收费，更大的尺寸按 2K 档收费。

thinking

类型：string · 必填：否 · 可空：否

启用或禁用提示词优化阶段的深度思考。

prompt_optimization_mode

类型：string · 必填：否 · 可空：否

提示词优化模式，fast 可降低延迟；两种模式的供应商价格相同。

output_format

类型：string · 必填：否 · 可空：否

输出文件格式。

background

类型：string · 必填：否 · 可空：否

透明输出要求 output_format=png，并且恰好提供一张带 alpha 通道的 PNG 来源图片；输入图片格式和 alpha 通道由供应商校验。

请求示例

curl --request POST \
  --url https://aiapiaiapi.com/v1/images/generations/async \
  --header 'Authorization: Bearer $AIAPIAIAPI_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
      "model": "bytedance/seedream-v5.0-pro/edit",
      "prompt": "A cinematic camera movement through a forest",
      "images": ["https://example.com/reference.jpg"]
    }'

JSON

{
  "model": "bytedance/seedream-v5.0-pro/edit",
  "prompt": "A cinematic camera movement through a forest",
  "images": ["https://example.com/reference.jpg"]
}

响应

{
  "code": "success",
  "message": "",
  "data": { "task_id": "image_01K2ABC123" }
}

任务状态

使用创建响应中的 task_id 查询：

GET /v1/images/generations/async/{task_id}

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "image_01K2ABC123",
    "status": "SUCCESS",
    "progress": "100%",
    "outputs": ["https://cdn.example.com/images/image_01K2ABC123.png"],
    "start_time": 1786960805,
    "finish_time": 1786960900,
    "submit_time": 1786960800,
    "fail_reason": ""
  }
}

错误响应

参数校验错误返回 HTTP 400，并包含稳定的错误代码。

{
  "code": "unsupported_parameter",
  "message": "The parameter is not supported by this model.",
  "data": null
}