查询 Grok Imagine 视频任务

curl --request GET \
  --url https://xxx.wengaocloud.com/v1/grok-imagine/videos/generations/{id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://xxx.wengaocloud.com/v1/grok-imagine/videos/generations/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://xxx.wengaocloud.com/v1/grok-imagine/videos/generations/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xxx.wengaocloud.com/v1/grok-imagine/videos/generations/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "vidtask_87485721c5b54dc9a97467f8a1812b09",
  "object": "video.generation.task",
  "created": 1779782400,
  "created_at": 1779782400,
  "updated_at": 1779782420,
  "model": "grok-imagine-video-1.5-preview",
  "status": "running",
  "billing_status": "frozen"
}

查询 Grok Imagine 视频任务

curl --request GET \
  --url https://xxx.wengaocloud.com/v1/grok-imagine/videos/generations/{id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://xxx.wengaocloud.com/v1/grok-imagine/videos/generations/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://xxx.wengaocloud.com/v1/grok-imagine/videos/generations/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xxx.wengaocloud.com/v1/grok-imagine/videos/generations/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "vidtask_87485721c5b54dc9a97467f8a1812b09",
  "object": "video.generation.task",
  "created": 1779782400,
  "created_at": 1779782400,
  "updated_at": 1779782420,
  "model": "grok-imagine-video-1.5-preview",
  "status": "running",
  "billing_status": "frozen"
}

查询 Grok Imagine 异步视频任务的状态、生成结果和计费用量。

GET /v1/grok-imagine/videos/generations/{id}
Authorization: Bearer <API_KEY>

id 为创建 Grok Imagine 视频任务返回的任务 ID，格式通常以 vidtask_ 开头。

不要高频轮询。建议间隔 5–10 秒，最短不低于 3 秒。视频生成通常需要 30 秒至数分钟。

示例

curl "https://{your-domain}/v1/grok-imagine/videos/generations/vidtask_87485721c5b54dc9a97467f8a1812b09" \
  -H "Authorization: Bearer $API_KEY"

响应字段

字段	类型	说明
`id`	string	平台任务 ID。
`object`	string	固定为 `video.generation.task`。
`created`	integer	任务创建时间，Unix 秒。
`created_at`	integer	任务创建时间，Unix 秒。
`updated_at`	integer	任务状态最后更新时间，Unix 秒。
`model`	string	平台模型名称。
`status`	string	任务状态：`queued`、`running`、`succeeded`、`failed`、`cancelled`、`expired`。
`billing_status`	string	账务状态：`frozen`、`settling`、`settled`、`refunded`、`settle_failed`、`refund_failed`。
`content.video_url`	string	生成视频 URL，任务成功时返回。请及时下载和转存。
`content.video_url_expires_at`	string	视频 URL 过期时间，RFC3339 格式。
`error.code`	string	失败错误码。
`error.message`	string	失败说明。
`usage.billing_unit`	string	计费单位，Grok Imagine 为 `video_second`。
`usage.unit_name`	string	单位名称，通常为 `video_second`。
`usage.requested_units`	string	请求秒数，通常等于 `duration`。
`usage.billable_units`	string	对外结算单位数，通常为输出视频秒数。
`usage.billable_input_images`	string	存在时表示实际计费的输入图张数。
`usage.billable_output_seconds`	string	存在时表示实际计费的输出视频秒数。
`usage.input_charge_amount`	string	存在时表示输入图费用。
`usage.output_charge_amount`	string	存在时表示输出视频费用。
`usage.charge_amount`	string	存在时表示本次任务总费用。

响应示例

{
  "id": "vidtask_87485721c5b54dc9a97467f8a1812b09",
  "object": "video.generation.task",
  "created": 1779782400,
  "created_at": 1779782400,
  "updated_at": 1779782400,
  "model": "grok-imagine-video-1.5-preview",
  "status": "queued",
  "billing_status": "frozen"
}

{
  "id": "vidtask_87485721c5b54dc9a97467f8a1812b09",
  "object": "video.generation.task",
  "created": 1779782400,
  "created_at": 1779782400,
  "updated_at": 1779782488,
  "model": "grok-imagine-video-1.5-preview",
  "status": "succeeded",
  "billing_status": "settled",
  "duration": 6,
  "ratio": "16:9",
  "resolution": "720p",
  "content": {
    "video_url": "https://example.com/generated-video.mp4",
    "video_url_expires_at": "2026-07-17T12:00:00Z"
  },
  "usage": {
    "billing_unit": "video_second",
    "unit_name": "video_second",
    "requested_units": "6",
    "billable_units": "6",
    "billable_input_images": "1",
    "billable_output_seconds": "6",
    "input_charge_amount": "0.060000",
    "output_charge_amount": "5.040000",
    "charge_amount": "5.100000"
  }
}

{
  "id": "vidtask_87485721c5b54dc9a97467f8a1812b09",
  "object": "video.generation.task",
  "created": 1779782400,
  "created_at": 1779782400,
  "updated_at": 1779782488,
  "model": "grok-imagine-video-1.5-preview",
  "status": "failed",
  "billing_status": "refunded",
  "error": {
    "code": "failed",
    "message": "Failed to download the provided image. Ensure the image URL is publicly accessible."
  }
}

授权

Authorization

string

header

默认值:sk-your-api-key

必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

路径参数

string

必填

创建接口返回的任务 ID，格式通常以 vidtask_ 开头。

响应

Grok Imagine 视频任务状态与结果。

string

必填

示例:

"vidtask_3cb6299b32d24f93a82e8a74b3e06161"

object

enum<string>

必填

可用选项:

video.generation.task

status

enum<string>

必填

任务状态：queued（排队中）、running（运行中）、succeeded（成功）、 failed（失败）、cancelled（已取消）、expired（已超时）。

可用选项:

queued,

running,

succeeded,

failed,

cancelled,

expired

created

integer

任务创建时间，Unix 秒。

created_at

integer

任务创建时间，Unix 秒。

updated_at

integer

任务状态更新时间，Unix 秒。

model

string

billing_status

enum<string>

账务状态：frozen（已冻结）、settling（结算中）、settled（已结算）、 refunded（已退款）、settle_failed（结算失败）、refund_failed（退款失败）。

可用选项:

frozen,

settling,

settled,

refunded,

settle_failed,

refund_failed

content

object

视频生成结果，任务成功且存在视频地址时返回。

Hide child attributes

content.video_url

string

生成视频 URL，请及时下载和转存。

content.video_url_expires_at

string

视频 URL 过期时间，RFC3339 格式。

error

object

Hide child attributes

error.code

string

error.message

string

usage

object

用量信息，任务完成并完成用量统计后返回。Token 视频模型返回 token 字段；Grok Imagine 返回按秒计费字段。

Hide child attributes

usage.completion_tokens

integer

usage.total_tokens

integer

usage.billing_unit

string

计费单位，例如 video_second。

usage.unit_name

string

单位名称，例如 video_second。

usage.requested_units

请求单位数。Grok Imagine 中通常为请求的视频秒数。

usage.billable_units

实际结算单位数。Grok Imagine 中通常为输出视频秒数。

usage.billable_input_images

实际计费的输入图张数，存在时返回。

usage.billable_output_seconds

实际计费的输出视频秒数，存在时返回。

usage.input_charge_amount

输入图费用，存在时返回。

usage.output_charge_amount

输出视频费用，存在时返回。

usage.charge_amount

本次任务总费用，存在时返回。

seed

integer

resolution

string

ratio

string

duration

frames

integer

framespersecond

integer

generate_audio

boolean

service_tier

string

expires_at

integer

开始使用

API 参考

模型与计费

指南

参考

查询 Grok Imagine 视频任务

示例

响应字段

响应示例

授权

路径参数

响应

​示例

​响应字段

​响应示例

授权

路径参数

响应

示例

响应字段

响应示例