YoYAI

主题

Grok 视频生成 API 对接说明 ​

YoYAI 套餐明细（企业商业合作请联系邮箱：support@yoy-ai.com） ​

套餐等级积分总量优惠价格 (税前)税后价格 (加5.3%)折扣力度
基础版100¥98.0¥1039.8折
白银版540¥520.0¥5489.629折
黄金版1,120¥1050.0¥1,1069.375折
铂金版6,000¥5,450.00¥5,7399.083折
钻石版13,000¥11,400.00¥12,0048.769折
尊享版25,200¥21,550.00¥22,6928.551折
旗舰版68,000¥55,800.00¥58,7578.206折
至尊版143,000¥114,400.00¥120,4638.0折

注：只有在要求开具 6% 增值税专用发票时，才需按照“税后价格”进行结算。

积分消耗说明 ​

模型分辨率时长 (Duration)扣费积分
grok-imagine-video480P60.35
grok-imagine-video480P100.42
grok-imagine-video480P150.50
grok-imagine-video720P60.50
grok-imagine-video720P100.57
grok-imagine-video720P150.65

(注：如果时长未匹配到 6、10 或 15，480P 的默认扣费为 0.35，720P 的默认扣费为 0.50)

基本使用 ​

想些什么视频，可以任意输入一段文字，比如我想生成一个关于猫的视频，就可以输入 小猫在游泳，下面使用apifox进行发送请求，具体的参数如下所示：

json
{
  "prompt": "小猫在游泳.",
  "model": "grok-imagine-video",
  "duration": 6,
  "aspect_ratio": "2:3",
  "resolution": "720P"
}

传入参数的字段说明如下：

  • prompt：生成视频的提示词。
  • model：视频模型的类别，主要包含了grok-imagine-video、,默认是grok-imagine-video。
  • image_urls：当视频任务是图生视频时，该值是必填参数，它是首尾帧的图片链接数组。

可以点击测试按钮直接测试 API，稍等 1-2 分钟，结果如下：

json
{
    "success": true,
    "task_id": "6240d93a-d8d2-449b-b2ff-51e121c4cffa",
    "trace_id": "f3f264af-6ff7-4361-b99f-80ed65e03628",
    "data": [
        {
            "id": "xai-9c702505-630d-4369-a3b4-76b2e785c4d5",
            "video_url": "https://cdn.sunohub.cn/suno/6240d93a-d8d2-449b-b2ff-51e121c4cffa.mp4",
            "created_at": "2026-03-16T16:08:54.309Z",
            "complete_at": "2026-03-16T16:10:05.042Z",
            "state": "succeeded"
        }
    ]
}

可以看到这时候我们就得到了视频结果。

字段说明如下：

  • success：生成是否成功，如果成功则为 true，否则为 false
  • data：是一个列表，包含了生成的视频的详细信息。
    • state： 视频生成状态，主要包含四种，具体的如下：
      • succeeded：生成成功
      • running：执行中
      • error：失败
    • id：视频 ID
    • complete_at：视频任务完成的时间
    • video_url：视频的视频文件，打开就是一个 mp4 视频。
    • created_at：创建的时间

异步回调 ​

由于 Grok 生成视频的时间相对较长，大约需要 1-2 分钟，如果 API 长时间无响应，HTTP 请求会一直保持连接，导致额外的系统资源消耗，所以本 API 也提供了异步回调的支持。

整体流程是：客户端发起请求的时候，额外指定一个 callback_url 字段，客户端发起 API 请求之后，API 会立马返回一个结果，包含一个 task_id 的字段信息，代表当前的任务 ID。当任务完成之后，生成音乐的结果会通过 POST JSON 的形式发送到客户端指定的 callback_url，其中也包括了 task_id 字段，这样任务结果就可以通过 ID 关联起来了。

下面我们通过示例来了解下具体怎样操作。

首先，Webhook 回调是一个可以接收 HTTP 请求的服务，开发者应该替换为自己搭建的 HTTP 服务器的 URL。此处为了方便演示，使用一个公开的 Webhook 样例网站 https://webhook.site/，打开该网站即可得到一个 Webhook URL，如图所示：

将此 URL 复制下来，就可以作为 Webhook 来使用，此处的样例为 https://webhook.site/03e60575-3d96-4132-b681-b713d78116e2。

接下来，我们可以设置字段 callback_url 为上述 Webhook URL，同时填入 prompt，如图所示：

点击运行，可以发现会立即得到一个结果，如下：

{
  "task_id": "446344aa-b990-44bf-a136-366ba7937496"
}

稍等片刻，我们可以在 https://webhook.site/03e60575-3d96-4132-b681-b713d78116e2 上观察到生成歌曲的结果，如图所示：

内容如下：

json
{
    "success": true,
    "task_id": "6240d93a-d8d2-449b-b2ff-51e121c4cffa",
    "trace_id": "f3f264af-6ff7-4361-b99f-80ed65e03628",
    "data": [
        {
            "id": "xai-9c702505-630d-4369-a3b4-76b2e785c4d5",
            "video_url": "https://cdn.sunohub.cn/suno/6240d93a-d8d2-449b-b2ff-51e121c4cffa.mp4",
            "created_at": "2026-03-16T16:08:54.309Z",
            "complete_at": "2026-03-16T16:10:05.042Z",
            "state": "succeeded"
        }
    ]
}

可以看到结果中有一个 task_id 字段，其他的字段都和上文类似，通过该字段即可实现任务的关联。