Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.xcompute.us/llms.txt

Use this file to discover all available pages before exploring further.

这份文档聚焦 grok-imagine-1.0-video-apimart。如果你要在 Xcompute 中单独接入 Grok 视频，可以从这里开始。
你会用到 2 个核心接口：
  • 提交生成任务：POST /v1/videos/generations
  • 查询任务状态：GET /v1/tasks/{task_id}
详细字段定义见 Grok Imagine 1.0 视频生成 和 获取任务状态。

​
接入前准备

项目值
Base URLhttps://xcompute.us
模型名grok-imagine-1.0-video-apimart
认证方式Authorization: Bearer YOUR_API_KEY
请求格式Content-Type: application/json

​
第一步：创建视频任务

curl --request POST \
  --url https://xcompute.us/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-1.0-video-apimart",
    "prompt": "一只狗在海滩上奔跑，阳光明媚，慢镜头",
    "size": "16:9",
    "duration": 6,
    "quality": "720p"
  }'

​
常用参数

参数类型是否必填说明
modelstring是固定填写 grok-imagine-1.0-video-apimart
promptstring是视频内容描述，支持中英文
sizestring否视频比例，常用值如 16:9、9:16、1:1
durationinteger否视频时长，常见值为 6 到 30
qualitystring否输出质量，常见值为 480p、720p
image_urlsarray<string>否图生视频参考图 URL，需为公网可访问地址
duration 需要传纯数字。不要写成字符串。

​
第二步：查询任务状态

提交成功后，保存返回的任务 ID，然后轮询任务状态接口。 
curl --request GET \
  --url 'https://xcompute.us/v1/tasks/YOUR_TASK_ID?language=zh' \
  --header 'Authorization: Bearer YOUR_API_KEY'
推荐处理流程：
  1. 提交生成请求。
  2. 记录返回的任务 ID。
  3. 每隔几秒查询一次任务状态。
  4. 当任务状态变为 completed 后，读取最终视频地址。
如果你传入参考图，建议先确认图片 URL 可直接访问。这样更容易避免任务提交失败。

​
什么时候看详细 API 参考

如果你需要这些内容，直接进入 API 参考页：
  • 更完整的请求字段定义
  • 多语言示例代码
  • 响应结构说明
  • 任务状态字段说明

Grok 视频 API 参考

查看 Grok 视频生成接口的完整参数、请求示例和响应结构。

任务状态查询

查看异步任务查询接口的状态字段、结果结构和语言参数说明。