视频生成
兼容 OpenAI Videos。视频生成是异步任务:提交 → 查询 → 下载。
| 模型 | 令牌分组 | 支持的输入 |
|---|---|---|
grok-imagine-video-1.5 | grok | 文生视频、图生视频、多图参考(最多 14 张)、首尾帧 |
grok-imagine-video-1.5-lite | grok | 文生视频、图生视频 |
鉴权
Authorization: Bearer <令牌>
提交任务
POST
https://api.codingrouter.ai/v1/videos请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 见上表 |
prompt | string | 是 | 视频描述 |
seconds | integer | 否 | 时长,1 到 15,默认 1 |
resolution | string | 否 | 480p(默认)、720p、1080p |
image | file | 否 | 参考图,表单上传;一张为图生视频,多张为多图参考 |
first_frame、last_frame | file | 否 | 首帧和尾帧,需同时上传,仅 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.pngbash
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
}查询任务
GET
https://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 分钟完成。
下载视频
GET
https://api.codingrouter.ai/v1/videos/{id}/contentbash
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)的请求不扣费。
