火山方舟 · 图片模型
火山方舟 · 图片模型接入
本页是火山方舟图片模型的分类导航页，用于选择推荐协议和具体接入文档。
供应商：火山方舟（Volcengine Ark / 豆包 Seedream）
适用 modelKey：见 modelKey 速查表（火山方舟 · 图片）。
modelKey 以
GET /api/ai/models返回为准。
如何选择接入方式
| 场景 | 推荐方式 | 文档 |
|---|---|---|
| 新项目 / 快速集成 | 平台异步任务 API — 统一参数格式，平台自动映射到方舟 | 平台异步任务 API（图片） |
| 需要模型特有参数说明 | 系列文档 — 查看 Seedream 各版本的平台字段映射与默认值 | Seedream 系列 |
| 迁移已有方舟代码 / 需要厂商全量参数 | 供应商原生接口兼容 — 请求体按方舟格式，平台不做字段翻译 | 火山方舟原生接口兼容（图片） |
两种方式都经过 JELLYTOKEN 鉴权和计费，区别在于平台是否帮你翻译参数。详见 异步任务 · 两种接入方式。
平台文档
按需选择平台侧说明；入参/出参以平台文档为准。
| 文档 | 说明 |
|---|---|
| 异步任务（图像/视频/文本） | 通用 POST /api/ai/tasks、imageParams 结构 |
| Webhook 回调 | 异步完成通知 |
| 供应商原生接口兼容 | /ark/api/v3/images/generations 等 |
| modelKey 速查表 | 全部 Seedream modelKey → 主文档 |
| 模型列表与元信息 | 查询可用 modelKey 与 type |
厂商文档
需对照方舟原生 HTTP 字段、尺寸与风格参数时，查阅官方文档；平台侧支持的扩展字段可通过 imageParams.extraParamsJson 传递，具体以各系列文档和当前平台映射为准。
| 文档 | 说明 |
|---|---|
| 火山方舟官方文档 | 总入口 |
| 图片生成 API | Seedream HTTP API |
| Seedream 4.0/5.0 教程 | 使用教程 |
| Seedream 提示词指南 | 提示词 |
| 图片生成模型说明 | 模型能力说明 |