火山方舟接入范围与准备指南
梳理火山方舟文本、图像、视频与素材能力的接入准备,解释原生协议与德他兼容入口的不同边界。
作者:德他数据技术团队 · 更新于 2026-09-24
核心解答
先确定任务类型和具体模型方案,再确认德他是否已核准对应兼容入口。火山原生协议、视频与素材库当前未开放;原厂已有功能不会因改为德他域名而自动可用。
阅读范围与当前状态
本篇为完整的协议说明或接入准备指南,不代表所述原生、视频或扩展能力已在德他开放。真实调用以接口开放范围和具体模型的核准状态为准。
先确认你需要哪种协议
模型品牌与接口协议不是同一件事。模型广场展示某个火山模型,只表示存在商品信息,不意味着方舟原生路径、素材库或视频任务接口已经可用。
德他当前支持经过单独核准的非流式纯文本对话和指定同步图片生成。是否可调用,还取决于该商品的接口开放策略、账户余额与令牌预算。
两类接入需求
| 需求 | 当前处理方式 |
| --- | --- |
| 纯文本对话 | 查验该模型是否核准用于 /v1/chat/completions |
| 同步图片生成 | 查验是否属于已核准的按张固定计费模型 |
| 方舟原生请求格式 | 当前未开放,不要仅替换域名发起请求 |
| 素材库、视频创建与查询 | 当前未开放,需完成专门适配后再接入 |
接入前准备
- 从模型广场记录准确模型 ID,不以展示名称代替请求参数。
- 确认输入类型:纯文字、图片或素材引用,分别核对平台支持范围。
- 明确输出是同步结果还是异步任务;两者不能共用同一调用流程。
- 准备脱敏的参数清单、尺寸和数量需求,提交平台支持核对。
- 未确认开放之前,不发送真实业务数据或尝试批量调用。
素材与任务需要单独适配
素材上传、资源权限、任务状态、结果有效期和失败账务需要分别实现。仅有一个模型条目不包含这些能力。需要视频或素材库时,请说明业务流程,由平台确认适配计划;本文不承诺上线时间。
常见问题
能把方舟官方示例的域名换成德他吗?
不能直接这样做。原生协议与兼容协议的路径、字段和任务语义不同,必须以德他公开的接口范围为准。
商品能看到但接口报错怎么办?
先查看模型是否已核准调用,再检查令牌预算与账户余额。结果不确定时保留请求编号,不要立即重复提交以免重复计费。
继续阅读
- 接口开放范围
- 文本对话参数说明
- 错误码与故障排查
常见问题
为什么同属方舟的产品不能共用一个请求?
文本、图片、视频和素材资源的输入、返回、生命周期与结算方式不同,需要分别适配和验收。