Grok Video 3

CokeAPI 接入 Grok Video 3 视频模型。默认是异步任务: POST 创建后拿到 task_id,再通过 GET /v1/generations/{task_id} 轮询直到 succeeded。

图生视频提示:生成接口不再接收内联 base64 图片数据。请先使用文件上传接口上传参考图片获取 URL,再传入 images。

模型 ID: grok-video-3

调用示例

curl https://cokeapi.com/v1/video/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video-3",
    "prompt": "一只金毛犬在草地上奔跑,阳光明媚",
    "seconds": "10",
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

curl https://cokeapi.com/v1/video/generations \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video-3",
    "prompt": "让这只狗动起来,在草地上奔跑",
    "images": ["https://cdn.cokeapi.com/uploads/2026/05/17/photo.png"],
    "seconds": "10",
    "resolution": "480p",
    "aspect_ratio": "16:9"
  }'

TASK_ID="01HX..."
curl https://cokeapi.com/v1/generations/$TASK_ID \
  -H "Authorization: Bearer sk-xxxxxxxx"

import httpx, time

BASE = "https://cokeapi.com/v1"
HEADERS = {"Authorization": "Bearer sk-xxxxxxxx"}

r = httpx.post(
    f"{BASE}/video/generations",
    headers=HEADERS,
    json={
        "model": "grok-video-3",
        "prompt": "一只金毛犬在草地上奔跑,阳光明媚",
        "seconds": "10",
        "resolution": "720p",
        "aspect_ratio": "16:9",
    },
    timeout=60,
)
task_id = r.json()["id"]

while True:
    r = httpx.get(f"{BASE}/generations/{task_id}", headers=HEADERS, timeout=30)
    data = r.json()
    if data["status"] in ("succeeded", "failed", "refunded"):
        print(data)
        break
    time.sleep(5)

import httpx

r = httpx.post(
    "https://cokeapi.com/v1/video/generations",
    headers={"Authorization": "Bearer sk-xxxxxxxx"},
    json={
        "model": "grok-video-3",
        "prompt": "让这只狗动起来,在草地上奔跑",
        "images": ["https://cdn.cokeapi.com/uploads/2026/05/17/photo.png"],
        "seconds": "10",
        "resolution": "480p",
        "aspect_ratio": "16:9",
    },
    timeout=60,
)
print(r.json())

const BASE = "https://cokeapi.com/v1";
const KEY = process.env.COKEAPI_KEY;

const create = await fetch(`${BASE}/video/generations`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "grok-video-3",
    prompt: "一只金毛犬在草地上奔跑,阳光明媚",
    seconds: "10",
    resolution: "720p",
    aspect_ratio: "16:9",
  }),
});
const { id: taskId } = await create.json();

while (true) {
  const poll = await fetch(`${BASE}/generations/${taskId}`, {
    headers: { "Authorization": `Bearer ${KEY}` },
  });
  const data = await poll.json();
  if (["succeeded", "failed", "refunded"].includes(data.status)) {
    console.log(data);
    break;
  }
  await new Promise((r) => setTimeout(r, 5000));
}

请求参数

参数	类型	必填	默认值	说明
model	string	是	`grok-video-3`	模型 ID
prompt	string	是	—	视频生成的文本描述
seconds	string	否	`"10"`	视频时长(秒),支持值: `"6"` / `"10"` / `"15"`
resolution	string	否	`"720p"`	视频分辨率,支持值: `480p` / `720p`
aspect_ratio	string	否	—	视频宽高比,支持值: `16:9` / `9:16` / `3:2` / `2:3` / `1:1`
images	string[]	否	—	用于图生视频的参考图像 URL 数组,最多 3 张

响应

创建任务 (`POST`)

{
  "id": "video_abc123def456",
  "task_id": "video_abc123def456",
  "object": "video.generation.task",
  "model": "grok-video-3",
  "status": "queued",
  "progress": 0,
  "created": 1768380224,
  "kind": "video",
  "mode": "text_to_video"
}

查询任务 (`GET /v1/generations/{task_id}`)

进行中:

{
  "id": "video_abc123def456",
  "task_id": "video_abc123def456",
  "object": "video.generation.task",
  "model": "grok-video-3",
  "status": "running",
  "progress": 45,
  "created": 1768380224,
  "kind": "video",
  "mode": "text_to_video"
}

完成后:

{
  "id": "video_abc123def456",
  "task_id": "video_abc123def456",
  "object": "video.generation.task",
  "model": "grok-video-3",
  "status": "succeeded",
  "progress": 100,
  "created": 1768380224,
  "kind": "video",
  "mode": "text_to_video",
  "result": {
    "id": "video_abc123def456",
    "object": "video.generation",
    "created": 1768380224,
    "model": "grok-video-3",
    "data": [
      {
        "url": "https://cdn.cokeapi.com/v/video_abc123def456.mp4",
        "duration_ms": 10000,
        "width": 1920,
        "height": 1080
      }
    ]
  }
}

任务状态说明

状态	说明
queued	任务已排队等待处理
running	任务正在处理中
succeeded	任务已完成
failed	任务失败
refunded	任务失败已退款

计费

按 6 秒基准档计费,超过 6 秒按 10 秒档计费(费用 = 基准价 × 10/6)。

分辨率	6 秒基准价	10 秒价
480p	$0.10	$0.167
720p	$0.10	$0.167

失败任务不计费,自动退款。价格为 2026-07 快照,以模型列表页实时价目为准。

注意事项

图生视频请先上传参考图 URL,再通过 images 传入
支持最多 3 张参考图进行图生视频
时长越长生成越慢,建议先用短时长测试效果
失败的任务不计费,会自动返还预扣点数

本页目录