管理员：Seedance 渠道接入

本页面向 NewAPI 管理员。普通调用者无需接触火山引擎密钥。

前置条件

• 已在火山引擎开通方舟及相应视频生成模型。
• 已创建可调用模型的 API Key。
• 账号余额、配额和内容安全资质满足请求要求。
• 如使用写实虚拟人或受控资产，已按上游要求完成额外授权和资产审核。

创建渠道

登录 NewAPI 管理控制台，新增渠道并设置：

配置	建议值
渠道类型	DoubaoVideo（内部类型 54）
API Key	火山引擎方舟 API Key
Base URL	使用项目默认值；只有明确使用兼容代理时才覆盖
模型	勾选实际开通的 Seedance 模型

本站当前对外启用的 Seedance 模型别名见可用模型。管理员应在渠道内维护别名到上游模型的映射；模型被适配器识别不代表已经自动向所有用户开放，还需要渠道、映射、分组和令牌权限同时生效。

上游创建任务地址由适配器拼接为：

{Base URL}/api/v3/contents/generations/tasks

因此 Base URL 不应包含上述任务路径。

配置易读别名

推荐让客户端使用稳定、易读的名称，例如：

seedance-2.0 → doubao-seedance-2-0-260128

如果要开放 Fast 版本，应使用独立别名，并分别配置权限和计费。修改后使用用户令牌查询 /v1/models，确认别名确实可见。

权限与计费

上线前检查：

1. 模型已加入目标用户分组。
2. 令牌允许访问该模型。
3. 模型价格或倍率已经设置。
4. 视频输入折扣与当前上游定价一致。
5. 失败任务的退款行为符合本站策略。

项目当前对 Seedance 2.0 与 Fast 模型的视频输入设置了单独折扣逻辑。上游价格发生变化时，应同步复核模型价格和折扣，不要只修改展示价格。

上线验证

按低成本顺序验证：

1. 使用用户令牌请求 /v1/models，确认模型可见。
2. 提交 5 秒、720p、关闭音频的文生视频任务。
3. 保存公开任务 ID，查询至 completed。
4. 下载结果并确认内容接口可用。
5. 检查 NewAPI 使用日志中的最终扣费。
6. 再测试一张明确有权使用的普通图片。
7. 最后测试已审核的虚拟人资产。

避免在健康检查中生成视频

视频请求会产生费用且依赖上游排队，不应放入自动健康检查或高频监控。日常健康检查使用 /api/status 或 /v1/models 即可。

回滚与停用

发现价格、审核或稳定性异常时，优先停止向目标分组开放该模型，保留渠道和任务日志用于排查。不要删除仍有进行中任务的渠道记录。