YoYAI

主题

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

积分消耗说明 ​

图像张数模型清晰度消耗积分
1nano-banana/0.1
1nano-banana-pro1K/2K0.35
1nano-banana-pro4K0.85
1nano-banana-21K/2K0.23
1nano-banana-24K0.33

2025.10.13 更新： 目前nano-banana-pro和nano-banana-2只支持生成一张图片，如果生成多张图片很容易不出图，同时多张图片的速度比较慢，所以nano-banana-pro和nano-banana-2目前只允许生成一张图片！

基本使用 ​

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

json
{
  "action": "generate",
  "prompt": "小猫",
  "num_images": 1
}

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

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

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

json
{
    "success": true,
    "task_id": "b5c3503e-9768-46d7-add3-baa17122c8e5",
    "trace_id": "82d8254d-9cf3-40b0-8549-d999cfaa7d36",
    "data": {
        "image_urls": [
            "https://dkkj.s3.ap-east-1.amazonaws.com/ai/gemini/cb4ac531-341d-4424-8399-fec9ba201354.jpg"
        ]
    }
}

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

字段说明如下：

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

异步回调 ​

由于 Nano Banana 生成图像的时间相对较长，大约需要 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": "446344aa-b990-44bf-a136-366ba7937496",
    "trace_id": "7624d3c8-a0ee-4f5a-a1a7-a714c630ab21",
    "data": [
        {
            "id": "234c26e3118c40e0aa1782fc9b21e6b2",
            "video_url": "https://mountsea.oss-cn-hongkong.aliyuncs.com/veo3_videos/20250721_184004_234c26e3118c40e0aa1782fc9b21e6b2_standard.mp4",
            "created_at": "2025-07-21 10:38:38",
            "complete_at": "2025-07-21 10:39:58",
            "state": "succeeded"
        }
    ]
}

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