火山方舟原生协议：与兼容入口的区别
整理火山方舟原生接入中的模型、任务类型、鉴权和返回结构核对流程，说明不能以换域名代替德他协议适配。
作者：德他数据技术团队 · 更新于 2026-09-24
核心解答
火山方舟原生协议应按具体文本、图片或视频产品分别核对。德他当前没有开放方舟原生端点；只有已核准的非流式纯文本或固定按张同步图片方案可以走德他兼容入口。
阅读范围与当前状态
本篇为完整的协议说明或接入准备指南，不代表所述原生、视频或扩展能力已在德他开放。真实调用以接口开放范围和具体模型的核准状态为准。
原生协议与兼容协议
原生协议面向供应商自己的产品能力，兼容协议只覆盖约定的共同字段。两者可以表达类似任务，但不能据此认为所有原生参数都会被兼容网关转发。
接入前确定四个维度
| 维度 | 需要回答的问题 |
| --- | --- |
| 任务 | 文本、同步图片、视频还是素材管理？ |
| 模型 | 使用哪个精确产品 ID 与版本？ |
| 协议 | 客户端实际请求路径与数据结构是什么？ |
| 结算 | 使用什么单位，异常结果如何核验？ |
不要只记录品牌与报价；多规格方案还应确认所选规格是否已开放实际调用。
兼容迁移流程
先用最小纯文本或图片任务核对德他开放范围，再剔除不支持的扩展。不能静默删除会改变业务含义的参数，例如参考图或工具定义；遇到这种情况应判定该业务当前不兼容，而不是报告迁移成功。
德他当前限制
原生方舟路径、视频任务和素材库未开放。同步图片仅接受已公开字段且要求固定按张核准；纯文本不支持多模态、工具和流式。上游密钥不应交给普通客户，客户只使用自己的德他令牌。
迁移验收
核对请求字段、返回正文、用量与账务、错误分类和未知结果处理。测试计划必须得到实际调用授权并控制预算，阅读文档和保存配置本身不构成付费测试授权。
常见问题
方舟 SDK 能直接改为德他域名吗？
不能保证，先确认其实际协议与附带字段。
原厂新增功能是否会自动在德他生效？
不会。需要网关适配、计费核验和产品授权。
关联文档：德他数据教程。本文按德他实际功能独立编写。