Emix.ai 上的 Nano Banana 2 API 有哪些新特性？

`nano-banana-2` 支持长达 20,000 字符的提示词，最多 14 张参考图（支持 JPEG/PNG/WebP 格式，总大小 30 MB 内），14 种宽高比及 `auto`（自动）选项，并提供三种分辨率（`1K`、`2K`、`4K`）的 PNG 或 JPG 输出 —— 所有功能均可通过调用 `POST https://api.emix.ai/api/v1/client/tasks` 轻松实现。

Nano Banana 2 与上一代 Nano Banana 有何不同？

旧版模型 ID 为 `nano-banana`，新版 ID 为 `nano-banana-2`。Nano Banana 2 将提示词上限提升至 20,000 个字符，最多支持 14 张参考图，提供包含 `8:1`、`4:1` 和 `21:9` 在内的 14 种宽高比，并新增了 `4K` 分辨率选项。详情请参考上方参数表以及 docs.emix.ai/market/google/nanobanana2 的完整文档。

一次请求最多可以发送多少张参考图？

通过 `input.image_input` 最多可传入 14 张图像，总大小限制为 30 MB。支持 JPEG、PNG 和 WebP 格式。

Nano Banana 2 支持音频或口型同步吗？

不支持。Nano Banana 2 是一款图像生成模型（支持文生图以及基于参考图的图像编辑），无法生成音频或视频输出。

支持哪些分辨率和宽高比？

`input.resolution` 支持 `1K`、`2K` 或 `4K`（默认为 `1K`）。`input.aspect_ratio` 支持 `1:1`、`1:4`、`1:8`、`2:3`、`3:2`、`3:4`、`4:1`、`4:3`、`4:5`、`5:4`、`8:1`、`9:16`、`16:9`、`21:9` 或 `auto`（默认为 `auto`）。

API 支持哪些输出格式？

支持 `png` 或 `jpg`，可通过 `input.output_format` 设置（默认为 `jpg`）。

在正式接入前，我可以在哪里免费测试 Nano Banana 2？

您可以先在 emix.ai/models/nano-banana-2 体验网页端演示，随后前往 emix.ai/playground/nano-banana-2 测试全参数 Playground。Playground 中的每个字段都与 API 参数一一对应。

如何将 API 接入到我的应用中？

请向 `https://api.emix.ai/api/v1/client/tasks` 发送 `POST` 请求，并在请求头中添加 `Authorization: Bearer YOUR_API_KEY`，JSON 请求体需包含 `model: "nano-banana-2"` 以及您的 `input` 对象。API 将返回 `data.taskId`；您可以轮询“获取任务详情”接口，或设置 `callBackUrl` 通过 Webhook 接收结果。第 5 节提供了可直接运行的 cURL、Python 和 Node.js 示例代码。

使用费用是多少？

Nano Banana 2 的费用将直接从您的 Emix.ai 账户余额中扣除——如果收到 `402 insufficient credits` 响应，则说明您需要充值了。最新的计费标准发布在 Emix.ai 定价页面 (emix.ai/pricing) 以及 docs.emix.ai/market/google/nanobanana2。

我需要处理哪些状态码？

`200` 成功，`401` 未授权，`402` 余额不足，`404` 未找到，`422` 验证错误，`429` 触发限流，`433` 子密钥限制，`455` 服务不可用，`500` 服务器错误，`501` 生成失败，`505` 功能已禁用。

任务是同步执行的吗？

不是的——提交后会立即返回一个 `taskId`。您可以调用统一的“获取任务详情 (Get Task Details)”接口来获取最终生成的图像，或者通过您的 `callBackUrl` 接收 Webhook 结果推送。

README.md

Nano Banana 2 API — 在 Emix.ai 上生成 4K 图像，支持多达14张参考图

在 Emix.ai 上运行 Google 的 Nano Banana 2 (Gemini 3.1 Flash Image) API，将提示词（及最多14张参考图）转化为 1K、2K 或 4K 的清晰 PNG 或 JPG 图像。只需一个接口、一个 Bearer 密钥和一个异步 taskId。您可以在 Playground 中免费测试，然后将相同的请求代码直接部署到生产环境。现已在 Emix.ai 上线。请使用模型："nano-banana-2" 发送 POST 请求至 https://api.emix.ai/api/v1/client/tasks。完整参考文档请访问：docs.emix.ai/market/google/nanobanana2。

在 Playground 中试用阅读文档

发布及 API 可用性

Nano Banana 2 API 现已在 Emix.ai 正式上线。Nano Banana 2 是 Google 最新推出的文生图与图像编辑模型——以 Gemini 3.1 Flash Image 的形式发布。您可通过 Emix.ai 统一任务接口直接调用模型 ID nano-banana-2，其采用与 Emix.ai 目录中其他模型完全相同的 Bearer 认证、异步任务模式以及 Get Task Details 轮询流程——无需单独的 SDK，无需排队等待。如果您已拥有 Emix.ai 密钥，今天即可直接调用 nano-banana-2——无需修改任何集成代码。

厂商与模型 ID

厂商：Google。模型 ID：nano-banana-2。

接口与鉴权

接口：POST https://api.emix.ai/api/v1/client/tasks。鉴权：Authorization: Bearer YOUR_API_KEY。

处理方式

异步处理 — 请求将返回一个 taskId，您可以通过“获取任务详情”接口获取结果，或等待结果推送到您的 callBackUrl Webhook。

文档

docs.emix.ai/market/google/nanobanana2

Playground

emix.ai/playground/nano-banana-2

上线状态

现已在 Emix.ai 上线。现有的 Emix.ai 密钥今天即可直接调用 nano-banana-2，无需修改任何集成代码。

Nano Banana 2 API 核心功能

Emix.ai 上的 Nano Banana 2 API 通过单一 POST 请求全面开放了模型的全套图像生成能力。以下所有参数均由实时 API 严格执行。

文生图，支持参考图编辑

仅发送 input.prompt 即可实现纯文本生图；或者通过 input.image_input 附加最多 14 张参考图，用于图像编辑、风格迁移、保持角色一致性或多参考图合成。参考图文件总大小最高可达 30 MB，支持 JPEG、PNG 或 WebP 格式。

支持超长且富有表现力的提示词

input.prompt 最高支持 20,000 个字符——空间充裕，无论是详尽的场景说明、品牌指南，还是分镜列表，都能完整呈现，无需担心被截断。

14 种宽高比 + auto

支持在 1:1、1:4、1:8、2:3、3:2、3:4、4:1、4:3、4:5、5:4、8:1、9:16、16:9、21:9 或 auto（默认）中进行选择。无论是方形社交贴文、竖屏短视频、超宽横幅还是全景长图，均提供原生级支持。

三档分辨率选项

input.resolution 可设置为 1K、2K 或 4K（默认为 1K）。对于印刷输出、主视觉图和产品摄影，推荐选择 4K；若需生成缩略图或进行快速迭代，则推荐使用 1K。

PNG 或 JPG 格式输出

input.output_format 支持 png 或 jpg（默认 jpg）。PNG 适用于对透明度敏感的工作流和无损审查，JPG 适用于体积较小的交付物。

原生异步设计，支持 Webhook

提交任务后将立即返回 taskId，你可以通过轮询 Get Task Details (获取任务详情) 接口，或设置 callBackUrl 让 Emix.ai 将完成的任务通过 POST 推送至你的服务器。

可预测的错误码

401 未授权、402 额度不足、422 验证失败、429 速率限制、433 子密钥限制、455 服务不可用、500 服务器错误、501 生成失败、505 功能已禁用——可轻松映射到你的重试逻辑。

为什么选择在 Emix.ai 接入 Nano Banana 2 API

一个密钥，一个端点，调用所有模型

通过同一个 https://api.emix.ai/api/v1/client/tasks 路由即可运行 Nano Banana 2 及 Emix.ai 目录下的所有其他模型。只需更改一个字符串即可轻松切换模型。

内置异步任务与 Webhook

callBackUrl 是一等字段。无需编写额外的胶水代码，也无需搭建自定义队列。

免费的 Playground，轻松迭代提示词

在编写任何代码前，你可以在 emix.ai/playground/nano-banana-2 自由调整提示词、宽高比、分辨率和参考图——完全相同的参数将直接应用于 API 中。

公开透明的文档

所有参数、状态码及限制条件均已公开在 docs.emix.ai/market/google/nanobanana2。

基于额度的计费

单一账户余额即可调用 Nano Banana 2 及平台上的所有其他模型——无需为单个模型单独签约。

Nano Banana 2 API 与上一代对比

Emix.ai 上的上一代 Nano Banana 奠定了多参考图工作流的基础。如今，Nano Banana 2 进一步扩展了 API 实际支持的参数范围。升级路径仅需修改一行代码：将 "model": "nano-banana" 替换为 "model": "nano-banana-2"，即可立即使用更大的提示词窗口、更丰富的长宽比设置、4K 输出以及最多 14 张参考图。

快速入门

从灵感构思到生产环境调用，只需 4 步。

第 1 步 — 在线测试

打开模型页面 emix.ai/models/nano-banana-2，直接在浏览器中运行一次单次生成。该演示无需密钥。

第 2 步 — Playground

前往 Nano Banana 2 Playground (emix.ai/playground/nano-banana-2)，并排迭代调试提示词、aspect_ratio、resolution、output_format 以及参考图。Playground 中的每个控制项均与同名 API 字段 1:1 对应。

第 3 步 — 获取 API 访问权限

创建或登录您的 Emix.ai 账户，在控制台生成 API 密钥并确认您的账户余额。该密钥适用于 Emix.ai 模型库中的所有模型。

第 4 步 — 发送首个请求

使用 nano-banana-2 提交任务。API 将返回一个 taskId；请轮询“获取任务详情（Get Task Details）”接口或等待 callBackUrl Webhook 回调。cURL:bash

curl -X POST https://api.emix.ai/api/v1/client/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "callBackUrl": "https://your-domain.com/api/callback",
    "input": {
      "prompt": "Comic poster: cool banana hero in shades leaps from a sci-fi launch pad",
      "image_input": [],
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "output_format": "png"
    }
  }'

Python:python

import requests

resp = requests.post(
    "https://api.emix.ai/api/v1/client/tasks",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "nano-banana-2",
        "callBackUrl": "https://your-domain.com/api/callback",
        "input": {
            "prompt": "Editorial product shot of a ceramic mug on stone, soft window light",
            "image_input": [],
            "aspect_ratio": "4:5",
            "resolution": "4K",
            "output_format": "jpg",
        },
    },
)

task_id = resp.json()["data"]["taskId"]
print("taskId:", task_id)

Node.js:js

const res = await fetch("https://api.emix.ai/api/v1/client/tasks", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "nano-banana-2",
    callBackUrl: "https://your-domain.com/api/callback",
    input: {
      prompt: "Isometric icon set, 8 items, pastel palette, soft shadows",
      image_input: [],
      aspect_ratio: "1:1",
      resolution: "1K",
      output_format: "png",
    },
  }),
});

const { data } = await res.json();
console.log("taskId:", data.taskId);

成功提交后，将返回：json{ "code": 200, "msg": "success", "data": { "taskId": "string" } }使用该 taskId 调用统一的“获取任务详情（Get Task Details）”接口，即可获取最终生成的图像。

使用 Nano Banana 2 API 可以构建什么？

风格一致的品牌营销图像

传入 Logo、模特照片和色彩参考图（总计最多 14 张图片，30 MB），通过提示词让 Nano Banana 2 生成符合品牌调性的 4K 海报。

批量生成产品摄影图

针对商品目录和电商列表，可使用 2K–4K 分辨率的 4:5 或 1:1 比例；在需要进行设计评审时，可将 output_format 切换为 png，以获取清晰、无透明通道的交付文件。

竖屏短视频创意素材

9:16 比例（支持 1K 或 2K 分辨率）适用于 Reels、Shorts 和快拍，支持异步生成并通过 callBackUrl 交付结果。

超宽幅 Banner 与全景图

21:9、8:1 和 4:1 比例完美覆盖落地页主视觉、横幅广告以及电影级剧照。

基于参考图的角色与风格一致性

单次调用支持多达 14 张参考图，让您轻松锁定角色特征、环境背景和光影效果。

编辑类插画与漫画创作

高达 20,000 字符的提示词额度，足以容纳详尽的分镜脚本和镜头注释。

批量素材生成工作流

将数千个任务排入队列；当每张图片生成就绪时，通过 callBackUrl Webhook 即时通知您的存储工作节点（worker）。

Nano Banana 2 API

4.9/ 5

128 ratings

Tap a star to rate