用一个 API，接入 Seedance 视频生成
面向开发者的异步视频生成服务。提交任务后轮询状态，任务完成时直接返回对象存储视频直链。
OpenAI Video 风格
使用 POST /v1/videos 创建任务，GET /v1/videos/{id} 查询结果。
异步任务
提交后立即返回任务 ID，通过 queued、in_progress、completed 等状态跟踪进度。
视频直链
完成后从 metadata.url 读取对象存储地址，不需要自行拼接存储路径。
当前公开模型
公开目录目前列出 seedance2.0、seedance2.5、seedance2.0-fast 和 seedance2.0-mini，统一使用 openai-video 接口类型。可用性以当前 API Key 的模型查询结果为准。
| 模型 | 生成方式 | 接口 |
|---|---|---|
| seedance2.0 | 文生视频、首尾帧、参考素材 | POST /v1/videos |
| seedance2.5 | 文生视频、首尾帧、参考素材 | POST /v1/videos |
| seedance2.0-fast | 以当前账户可见能力为准 | POST /v1/videos |
| seedance2.0-mini | 以当前账户可见能力为准 | POST /v1/videos |
从请求到视频
- 创建 API Key登录控制台，为服务端环境创建独立的模型 API Key。
- 提交任务向 /v1/videos 发送模型、提示词和可选参考素材。
- 轮询状态每 3 至 5 秒查询任务，直到 completed 或 failed。
- 读取结果从 metadata.url 获取并下载对象存储视频直链。
curl --request POST "https://ling-light.com/v1/videos" \
--header "Authorization: Bearer $VIDEO_API_KEY" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: $(uuidgen)" \
--data '{
"model": "seedance2.0",
"prompt": "一只橘猫坐在窗台上看雨，镜头缓慢推近",
"seconds": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}'先读文档，再接入
请求字段、参考素材规则、幂等和错误处理会直接影响接入稳定性。建议从视频 API 总览和快速开始顺序阅读。