视频生成

提交视频生成任务。视频生成是异步任务:提交后返回任务 ID,需要轮询任务状态,完成后按结果结算。

基本信息

方法POST 端点https://koprouter.kopglobal.com/v1/videos 鉴权Authorization: Bearer sk-...

请求参数

参数 类型 必填 说明
model string 是 视频生成模型 ID
prompt string 是 视频描述文字
size string 否 视频分辨率
duration number 否 视频时长

请求示例

curl https://koprouter.kopglobal.com/v1/videos \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "A beach at sunset with waves rolling in",
    "duration": 5
  }'

响应示例

{
  "id": "video-abc123",
  "object": "video",
  "status": "queued"
}

查询任务状态

通过任务 ID 查询进度,status 可能为 queued、processing、succeeded 或 failed:

curl https://koprouter.kopglobal.com/v1/videos/video-abc123 \
  -H "Authorization: Bearer sk-..."
视频为异步任务,仅在任务成功完成后才结算费用;失败任务不产生计费。