APIOK 文档

Appearance

grok-imagine-video 接口文档 ​

支持的模型 ​

  • grok-imagine-video

grok-imagine-video是视频生成模型，支持单图和多张参考图

流程 ​

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

1. 请求生成视频任务 ​

  • image_url: 参考图 url / base64-encoded data URI
  • duration： 时长 <=10s
  • reference_images <=7张

示例 ​

请求 ​

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",
    "reference_images": [
      {"url": "<IMAGE_URL_1>"},
      {"url": "<IMAGE_URL_2>"},
      {"url": "<IMAGE_URL_3>"}
    ],
    "duration": 5，
    "aspect_ratio": "16:9",
    "resolution": "720p"
}'

返回 ​

json
{
    "id": "task_U1ZEB5fbEtdSUpYFtKmX1yDnv0QffXbK",
    "task_id": "task_U1ZEB5fbEtdSUpYFtKmX1yDnv0QffXbK",
    "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_U1ZEB5fbEtdSUpYFtKmX1yDnv0QffXbK",
    "object": "video",
    "model": "grok-imagine-video",
    "status": "completed",
    "progress": 100,
    "created_at": 1784876797,
    "completed_at": 1784876850,
    "seconds": "5",
    "metadata": {
        "url": "https://apiok.cc/v1/videos/task_U1ZEB5fbEtdSUpYFtKmX1yDnv0QffXbK/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 '{}