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% 增值税专用发票时，才需按照“税后价格”进行结算。

积分消耗说明 ​

模型消耗积分
grok-imagine-image0.24

基本使用 ​

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

json
{
  "prompt": "a cute cat sitting on a windowsill.",
  "model": "grok-imagine-image",
  "aspect_ratio": "2:3"
}

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

  • action 生成图像的行为参数，主要包含生成图像（包含了文生图和图生图俩种生成）generate，以及编辑图像edit，默认是生成图片。
  • prompt：生成图像的提示词。
  • image_urls：当图像任务是编辑图像时，该值是必填参数，它是编辑的图片链接数组。

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

json
{
    "success": true,
    "task_id": "a88d999b-61a1-495f-847a-9e945f2e1b5d",
    "trace_id": "92e447c4-a92a-4e4d-966a-e5c92260f5db",
    "data": {
        "image_urls": [
            "https://cdn.sunohub.cn/grok/1add47a7-c368-4d9e-9a6b-56aab79d0b68.jpg",
            "https://cdn.sunohub.cn/grok/c7a23822-fc38-43a7-a0be-dbc3dc4ee236.jpg"
        ]
    }
}

可以看到这时候我们就得到了根据提示词生成图像的内容。

字段说明如下：

  • success：生成是否成功，如果成功则为 true，否则为 false
  • data：是一个列表，包含了生成的图像的详细信息。
    • image_urls：生成的图像链接数组

异步回调 ​

由于 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": "a88d999b-61a1-495f-847a-9e945f2e1b5d",
    "trace_id": "92e447c4-a92a-4e4d-966a-e5c92260f5db",
    "data": {
        "image_urls": [
            "https://cdn.sunohub.cn/grok/1add47a7-c368-4d9e-9a6b-56aab79d0b68.jpg",
            "https://cdn.sunohub.cn/grok/c7a23822-fc38-43a7-a0be-dbc3dc4ee236.jpg"
        ]
    }
}

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