火山方舟模型接入指南

概览

OneLinkAI 提供火山方舟平台兼容接口，用于在 OneLinkAI 网关下调用火山方舟的视频生成与图片生成能力。整体目标是尽可能兼容火山方舟官方协议，方便已经接入火山方舟官方接口的业务快速迁移或并行接入。

当前这组兼容接口仅覆盖以下能力：

视频生成 API：创建视频生成任务 API、查询视频生成任务 API

图片生成 API：图片生成 API

接入规则

鉴权方式

调用 OneLinkAI 的火山方舟平台兼容接口时，统一使用 Bearer Token 鉴权：

路径规则

在 OneLinkAI 中，火山方舟兼容接口统一挂载在 /volc/api/v3 前缀下。

示例：

官方路径：/api/v3/contents/generations/tasks

OneLinkAI 路径：/volc/api/v3/contents/generations/tasks

官方路径：/api/v3/images/generations

OneLinkAI 路径：/volc/api/v3/images/generations

也就是说，如果你已经接入过火山方舟官方接口，通常只需要：

将请求地址替换为 OneLinkAI 对应兼容地址。

将鉴权方式统一为 OneLinkAI 的 Authorization: Bearer <ApiKey>。

按照当前支持范围继续使用原有请求体结构进行联调。

通用调用方式

视频生成接口为异步接口，创建成功后通常返回任务 ID id，再通过查询接口获取最终状态与结果。

图片生成接口按官方协议返回图片结果；当 response_format=url 时，返回的结果链接存在有效期，建议业务侧及时转存。

请求体字段与响应体结构按火山方舟官方文档整理，OneLinkAI 保留统一鉴权与网关路径。

能力清单

以下内容用于快速说明 OneLinkAI 对火山方舟官方能力的当前支持范围。实际调用时请以当前目录下的接口文档为准。

视频生成 API

能力名称	是否支持	参考文档
创建视频生成任务 API	✔️	https://www.volcengine.com/docs/82379/1520757?lang=zh
查询视频生成任务 API	✔️	https://www.volcengine.com/docs/82379/1521309?lang=zh

图片生成 API

能力名称	是否支持	参考文档
图片生成 API	✔️	https://www.volcengine.com/docs/82379/1541523?lang=zh

未在上述清单中的火山方舟接口，当前暂不支持。

接口详情

以下请求示例统一以 https://api.onelinkai.cloud 作为示例网关地址，实际调用时请替换为你的真实接入地址和有效的 ApiKey。

视频生成 API

创建视频生成任务 API

兼容火山方舟官方视频生成协议的创建任务接口

官方请求路径：POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks

OneLinkAI 路径：POST /volc/api/v3/contents/generations/tasks

核心请求字段：model、content、callback_url、return_last_frame、service_tier、resolution、ratio、duration 或 frames

核心响应字段：id

查询视频生成任务 API

兼容火山方舟官方视频生成协议的任务查询接口

官方请求路径：GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{id}

OneLinkAI 路径：GET /volc/api/v3/contents/generations/tasks/{id}

核心响应字段：id、model、status、error、created_at、updated_at、content.video_url

如果创建任务时设置了 return_last_frame=true，查询结果还可能返回 content.last_frame_url

图片生成 API

兼容火山方舟官方图片生成协议的图片生成接口

官方请求路径：POST https://ark.cn-beijing.volces.com/api/v3/images/generations

OneLinkAI 路径：POST /volc/api/v3/images/generations

核心请求字段：model、prompt、image、size、response_format、watermark

核心响应字段：model、created、data、usage、error

当 response_format=url 时，结果通常位于 data[].url；当 response_format=b64_json 时，结果通常位于 data[].b64_json

OneLinkAI 当前不支持该接口的流式响应，请按非流式方式调用。

真人素材说明

Seedance 2.0 系列模型不支持直接上传含有真人人脸的参考图或参考视频。针对真人素材场景，OneLinkAI 当前接入能力如下：

OneLinkAI 当前提供以下两个供应商通道用于对接相关能力：

【火山方舟 A】：请参考教程：https://docs.onelinkai.cloud/8626681m0

【BSeedance】：不支持真人素材

使用建议

如果你已经接入过火山方舟官方接口，推荐优先复用原有请求体结构和业务侧调用逻辑。

视频生成建议先打通“创建任务 + 查询任务”的闭环，再补充回调处理。

图片生成若使用 response_format=url，建议在业务侧尽快下载或转存生成结果。

具体模型能力、字段约束、错误码与边界行为，请以对应官方接口文档为准。

如后续新增兼容能力，本文档会同步更新。

概览#

接入规则#

鉴权方式#

路径规则#

通用调用方式#

能力清单#

视频生成 API#

图片生成 API#

接口详情#

视频生成 API#

创建视频生成任务 API#

查询视频生成任务 API#

图片生成 API#

图片生成 API#

真人素材说明#

使用建议#

概览

接入规则

鉴权方式

路径规则

通用调用方式

能力清单

视频生成 API

图片生成 API

接口详情

视频生成 API

创建视频生成任务 API

查询视频生成任务 API

图片生成 API

图片生成 API

真人素材说明

使用建议