全部参数
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
model | string | 是 | 模型名称，如 doubao-seedream-5-0-260128 |
prompt | string | 是 | 你的图片描述 |
size | string | 否 | 图片尺寸，如 1024x1024、1792x1024、2k |
image | string | { file_id, image_url? } | 数组 | 否 | 参考图。可以用 URL 字符串、上传文件 ID 对象，或数组（多图融合） |
stream | boolean | 否 | 流式输出。默认 false |
response_format | 'url' | 'b64_json' | 否 | 图片返回格式。默认 url |
task | boolean | 否 | 异步任务模式（返回 task_id，需轮询）。仅 bailian 可用 |
n | number | 否 | 一次生成多张 |
user | string | 否 | 可选的终端用户标识，用于用量追踪 |
upstream_options | object | 否 | 供应商特有参数（见各供应商页面） |
headers | object | 否 | 自定义 HTTP Header，用于链路追踪和用户归因 |
自定义 Header
{
"headers": {
"x-trace-id": "trace-9c1ab",
"x-user-id": "u_42",
"x-agent-name": "design-bot"
}
}
Header 值会记入用量日志，方便你追踪请求和归因。
图片尺寸
| 模型 | 支持的尺寸 |
|---|---|
| dall-e-3 | 1024x1024、1792x1024、1024x1792 |
| dall-e-2 | 1024x1024、512x512、256x256 |
| stable-diffusion | 多种正方形和宽屏格式 |
不同模型支持的尺寸不同，详见各供应商页面。
参考图
image 字段支持三种形式：
// 1. URL 字符串
{ "image": "https://example.com/portrait.jpg" }
// 2. 上传的文件
{ "image": { "file_id": "file-xxx", "image_url": "https://..." } }
// 3. 多张图片（融合模式）
{ "image": ["https://example.com/a.jpg", "https://example.com/b.jpg"] }