接口说明
Video Generations API 用于生成视频，支持文生视频和图生视频。具体请求字段、同步/异步行为与返回结果取决于当前启用的视频模型和对应上游实现。
请求方式
POST
请求地址
/v1/videos/generations
认证方式
Authorization: Bearer <API_KEY>
异步任务
部分视频模型会返回异步任务结果。当前平台提供 GET /v1/tasks/{task_id} 查询接口，但是否进入该托管链路，仍需以实际模型返回体为准。
curl
# 1. 创建视频请求
curl -X POST https://api.lingyuncx.com/v1/videos/generations \
-H "Authorization: Bearer sk-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "<请替换为当前启用的 video 模型 ID>",
"prompt": "海浪拍打岩石的慢动作",
"duration": 5
}'
# 如果返回体中包含 task_id，且该模型已进入平台任务托管链路，
# 可继续查询任务状态：
# 2. 查询状态
curl https://api.lingyuncx.com/v1/tasks/task_xxx \
-H "Authorization: Bearer sk-xxxxxxxx"
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
model |
string | 是 | 视频模型 ID，建议先通过 /v1/models 查询当前启用的 type=video 模型 |
prompt |
string | 是 | 视频描述文本 |
image_url |
string | 否 | 参考图像 URL（图生视频） |
duration |
integer | 否 | 视频时长（秒），默认 5 |
resolution |
string | 否 | 分辨率参数；是否支持由当前上游模型决定 |
任务状态
| 状态 | 说明 |
|---|---|
queued |
任务已接受，等待处理 |
running |
任务执行中 |
success |
任务执行成功 |
failed |
任务执行失败 |
timeout |
任务执行超时 |
cancelled |
任务已取消或客户端中断 |
返回示例
JSON
{
"task_id": "task_xxx",
"request_id": "req_xxx",
"status": "queued",
"message": "Task submitted successfully. Use GET /v1/tasks/{task_id} to check status.",
"created_at": "2026-03-13 12:00:00"
}
💡 提示
当前实例的 active 视频模型数量为 1。接入前请先确认真实模型 ID；不要直接沿用其他平台的静态模型名。