视频生成 API 总览
接口采用 New API / OpenAI Video 风格：先提交异步任务，再轮询任务状态。任务成功后，轮询响应中的 metadata.url 提供对象存储视频直链。
接入信息
| 项目 | 值 |
|---|---|
| Base URL | https://ling-light.com |
| 鉴权方式 | Authorization: Bearer <API_KEY> |
| 请求格式 | application/json |
| 任务模式 | 异步提交、任务轮询、完成后读取结果 |
| 时间戳 | Unix 秒 |
| 模型发现 | GET /v1/models |
接口一览
| 方法 | 路径 | 用途 |
|---|---|---|
| GET | /v1/models | 获取当前 API Key 可使用的模型 |
| POST | /v1/videos | 创建异步视频任务 |
| GET | /v1/videos/{id} | 查询任务状态与视频直链 |
创建视频任务
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | GET /v1/models 返回的模型 ID |
| prompt | string | 是 | 视频生成提示词 |
| seconds | integer | 否 | 视频时长，单位为秒 |
| resolution | string | 否 | 例如 480p、720p、1080p |
| aspect_ratio | string | 否 | 例如 16:9、9:16、1:1、auto |
| references | object[] | 否 | 参考素材数组 |
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"
}'生成模式
| 模式 | references 规则 |
|---|---|
| 文本生成视频 | references 为空或省略 |
| 首尾帧生成视频 | 恰好一个 first_frame 图片和一个 last_frame 图片 |
| 参考素材生成视频 | 一个或以上 role=reference 的图片、视频或音频 |
{
"id": "task_xxxxxxxxxxxxxxxx",
"object": "video",
"model": "seedance2.0",
"status": "queued",
"progress": 0,
"created_at": 1793433600,
"seconds": "5",
"metadata": {
"aspect_ratio": "16:9",
"resolution": "720p"
}
}查询任务与完成结果
轮询间隔建议为 3 至 5 秒。completed 和 failed 是终态；不要仅根据 progress 是否为 100 判断成功。
{
"id": "task_xxxxxxxxxxxxxxxx",
"object": "video",
"model": "seedance2.0",
"status": "completed",
"progress": 100,
"created_at": 1793433600,
"completed_at": 1793433690,
"seconds": "5",
"metadata": {
"resolution": "720p",
"aspect_ratio": "16:9",
"url": "https://media.example.com/videos/task_xxxxxxxxxxxxxxxx.mp4"
}
}安全与结果处理
- 模型 API Key 只能保存在服务端环境变量或密钥管理系统中。
- 不要把完整 Key、登录会话或控制台访问令牌放进浏览器请求、代码仓库或日志。
- 任务完成后的 metadata.url 是对象存储直链，请及时下载并保存到自有存储。
- 提交前对提示词和参考素材执行业务审核，不要仅依赖模型侧过滤。
价格以任务提交时的服务端报价为准
页面不根据模型倍率自行推算最终金额。实际收费与模型、分辨率、时长、账户分组及服务端计费规则有关。