#Seedream 图像生成

本平台支持 Seedream 5.0 Pro（doubao-seedream-5-0-pro-260628），本文介绍通过文本生成图片和编辑已有图片的调用方式。

本文展示本平台调用示例及返回结果，完整参数可参考 Seedream 图像生成官方文档。

#本平台调用示例

以下示例以 Seedream 5.0 Pro（doubao-seedream-5-0-pro-260628）为例，使用 POST https://api.token-hubs.com/api/v3/images/generations，请求体为 JSON。

#创建图片

通过 prompt 描述期望生成的画面，文生图时不传入 image。

curl --request POST \
  --url 'https://api.token-hubs.com/api/v3/images/generations' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "一束鲜花放在窗边的陶瓷花瓶中，柔和的自然光，写实摄影风格",
    "size": "2K",
    "ratio": "adaptive",
    "output_format": "jpeg",
    "response_format": "url",
    "watermark": false
  }'

#编辑图片

编辑图片使用同一个接口，额外传入 image，并在 prompt 中描述需要修改的内容。将示例图片 URL 替换为可访问的真实地址。

curl --request POST \
  --url 'https://api.token-hubs.com/api/v3/images/generations' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "去掉图片中间偏下部分的花，保留其他内容不变",
    "image": "https://example.com/flowers.jpeg",
    "size": "2K",
    "ratio": "adaptive",
    "output_format": "jpeg",
    "response_format": "url",
    "watermark": false
  }'

#获取生成结果

上述请求直接返回生成结果，无需轮询任务状态。以下为图片编辑请求的成功返回体，图片下载地址已替换为占位地址：

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

data[0].url 即为生成图片的下载地址；返回多张图片时，遍历 data 数组获取每张图片的地址。

图片链接含签名且有有效期，原始响应示例中的 X-Tos-Expires=86400 表示签名有效期为 24 小时。请及时下载转存，实际有效期以返回链接为准。

#注意事项

#请求参数说明

• 请求结构：model、prompt、image 和其他配置参数均直接置于 JSON 请求体顶层。
• model 与 prompt：模型 ID 使用 doubao-seedream-5-0-pro-260628；prompt 描述生成内容或编辑要求，编辑时可明确需要保留和修改的部分。
• image 字段：上方编辑示例使用单个图片 URL 字符串；文生图时省略该字段。参考图地址需可访问，使用签名链接时应确保链接尚未过期。
• 图片尺寸与比例：示例使用 size: "2K" 和 ratio: "adaptive"，采用 2K 分辨率档位并自适应比例。实际输出宽高以 data[].size 为准，示例为 2848x1600。
• 图片格式与返回方式：output_format: "jpeg" 指定图片文件格式，response_format: "url" 指定以下载链接返回结果，从 data[].url 获取图片。
• 水印：watermark: false 表示不添加水印。
• 接口地址与鉴权：创建和编辑图片均使用 https://api.token-hubs.com/api/v3/images/generations，请求头携带 Authorization: Bearer YOUR_API_KEY 和 Content-Type: application/json。请将 YOUR_API_KEY 替换为该接口对应的 API Key。

#返回参数说明

• model：本次请求使用的模型 ID。
• created：响应创建的 Unix 时间戳，单位为秒。
• data：生成的图片列表；每项的 url 为下载地址，size 为实际像素尺寸，output_format 为图片文件格式。
• usage.input_images：输入图片数量，示例中为 1。
• usage.generated_images：生成图片数量，示例中为 1。
• usage.output_tokens 与 usage.total_tokens：本次请求的输出 token 数和总 token 数，以接口实际返回值为准。