Images（Seedream）
图片生成与编辑，兼容 OpenAI Images 接口并透传 Seedream 扩展字段。
生成
POST/v1/images/generations
| 字段 | 类型 | 说明 | |
|---|---|---|---|
| model | string | 必填 | 从模型广场复制已上架 ID，例如 dola-seedream-5-0-lite；不要把展示名称当作 ID。 |
| prompt | string | 必填 | 提示词。 |
| size | string | 可选 | 按模型选分辨率：Pro 为 1K / 1.5K / 2K，Lite 为 2K / 3K / 4K，4.5 为 2K / 4K；也可按官方约束传宽x高。 |
| n | integer | 可选 | 单张填 1；Lite / 4.5 可设 1–9，代表最多生成张数，网关转换为供应商组图字段并按最大张数预留、实际生成张数结算。Pro 单次请求仅支持 1 张。 |
| response_format | string | 可选 | url（默认）或 b64_json。 |
| image | string | array | 可选 | 参考图 URL、data:image Base64 或本人素材库的 asset://<id>。后者会校验归属并转成火山/BytePlus 可接收的图片数据；单张不超过 10 MiB、合计不超过 20 MiB。 |
| watermark | boolean | 可选 | 是否添加水印（Seedream 扩展）。 |
| sequential_image_generation | string | 可选 | Lite / 4.5 可用 auto，但必须同时传 n 指定可预留的最大张数；不接受独立的 sequential_image_generation_options。默认按 n 自动适配。 |
curl https://www.link42.ai/v1/images/generations \
-H "Authorization: Bearer $LINK42_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "dola-seedream-5-0-lite", "prompt": "海边日出，胶片质感", "size": "2K", "watermark": false}'{
"created": 1788300000,
"data": [{"url": "https://…/image.png", "size": "2048x2048"}],
"usage": {"generated_images": 1, "output_tokens": 0, "total_tokens": 0}
}编辑
POST/v1/images/edits
火山方舟与 BytePlus 的图生图请调用 /v1/images/generations，并在 image 字段传 URL、Base64 或本人 asset://<id>；它们没有单独的上游 edits 接口。/v1/images/edits 仅适用于另行配置了该端点的供应商，不承诺对火山模型可用。
异步生成
POST/v1/images/generations/async
请求体与同步生成相同（不支持 stream），立即返回 202 和任务 id。大图或高质量出图耗时较长时，用它避免 CDN / 反向代理的空闲超时切断连接。任务以提交它的 API Key 执行，鉴权、IP 白名单、限流、计费与路由都和同步调用一致。
用 GET /v1/images/tasks/{id} 轮询，status 依次为 queued、running、succeeded 或 failed。成功后 result 与同步响应同形，data[].url 是平台存储里图片的临时下载链接，每次读取重新签发（默认 1 小时有效）；任务和图片默认保留 72 小时。失败时 error 给出与同步调用相同的 code 与 message。
因速率或并发限制被拒绝的任务不会失败，而是重新排队稍后执行，等待超过 30 分钟才以该限制的错误结束。每个用户同时排队或运行的任务默认最多 10 个，超出返回 429 too_many_running_tasks。提交支持 Idempotency-Key 头：在任务保留期内以同一个键重试，返回首次创建的任务（响应头 Idempotency-Replayed: true），不会重复出图计费；同一个键配不同请求体返回 409 idempotency_conflict。
curl https://www.link42.ai/v1/images/generations/async \
-H "Authorization: Bearer $LINK42_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "dola-seedream-5-0-lite", "prompt": "海边日出，胶片质感", "size": "4K"}'{
"id": "imgtask_7c10e3ddf2dd27209947d8b9c0b603b2",
"object": "image.task",
"model": "dola-seedream-5-0-lite",
"status": "queued",
"created_at": 1788300000
}curl https://www.link42.ai/v1/images/tasks/imgtask_7c10e3ddf2dd27209947d8b9c0b603b2 \
-H "Authorization: Bearer $LINK42_API_KEY"{
"id": "imgtask_7c10e3ddf2dd27209947d8b9c0b603b2",
"object": "image.task",
"model": "dola-seedream-5-0-lite",
"status": "succeeded",
"created_at": 1788300000,
"finished_at": 1788300042,
"expires_at": 1788559242,
"result": {
"created": 1788300041,
"data": [{"url": "https://…/image-tasks/…/0.png?X-Amz-Signature=…"}],
"usage": {"generated_images": 1}
}
}按模型对照
Seedream 扩展字段按型号能力校验：Lite / 4.5 的 n>1 会换成方舟组图字段，model 会改写成目录绑定的上游 ID。按最多张数预留、实际生成张数结算。以下旧版行供迁移参考；是否已上架以实时模型广场为准。
| 模型 ID | 名称 | 上游 | 计费 | 差异字段 | 限制与注意 |
|---|---|---|---|---|---|
| seedream-4-0-250828 | Seedream-4.0 | BytePlus Ark | 按张 | prompt、size、response_format、stream、sequential_image_generation、watermark | 按 usage.generated_images 计费，上游没返回该字段时按 data 数组长度计；size 接受 1K / 2K / 4K 或 宽x高 |
| seedream-4-5-251128 | Seedream-4.5 | BytePlus Ark | 按张 | 同 4.0 | 计费与尺寸规则同 4.0 |
| seedream-5-0-260128 | Seedream-5.0 | BytePlus Ark | 按张 | 同 4.0 | 计费与尺寸规则同 4.0 |
| dola-seedream-5-0-pro-260628 | Seedream-5.0 Pro（上游 ID） | BytePlus Ark | 按张（像素面积分档） | 支持 1K / 1.5K / 2K、image 参考图；不支持组图 | 这是上游 ID；LINK42 当前目录 ID 为 dola-seedream-5-0-pro。≤261 万像素 $0.045/张，超过则 $0.09/张；首张参考图免费，其后 $0.003/张。 |
| dola-seedream-5-0-pro | Dola-Seedream-5.0-pro | BytePlus Ark | 按张（像素面积分档） | 1K / 1.5K / 2K；单张生成、图生图与多参考图 | ≤261 万像素 $0.045/张，超过则 $0.09/张；首张参考图免费，其后 $0.003/张；不支持 sequential_image_generation。 |
| dola-seedream-5-0-lite | Dola-Seedream-5.0-lite | BytePlus Ark | 按张 | 2K / 3K / 4K；支持参考图、官方约束内自定义宽高和最多 9 张组图 | $0.035/张；组图按最大张数预留，按实际生成张数结算。 |
| bytedance-seedream-4-5 | ByteDance-Seedream-4.5 | BytePlus Ark | 按张 | 2K / 4K；支持参考图、官方约束内自定义宽高和最多 9 张组图 | $0.04/张；组图按最大张数预留，按实际生成张数结算。 |
| doubao-seedream-5-0-pro | Doubao-Seedream-5.0-pro | 国内火山方舟（北京） | 人民币原价按最新 SAFE 汇率折美元，再应用有效折扣（账号模型专属、账号默认、模型默认依次生效） | 1K / 1.5K / 2K 或官方允许的宽x高；单图、参考图 | 图像生成原价 ¥0.30 / ¥0.60 两档；首张输入图免费，其后 ¥0.02/张；图层拆分暂未开放于 LINK42。 |
| doubao-seedream-5-0-lite | Doubao-Seedream-5.0-lite | 国内火山方舟（北京） | 人民币原价按最新 SAFE 汇率折美元，再应用有效折扣（账号模型专属、账号默认、模型默认依次生效） | 2K / 3K / 4K 或官方允许的宽x高；参考图与最多 9 张组图 | 原价 ¥0.22/张；组图按最大张数预留，按实际生成张数结算。 |
- data[].url 是上游签名地址，有效期有限；需要长期保存请自行转存，或在控制台开启结果转存。