跳转到主要内容
POST
/
v1
/
predictions
curl --request POST \
  --url https://api.shuyou.ai/v1/predictions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine-video",
  "function": "video",
  "input": {
    "prompt": "A cinematic shot of a majestic lion in the savannah at golden hour",
    "aspect_ratio": "16:9",
    "resolution": "720P",
    "duration": 8
  }
}
'
{
  "data": {
    "task_id": "2c4d50261173430290971a2395a3b607",
    "task_status": "processing"
  }
}

​
概览

xAI Grok Imagine Video（grok-imagine-video）支持：
  • 文生视频 — prompt
  • 图生视频 — first_frame_url（建议 720p+，优先 16:9 或 9:16；其他比例可能被裁剪）
  • 参考图 — reference_image_urls 最多 3 张

​
输入参数

字段必填默认值说明
prompt是—视频描述文本
aspect_ratio否—1:1、16:9、9:16、4:3、3:4、3:2、2:3
resolution否—480P 或 720P
duration否81–15 秒
first_frame_url否—待动画化的图片 URL
reference_image_urls否[]参考图 URL，最多 3 张

授权

​
Authorization
string
header
必填

Authorization: Bearer YOUR_API_KEY

请求体

application/json
​
model
enum<string>
默认值:grok-imagine-video
必填

模型 ID。本接口使用 grok-imagine-video。

可用选项:
grok-imagine-video
示例:

"grok-imagine-video"

​
function
enum<string>
必填

任务类型。视频生成须为 video。

可用选项:
video
示例:

"video"

​
input
object
必填
​
webhook
string<uri>

可选。任务完成、失败或取消时的 HTTPS 回调地址。

响应

异步任务已创建

​
data
object
必填