Grok 视频生成、编辑与下载

QuotaAPI 提供 Grok 视频任务的兼容入口。视频接口是异步工作流：先提交任务取得 request_id，再查询状态，完成后通过受保护的内容接口下载。

使用条件

1. API Key 绑定 Grok 分组，或绑定能够把视频模型解析到 Grok 的 Composite 分组。
2. 分组已开启图片/媒体生成功能。
3. 使用控制台实际开放的视频模型名称。

视频生成、编辑和延长的提交接口只支持 Grok 目标。状态与内容查询必须使用提交任务时的同一用户和同一个 API Key；系统会把 request_id 绑定到原上游账号，避免后续查询漂移到其他账号。

文生视频与图生视频

curl https://quotarouter.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_QUOTAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "Slow ocean waves at sunrise, stable camera.",
    "resolution": "720p",
    "duration": 8
  }'

图生视频在同一接口中增加输入图片：

{
  "model": "grok-imagine-video-1.5",
  "prompt": "Animate the subject with subtle natural motion.",
  "image": {
    "url": "https://example.com/input.png"
  }
}

提交成功后保存返回的 request_id。视频生成是长耗时任务，不要把提交响应误当成最终视频，也不要因为短时间内仍为处理中就重复创建任务。

视频编辑

curl https://quotarouter.ai/v1/videos/edits \
  -H "Authorization: Bearer YOUR_QUOTAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "Use a cooler color grade and preserve the camera movement.",
    "video": {
      "url": "https://example.com/source.mp4"
    },
    "duration": 8
  }'

输入视频 URL 必须能被目标平台读取。短期签名 URL 应覆盖完整处理时间。

视频延长

curl https://quotarouter.ai/v1/videos/extensions \
  -H "Authorization: Bearer YOUR_QUOTAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "Continue the scene with the same movement and lighting.",
    "video": {
      "url": "https://example.com/source.mp4"
    },
    "duration": 6
  }'

查询状态

把实际任务 ID 替换到 /v1/videos/{request_id}：

curl https://quotarouter.ai/v1/videos/VIDEO_REQUEST_ID \
  -H "Authorization: Bearer YOUR_QUOTAAPI_KEY"

客户端应对处理中状态使用退避轮询，例如从 3 秒开始并逐步增加到 10 秒；收到 429 时遵循响应中的 Retry-After。完成后使用状态响应提供的地址，或调用受保护内容接口。

下载视频

curl -L https://quotarouter.ai/v1/videos/VIDEO_REQUEST_ID/content \
  -H "Authorization: Bearer YOUR_QUOTAAPI_KEY" \
  --output result.mp4

文档中的参数化路径分别是：

• GET /v1/videos/{request_id}
• GET /v1/videos/{request_id}/content

内容接口需要 API Key，不应把它当作公开永久链接。应用需要长期保存成品时，应在任务完成后下载到自己的存储。

端点总览

方法	路径	用途
POST	/v1/videos/generations	文生视频或图生视频
POST	/v1/videos/edits	按提示编辑已有视频
POST	/v1/videos/extensions	延长已有视频
GET	/v1/videos/{request_id}	查询任务状态
GET	/v1/videos/{request_id}/content	下载完成的视频

错误处理

状态码	含义
400	请求体、模型、时长、分辨率或媒体 URL 不合法
401	API Key 无效
403	分组未开启媒体生成或没有访问权限
404	分组不支持视频、任务不存在，或任务不属于当前 Key
429	触发用户、账号或媒体并发限制
503	当前没有可调度的 Grok 账号

模型、时长和分辨率以控制台当前能力为准，完整平台边界见兼容矩阵。