火山引擎调用总览

本文说明通过 AI Gateway 调用火山引擎 / 火山方舟模型时的统一地址、模型分类和章节选择方式。

一、Endpoint 总览

在 AI Gateway 中调用火山引擎模型时，使用 AI Gateway 的网关地址和 API Key：

export AI_GATEWAY_VOLC_BASE_URL="https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3" export API_KEY="<your-api-key>"

模型类型	Endpoint	适用模型
Responses API（推荐）	`https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/responses` https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/responses	Doubao Seed 文本、代码、翻译、角色、视觉理解等模型
Chat API（兼容旧代码）	`https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/chat/completions` https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/chat/completions	已接入 Chat Completions 的存量业务
图片生成	`https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/images/generations` https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/images/generations	Seedream 图片生成 / 图片编辑模型
视频生成	`https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/contents/generations/tasks` https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/contents/generations/tasks	Seedance 视频生成模型
3D 生成	`https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/contents/generations/tasks` https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/contents/generations/tasks	Seed3D、Hyper3D、Hitem3D 等 3D 生成模型
多模态 Embedding	`https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/embeddings/multimodal` https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/api/v3/embeddings/multimodal	`doubao-embedding-vision` doubao-embedding-vision

注意：

火山引擎模型使用
```
/gateway/api/v3/...
```
/gateway/api/v3/...
。
阿里云百炼、腾讯 TokenHub 等非火山文本模型通常使用
```
/gateway/v1/...
```
/gateway/v1/...
，不要混用。
HappyHorse 视频生成是阿里云百炼接口，路径是
```
/gateway/api/v1/services/aigc/video-generation/video-synthesis
```
/gateway/api/v1/services/aigc/video-generation/video-synthesis
，不要与 Seedance 混用。
API Key 使用 AI Gateway 中创建的 Key，不是火山方舟原始 API Key。
对于火山文本生成、视觉理解、结构化输出和工具调用，建议优先使用 Responses API；Chat API 仅建议用于兼容已有 Chat Completions 代码。

请求头：

Authorization: Bearer <API_KEY> Content-Type: application/json

二、模型分类

模型类型	模型
文本 / 推理 / 通用对话	`doubao-seed-2.0-pro` doubao-seed-2.0-pro 、 `doubao-seed-2.0-lite` doubao-seed-2.0-lite 、 `doubao-seed-2.0-mini` doubao-seed-2.0-mini 、 `doubao-seed-1.8` doubao-seed-1.8 、 `doubao-seed-1.6` doubao-seed-1.6 、 `doubao-seed-1.6-lite` doubao-seed-1.6-lite 、 `doubao-seed-1.6-flash` doubao-seed-1.6-flash 、 `doubao-1.5-pro-32k` doubao-1.5-pro-32k 、 `doubao-1.5-lite-32k` doubao-1.5-lite-32k
代码模型	`doubao-seed-2.0-code` doubao-seed-2.0-code 、 `doubao-seed-code` doubao-seed-code
角色 / 人设模型	`doubao-seed-character` doubao-seed-character
翻译模型	`doubao-seed-translation` doubao-seed-translation
视觉理解	`doubao-seed-1.6-vision` doubao-seed-1.6-vision 、 `doubao-1.5-vision-pro` doubao-1.5-vision-pro
视频生成	`doubao-seedance-2.0` doubao-seedance-2.0 、 `doubao-seedance-2.0-fast` doubao-seedance-2.0-fast 、 `doubao-seedance-1.5-pro` doubao-seedance-1.5-pro 、 `doubao-seedance-1.0-pro` doubao-seedance-1.0-pro 、 `doubao-seedance-1.0-pro-fast` doubao-seedance-1.0-pro-fast
图片生成	`doubao-seedream-5.0-lite` doubao-seedream-5.0-lite 、 `doubao-seedream-4.5` doubao-seedream-4.5 、 `doubao-seedream-4.0` doubao-seedream-4.0
3D 生成	`doubao-seed3d-2.0` doubao-seed3d-2.0 、 `Hyper3d-Gen2` Hyper3d-Gen2 、 `Hitem3d-2.0` Hitem3d-2.0
视觉向量化	`doubao-embedding-vision` doubao-embedding-vision

模型名称以 模型广场 详情页展示和示例代码为准。部分火山方舟原始模型 ID 可能带日期后缀，AI Gateway 中的模型名可能做过标准化，请优先复制模型广场中的名称。

三、Responses API 与 Chat API 选择建议

火山引擎同时提供 Chat API 和 Responses API。新接入业务建议优先使用 Responses API，原因是 Responses API 覆盖能力更完整，后续高级能力也会优先在 Responses API 中提供。

能力	Chat API	Responses API
文本生成	支持	支持
视觉理解	支持	支持
结构化输出	beta 阶段	beta 阶段
函数调用 Function Calling	支持	支持
联网搜索 Web Search	不支持	支持
图像处理 Image Process	不支持	支持
私域知识库搜索 Knowledge Search	不支持	支持
云部署 MCP	不支持	支持
上下文缓存	不支持	支持，具体模型版本以模型广场为准

推荐策略：

新业务默认使用 Responses API。
已经接入 OpenAI Chat Completions 的存量业务，可以继续使用 Chat API，后续再迁移到 Responses API。
需要联网搜索、图像处理、知识库检索、MCP 或上下文缓存时，应使用 Responses API。
如果模型广场中某个模型仅展示 Chat 示例，可先使用 Chat API，并关注后续 Responses 支持情况。

四、建议章节

章节	内容
Responses API	推荐调用方式；文本、视觉、多模态输入、流式输出、结构化输出、工具调用和高级能力
Chat API 兼容调用	存量 Chat Completions 业务迁移和兼容说明
Seedream 图片生成	文生图、参考图生成、图片编辑、多图输出
Seedance 视频生成	文生视频、图生视频、异步任务、轮询查询
3D 生成	文本/图片生成 3D、异步任务、结果转存
多模态 Embedding	文本、图片、视频向量化和向量库接入建议
错误排查与官方参考	常见错误、路径排查、官方参考链接

联系我们