Skip to content

视频生成 ​

兼容 OpenAI Videos。视频生成是异步任务:提交 → 查询 → 下载。

模型令牌分组支持的输入
grok-imagine-video-1.5grok文生视频、图生视频、多图参考(最多 14 张)、首尾帧
grok-imagine-video-1.5-litegrok文生视频、图生视频

鉴权 ​

Authorization: Bearer <令牌>

提交任务 ​

POSThttps://api.codingrouter.ai/v1/videos

请求参数 ​

参数类型必填说明
modelstring是见上表
promptstring是视频描述
secondsinteger否时长,1 到 15,默认 1
resolutionstring否480p(默认)、720p、1080p
imagefile否参考图,表单上传;一张为图生视频,多张为多图参考
first_frame、last_framefile否首帧和尾帧,需同时上传,仅 grok-imagine-video-1.5
  • 有图片时用 multipart/form-data 上传文件;JSON 里的图片 URL 或 base64 会被拒绝。
  • 多图参考和首尾帧不支持 1080p。

请求示例 ​

bash
curl https://api.codingrouter.ai/v1/videos \
  -H "Authorization: Bearer $CODINGROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "海边日落,镜头缓慢推近,浪花拍打礁石",
    "seconds": 6,
    "resolution": "720p"
  }'
bash
curl https://api.codingrouter.ai/v1/videos \
  -H "Authorization: Bearer $CODINGROUTER_KEY" \
  -F model=grok-imagine-video-1.5-lite \
  -F prompt="让画面里的人物转身微笑" \
  -F seconds=6 \
  -F image=@first.png
bash
curl https://api.codingrouter.ai/v1/videos \
  -H "Authorization: Bearer $CODINGROUTER_KEY" \
  -F model=grok-imagine-video-1.5 \
  -F prompt="从白天平滑过渡到夜晚" \
  -F seconds=8 \
  -F first_frame=@day.png \
  -F last_frame=@night.png

响应 ​

json
{
  "id": "task_3FnXIsT7uKTvi5r8LFiEDarfYKd1rcGu",
  "object": "video",
  "model": "grok-imagine-video-1.5-lite",
  "status": "queued",
  "progress": 0,
  "created_at": 1794806577
}

查询任务 ​

GEThttps://api.codingrouter.ai/v1/videos/{id}
bash
curl https://api.codingrouter.ai/v1/videos/task_3FnXIsT7uKTvi5r8LFiEDarfYKd1rcGu \
  -H "Authorization: Bearer $CODINGROUTER_KEY"
json
{
  "id": "task_3FnXIsT7uKTvi5r8LFiEDarfYKd1rcGu",
  "object": "video",
  "model": "grok-imagine-video-1.5-lite",
  "status": "completed",
  "progress": 100,
  "seconds": 1,
  "resolution": "480p",
  "created_at": 1794806577,
  "completed_at": 1794806621,
  "content_url": "/v1/videos/task_3FnXIsT7uKTvi5r8LFiEDarfYKd1rcGu/content"
}

status 依次为 queued → in_progress → completed,失败时为 failed。建议每 5 到 10 秒查询一次,通常 20 秒到 1 分钟完成。

下载视频 ​

GEThttps://api.codingrouter.ai/v1/videos/{id}/content
bash
curl -L https://api.codingrouter.ai/v1/videos/task_3FnXIsT7uKTvi5r8LFiEDarfYKd1rcGu/content \
  -H "Authorization: Bearer $CODINGROUTER_KEY" \
  -o out.mp4

返回 video/mp4 文件。

完整示例(Python) ​

python
import time
import httpx

BASE = "https://api.codingrouter.ai"
headers = {"Authorization": "Bearer sk-你的令牌"}

with httpx.Client(base_url=BASE, headers=headers, timeout=120) as client:
    task = client.post("/v1/videos", json={
        "model": "grok-imagine-video-1.5-lite",
        "prompt": "海边日落,镜头缓慢推近",
        "seconds": 6,
        "resolution": "480p",
    }).json()

    while True:
        time.sleep(8)
        task = client.get(f"/v1/videos/{task['id']}").json()
        if task["status"] in ("completed", "failed"):
            break

    if task["status"] == "completed":
        video = client.get(f"/v1/videos/{task['id']}/content", follow_redirects=True)
        open("out.mp4", "wb").write(video.content)

计费 ​

按生成的秒数和分辨率计费,单价见 模型广场。参数校验失败(400)的请求不扣费。