Seedream生图API
更新时间 2026-09-06 17:29:25
最近更新时间: 2026-09-06 17:29:25
本文介绍火山方舟图片生成模型的调用API，包括输入输出参数、取值范围、注意事项等信息，供您使用接口时查阅字段含义。
支持的模型
| 模型 | 简要说明 | 特有能力 | 不支持能力 |
|---|---|---|---|
| doubao‑seedream‑4.0 | 通用文生图模型，支持组图、流式输出 | sequential_image_generation 组图、stream 流式、optimize_prompt_options 提示词优化 | guidance_scale、tools、output_format |
| doubao‑seedream‑4.5 | 4.0 迭代版本，画面细节、构图、风格表现力提升 | sequential_image_generation 组图、stream 流式、optimize_prompt_options 提示词优化 | guidance_scale、tools、output_format |
| doubao‑seedream‑5.0‑lite | 轻量高性能图像生成模型，能力最全 | 组图、流式输出、提示词优化、tools 工具调用、output_format 指定 png/jpeg 输出格式 | guidance_scale |
| doubao-seedream-5.0-pro | 高性能图像生成模型，画面质量与语义理解能力全面升级，支持复杂场景与高精度生成 | 支持图层拆分、交互编辑 | 暂不支持组图生成、联网搜索、流式输出。暂不支持组图生成、联网搜索、流式输出。 |
接口详情
http调用
请求方式：POST
请求路径：https://ai.ctaigw.cn/v1/images/generations
请求头
| 参数 | 必填 | 说明 |
|---|---|---|
| Content‑Type | 是 | 固定application/json |
| Authorization | 是 | Bearer ${YOUR_APP_KEY} |
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 使用模型调用名称或模型id |
| prompt | string | 是 | 文本提示词 |
| image | string[] | 否 | 图生图输入图片，支持 http 可访问 URL 或 base64。base64 格式：data:image/png;base64,xxx，图片格式小写 |
| size | string | 否 | 生成图片尺寸，如2K，参考官方尺寸填写说明 |
| sequential_image_generation | string | 否 | 组图控制 auto自动根据 prompt 判断是否输出组图； disabled关闭组图，仅输出单张图 支持模型：4.0/4.5/5.0‑lite |
| sequential_image_generation_options | object | 否 | 组图配置，仅 sequential_image_generation=auto 时生效 支持模型：4.0/4.5/5.0‑lite |
| stream | boolean | 否 | 流式输出开关。false非流式，全部生成完返回；true流式，逐张返回图片结果，单图 / 组图均支持 支持模型：4.0/4.5/5.0‑lite |
| optimize_prompt_options | object | 否 | 提示词优化功能配置 支持模型：4.0/4.5/5.0‑lite |
| tools | object[] | 否 | 配置模型调用的工具，例如联网搜索工具，4.0/4.5 不可传该参数 支持模型：5.0‑lite |
| output_format | string | 否 | 指定生成图像的文件格式。可选值： - png - jpeg 支持模型：5.0‑lite |
| response_format | string | 否 | 指定生成图像的返回格式。支持以下两种返回方式： - url：返回图片下载链接； - b64_json：以 Base64 编码字符串的 JSON 格式返回图像数据。 |
| watermark | boolean | 否 | 是否添加 AI 生成水印； - false不加水印； - true右下角添加 “AI 生成” 水印标识 |
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| model | string | 实际执行任务的模型标识 |
| created | int32 | 任务创建 Unix 时间戳（秒） |
| data | object[] | 图片结果数组。 子对象：url图片链接 /base64 数据； size图片像素尺寸，例如3104x1312 |
| tools | object[] | 本次请求传入的工具配置，仅 5.0‑lite 有效 |
| usage | object | 用量统计 |
| generated_images | int | 生成图片张数 |
| output_tokens | int | 输出 token |
| total_tokens | int | 总 token |
| tool_usage | object | 工具调用统计 |
| tool_usage.web_search | int | web_search 次数 |
示例
请求示例
curl -X POST https://ai.ctaigw.cn/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $YOUR_APP_KEY" \
-d '{
"model": "doubao-seedream-4.5",
"prompt": "春日山间小溪，水彩插画，柔和光影，治愈风格",
"size": "2K",
"output_format":"png",
"watermark": false
}'正常响应示例
{
"model": "doubao-seedream-4.5",
"created": 1757321139,
"data": [
{
"url": "https://aaaa.ctyun.cn/001.jpg",
"size": "3104x1312"
}
],
"usage": {
"generated_images": 1,
"output_tokens": 20000,
"total_tokens": 20000
}
}异常响应
{
"error": {
"type:": "Invalid_request",
"code": "missing_parameter",
"message": "Missing required parameters"
}
}
