SeeDream 图片生成

星算云 图片生成网关支持 Doubao Seedream 5.0 pro / 5.0 lite / 4.5 / 4.0 系列模型,提供两个对外端点:

端点	路径	适用客户端	错误信封
OpenAI 兼容	POST /v1/images/generations	OpenAI SDK / 兼容客户端	OpenAI 风格
火山兼容	POST /api/v3/images/generations	火山 SDK / curl	火山风格

鉴权

所有图片生成请求使用 Authorization: Bearer xsk_...,详见 鉴权。

非流式

curl(OpenAI 兼容)

API_BASE=https://xingsuan.cloud
curl "$API_BASE/v1/images/generations" \
  -H "Authorization: Bearer $XSK_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0",
    "prompt": "一只橘猫坐在窗台上看夕阳",
    "size": "2K"
  }'

Python SDK

from openai import OpenAI

client = OpenAI(
    base_url="https://xingsuan.cloud/v1",
    api_key="xsk_...",
)

result = client.images.generate(
    model="doubao-seedream-5-0",
    prompt="一只橘猫坐在窗台上看夕阳",
    size="2K",
)
print(result.data[0].url)

响应

{
  "model": "doubao-seedream-5-0",
  "created": 1784901390,
  "data": [
    {
      "url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/...",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16384,
    "total_tokens": 16384
  }
}

图片 URL 有效期

返回的 url 在图片生成后 24 小时内有效,请及时下载保存。

流式

设置 "stream": true,服务器通过 SSE 实时推送每张图片的生成结果。适用于组图(多图)场景,先完成先返回。

curl "$API_BASE/v1/images/generations" \
  -H "Authorization: Bearer $XSK_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0",
    "prompt": "四季风景组图",
    "size": "2K",
    "stream": true,
    "sequential_image_generation": "auto",
    "sequential_image_generation_options": {"max_images": 4}
  }'

流式事件

事件 type	触发	关键字段
image_generation.partial_succeeded	任意单图生成成功	image_index、url、size
image_generation.partial_failed	任意单图生成失败	image_index、error
image_generation.completed	全部处理完(末事件)	usage

event: image_generation.partial_succeeded
data: {"type":"image_generation.partial_succeeded","image_index":0,"url":"https://...","size":"2048x2048"}

event: image_generation.partial_succeeded
data: {"type":"image_generation.partial_succeeded","image_index":1,"url":"https://...","size":"2048x2048"}

event: image_generation.completed
data: {"type":"image_generation.completed","usage":{"generated_images":2,"output_tokens":32768,"total_tokens":32768}}

单图部分失败不影响其余

审核不通过导致单图失败时,服务器会继续生成其余图片,不影响同请求内的其他图。

请求参数

参数	类型	必填	说明
model	string	是	模型标识(model_code),如 doubao-seedream-5-0
prompt	string	是	提示词,支持中英文。建议不超过 300 汉字 / 600 英文单词;超长会被模型忽略细节
image	string | string[]	否	参考图(URL 或 Base64),支持单图或多图(pro ≤ 10,lite/4.5/4.0 ≤ 14)
size	string	否	分辨率档位(1K/2K/3K/4K)或显式像素(2048x2048),不可混用,默认 2048x2048
response_format	string	否	url(默认) / b64_json
output_format	string	否	png / jpeg(默认 jpeg,仅 5.0 lite 支持;其他子系列固定 jpeg)
stream	boolean	否	流式开关,默认 false
sequential_image_generation	string	否	组图模式:auto / disabled(默认),仅 lite/4.5/4.0 支持
sequential_image_generation_options.max_images	int	否	组图最大数量 [1,15],默认 15
tools	array	否	[{"type":"web_search"}] 启用联网搜索,仅 5.0 lite 支持;触发后 usage.tool_usage.web_search 返回搜索次数
optimize_prompt_options.mode	string	否	standard(默认) / fast;fast 仅 4.0 支持(5.0 lite 不支持)
watermark	boolean	否	是否加水印,默认 true;false 关闭"AI 生成"水印

Base64 传输

使用 image 传 Base64 时请遵循格式 data:image/<格式>;base64,<编码>,且请求 body 应控制在 8M 以下。

参考图(Base64)

curl "$API_BASE/v1/images/generations" \
  -H "Authorization: Bearer $XSK_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0",
    "prompt": "将这张照片转为油画风格",
    "image": "data:image/png;base64,iVBORw0KGgo...",
    "size": "2K"
  }'

计费

图片生成按成功生成张数计费(不按 token),支持两种定价模式:

• 统一价(flat):每张固定单价,不分分辨率;
• 像素分档(tiered):按图片总像素分标准档 / 高清档,各一单价。

具体价格见控制台「可用模型」页。仅成功生成的图片计费,生成失败的不计。

支持的模型

以控制台为准

下表为示例,实际可用模型以控制台为准。

model_code	模型	组图	流式	联网搜索
doubao-seedream-5-0	Seedream 5.0 lite	✅	✅	✅
doubao-seedream-5-0-pro	Seedream 5.0 pro	❌	❌	❌

Seedream 5.0 pro 仅支持单图生成,不支持组图 / 流式 / 联网搜索;5.0 lite / 4.5 / 4.0 支持组图与流式。

火山兼容端点

如果使用火山 SDK,将 base_url 指向 /api/v3:

curl "$API_BASE/api/v3/images/generations" \
  -H "Authorization: Bearer $XSK_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0",
    "prompt": "一只橘猫坐在窗台上看夕阳",
    "size": "2K"
  }'

请求体字段与 /v1/images/generations 完全一致;错误响应为火山风格 {"error":{"code":"...","message":"..."}}。