Skip to content

grok-imagine-video-1.5 接口文档

支持的模型

  • grok-imagine-video-1.5

grok-imagine-video-1.5是视频生成模型,只支持单图

流程

  1. 请求生成视频任务
  2. 查询视频生成进度
  3. 获取生成的视频

1. 请求生成视频任务

  • image_url: 参考图 url / base64-encoded data URI
  • duration: 时长 <=15s

示例

请求

bash
curl 'https://apiok.cc/v1/videos' \
-H "Authorization: Bearer $APIKEY" \
-H 'Content-Type: application/json' \
-d '{
    "prompt": "Generate a slow and serene time-lapse",
    "model": "grok-imagine-video-1.5",
    "image": "https://docs.x.ai/assets/api-examples/video/milkyway-still.png",
    "duration": 5
}'

返回

json
{
    "id": "task_Xo9GVEE6qfzRaLsd69mEjelKMydlg7QS",
    "task_id": "task_Xo9GVEE6qfzRaLsd69mEjelKMydlg7QS",
    "object": "",
    "model": "",
    "status": "",
    "progress": 0,
    "created_at": 0,
    "usage": {
        "completion_tokens": 0,
        "total_tokens": 0
    }
}

2. 查询视频生成进度

  • status: completed-完成 queued-排队 in_progress/pennding-进行中 failed-失败
  • progress: 进度百分比
  • URI中taskId 来自生成视频返回的taskId

示例

请求

bash
curl --location --request GET 'https://apiok.cc/v1/videos/task_Xo9GVEE6qfzRaLsd69mEjelKMydlg7QS' \
--header 'Authorization: $APIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回

json
{
    "id": "task_Xo9GVEE6qfzRaLsd69mEjelKMydlg7QS",
    "object": "video",
    "model": "grok-imagine-video-1.5",
    "status": "completed",
    "progress": 100,
    "created_at": 1784875061,
    "completed_at": 1784875095,
    "seconds": "5",
    "metadata": {
        "url": "https://apiok.cc/v1/videos/task_Xo9GVEE6qfzRaLsd69mEjelKMydlg7QS/content"
    }
}

3. 获取生成的视频

  • url: 来自查询进度时候,返回的metadata.url

示例

bash
curl --location --request GET 'https://apiok.cc/v1/videos/task_Xo9GVEE6qfzRaLsd69mEjelKMydlg7QS/content' \
--header 'Authorization: $APIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{}