唯一调用域名
所有生产请求均发送到 https://ai.shanhui.tv。aidocs.shanhui.tv 只承载说明文档,不处理 API 请求。
标准 Bearer 认证
使用控制台创建的 sk-... API 密钥,无需暴露账户密码。
异步视频任务
提交后获得任务 ID,通过查询接口轮询状态与结果。
按 Token 计费
以完成任务返回的实际计费 Token 为准,失败任务不应按成功产物计费。
核心端点¶
POST
https://ai.shanhui.tv/v1/video/generationsGET
https://ai.shanhui.tv/v1/video/generations/{task_id}GET
https://ai.shanhui.tv/v1/videos/{task_id} 兼容查询路径这是视频任务端点,不要把模型配置成 Chat 端点,也不要调用 /v1/chat/completions。
最小请求¶
curl -X POST 'https://ai.shanhui.tv/v1/video/generations' \
-H 'Authorization: Bearer sk-your-api-key' \
-H 'Content-Type: application/json' \
-d '{
"model": "doubao-seedance-2-0-fast-260128",
"prompt": "清晨的森林,阳光穿过树叶,镜头缓慢向前推进",
"metadata": {
"duration": 5,
"ratio": "16:9",
"resolution": "720p",
"generate_audio": true,
"watermark": false
}
}'
提交成功后保存返回的 task_id(部分响应同时提供 id),再查询任务状态。
接入流程¶
- 登录 闪绘控制台,在「API 密钥」中创建调用密钥。
- 选择 Seedance 模型,按本文档构造 JSON 请求。
- 提交任务并保存
task_id。 - 每 8–15 秒查询一次,直至
completed或failed。 - 完成后尽快下载或转存视频结果。
文档范围¶
本文档面向闪绘网关调用者。上游服务、渠道密钥、内部渠道 ID 与后台运维配置不属于公开 API,也不会出现在示例中。