doubao-seedream-5-0-260128

最后更新：2026-11-14

POSThttps://www.sagelib.com/images/edits

doubao-seedream-5-0-260128 模型的图像编辑接口，OpenAI兼容，支持图像编辑、蒙版编辑等。

接口鉴权方式请参考：API接入与鉴权

请求参数

请求头

参数名称 描述
*Authorization string 鉴权令牌，格式为 Bearer ${AIGATEWAY_TOKEN}
*Content-Type string 默认值：application/json
可选值：application/json
application/json（JSON 端点）或 multipart/form-data; boundary=...（multipart 端点，保持原始 boundary）

Body 参数

参数名称 描述
*model string 可选值："doubao-seedream-5-0-260128"
模型 ID，固定值
*prompt string 可选值：Text description
生成图像的文本描述/编辑指令
*image string 可选值：URL or base64, or an array of them
参考图，用于图生图/编辑。edits 端点必填
response_format string 默认值：url
可选值：url、b64_json
返回格式，默认返回 url
size string 默认值：2048x2048
可选值：2K、3K
输出尺寸。1K 不支持，WxH 总像素须 ≥ 3,686,400
watermark boolean 默认值：false
可选值：true、false
是否添加水印
optimize_prompt boolean 默认值：false
可选值：true、false
是否启用 prompt 优化
optimize_prompt_options object 可选值：mode
prompt 优化选项
sequential_image_generation string 默认值：auto
可选值：auto、disabled
多图生成控制：auto 由模型决定，disabled 仅生成单图
sequential_image_generation_options object 可选值：Sub-field max_images
多图生成选项，仅在多图功能启用时生效
tools array 可选值：Each item contains a type field
内容生成工具列表
output_format string 默认值：png
可选值：png、jpeg
输出图像格式，不支持 webp
stream boolean 默认值：false
可选值：true、false
是否流式返回

请求示例

curl -X POST 'https://${base_url}/v2/llm/images/edits' \
  -H "Authorization: Bearer ***" \
  -F "image=${image_url}" \
  -F "prompt=Change the background to blue"

curl -X POST 'https://${base_url}/v2/llm/images/edits' \
  -H "Authorization: Bearer ***" \
  -F "image=${image_url}" \
  -F "prompt=Change the background to blue" \
  -F "size=2K" \
  -F "output_format=png"

curl -X POST 'https://${base_url}/v2/llm/images/edits' \
  -H "Authorization: Bearer ***" \
  -F "image=${image_url}" \
  -F "prompt=Change the background to blue" \
  -F "watermark=true" \
  -F "optimize_prompt=true"

响应参数

Body 参数

参数名称 描述
created integer 生成时间戳（Unix 秒）
model string 模型名称
data array 图片结果数组
data[0] object
    url string 生成图片的访问链接
usage object token 用量统计
    input_tokens integer 输入 token 数
    output_tokens integer 输出 token 数
    total_tokens integer 总 token 数
POSThttps://www.sagelib.com/openai/images/edits

doubao-seedream-5-0-260128 模型的图像编辑接口，OpenAI直连模式（URL 前缀 /openai），基于原图+文本指令编辑图像。

接口鉴权方式请参考：API接入与鉴权

请求参数

请求头

参数名称 描述
*Authorization string 鉴权令牌，格式为 Bearer ${AIGATEWAY_TOKEN}
*Content-Type string 可选值：multipart/form-data
multipart/form-data; boundary=${boundary}，boundary由请求工具自动生成

Body 参数

参数名称 描述
*model string 可选值：doubao-seedream-5-0-260128 / openai.doubao-seedream-5-0-260128
指定调用的模型标识
*prompt string 图像编辑的文本提示词，描述期望的编辑效果
*image string 可选值：Image URL or Base64
待编辑的源图
size string 可选值：e.g. 1k / 2k / 4k
输出图片尺寸
seed integer 随机种子，用于复现生成结果
guidance_scale number 提示词引导强度
watermark boolean 可选值：true、false
是否在输出图片上添加显式水印
response_format string 可选值：url / b64_json
响应中返回图片的形式（URL 或 Base64）
optimize_prompt boolean 可选值：true、false
是否开启提示词自动优化
optimize_prompt_options object 提示词优化的细项选项
sequential_image_generation boolean 可选值：true、false
是否启用组图（连续多图）生成
output_format string 可选值：jpeg / png etc.
输出图片格式

请求示例

curl -v 'https://${base_url}/v2/llm/images/edits' \
  -H "Authorization: Bearer ***" \
  -F "model=doubao-seedream-5-0-260128" \
  -F "prompt=Change the Shiba Inu in this image to running through the snow" \
  -F "size=2k" \
  -F "image=${image_url}"

响应参数

Body 参数

参数名称 描述
created integer 请求创建时间戳
model string 实际使用的模型标识
data array 生成结果数组
    url string 生成图片的 URL（签名链接，含有效期）
usage object token 用量信息
    input_tokens integer 输入 token 数
    output_tokens integer 输出 token 数
    total_tokens integer 总 token 数