--- title: nano-banana API — Nano Banana 定价与规格 | RunAPI description: 通过 RunAPI 使用 nano-banana——Nano Banana 系列。按次计费，包含模型 ID、规格参数和开发者接入指南。 url: https://runapi.ai/zh-CN/models/nano-banana/nano-banana.md canonical: https://runapi.ai/zh-CN/models/nano-banana/nano-banana locale: zh-CN site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/models/nano-banana/nano-banana zh-CN: https://runapi.ai/zh-CN/models/nano-banana/nano-banana es: https://runapi.ai/es/models/nano-banana/nano-banana ja: https://runapi.ai/ja/models/nano-banana/nano-banana de: https://runapi.ai/de/models/nano-banana/nano-banana fr: https://runapi.ai/fr/models/nano-banana/nano-banana pt-BR: https://runapi.ai/pt-BR/models/nano-banana/nano-banana ko: https://runapi.ai/ko/models/nano-banana/nano-banana it: https://runapi.ai/it/models/nano-banana/nano-banana nl: https://runapi.ai/nl/models/nano-banana/nano-banana pl: https://runapi.ai/pl/models/nano-banana/nano-banana tr: https://runapi.ai/tr/models/nano-banana/nano-banana zh-TW: https://runapi.ai/zh-TW/models/nano-banana/nano-banana zh-HK: https://runapi.ai/zh-HK/models/nano-banana/nano-banana ar: https://runapi.ai/ar/models/nano-banana/nano-banana x-default: https://runapi.ai/models/nano-banana/nano-banana model: Nano Banana provider: Google variant_id: nano-banana sdk_model_id: nano-banana modality: image price_from_cents: 3.12 billing_unit: 次调用 status: active --- > HTML version: https://runapi.ai/zh-CN/models/nano-banana/nano-banana > Site index for agents: https://runapi.ai/llms.txt # nano-banana API 通过 RunAPI 使用 Nano Banana 系列的 nano-banana。按次计费，无需订阅，失败的生成不计费。 **Google / [Nano Banana](https://runapi.ai/zh-CN/models/nano-banana.md)** **运行中 · image · 可商用** ## 体验 Nano Banana nano banana 选择任意模型，几秒内开始生成。 **模型:** - **文生图** — `text_to_image` · `nano-banana` · $0.03 / 张图片 · `aspect_ratio`: 1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto · `output_format`: png, jpeg, jpg **提示词:** 描述你想创建的内容…… **预计：** $0.03 / 张图片 - [生成](https://runapi.ai/zh-CN/login) 登录后即可使用 RunAPI 生成。 ### 切换变体 - **nano-banana** (current) - [nano-banana-2](https://runapi.ai/zh-CN/models/nano-banana/2.md) - [nano-banana-2-lite](https://runapi.ai/zh-CN/models/nano-banana/2-lite.md) - [nano-banana-edit](https://runapi.ai/zh-CN/models/nano-banana/edit.md) - [nano-banana-pro](https://runapi.ai/zh-CN/models/nano-banana/pro.md) 5 个版本可用 nano-banana 在 Nano Banana 家族中处于质量与成本的最佳平衡点。 - USD 按次定价 - 失败不计费 - 模型支持时流式 - 各模型的请求参数与能力限制 - 只需更改一个 model ID 参数即可切换 variant - 跨所有模型与提供方统一计费 ## 技术细节 | 字段 | 值 | |---|---| | 提供商 | Google | | 模型 ID | nano-banana | | 模态 | 图像 | | 任务类型 | Asynchronous | | API 端点 | [/api/v1/nano_banana/text_to_image](https://runapi.ai/zh-CN/docs/api/nano-banana/text-to-image) | | 计费单位 | 次调用 | | 输入参数 | aspect_ratio, output_format | | 宽高比 | 1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto | | 输出格式 | png, jpeg, jpg | | 目录状态 | 运行中 | **工作原理** ## 3 步使用此模型 1. **获取 API 密钥** - 免费注册后，在控制台创建用于 nano-banana 的 API 密钥。 2. **发送请求** - 向 /api/v1/nano_banana/text_to_image 发送 POST 请求，并传入 nano-banana 模型 ID 和参数。 3. **获取结果** - 轮询任务或按照回调获取已完成的 nano-banana 结果。 ## 该模型的核心能力 - **灵活的参数配置** — 可配置文档中列出的 2 个参数，包括 aspect_ratio, output_format。 - **Endpoint 覆盖** — 提供 1 个公开 endpoint：text_to_image。 - **按量计费** — 按 次调用 计量，无需订阅。 ## Nano Banana nano banana 定价 | 端点 | 分辨率 | 时长 | 价格 | |---|---|---|---| | `text_to_image` | 暂不可用 | 次调用 | $0.03 / 张图片 | **API 参考** ## 端点规格 | Field | Value | |---|---| | 端点 | `POST /api/v1/nano_banana/text_to_image` | | 模型 ID | `nano-banana` | | 任务类型 | `text_to_image` | | 最大时长 | `暂无数据` | | 分辨率 | `暂无数据` | | 宽高比 | `1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto` | | 输出格式 | `PNG, JPEG, JPG` | | 平均生成时间 | `暂无数据` | ## 请求参数 ### `aspect_ratio` **可选** · `value` 暂无描述。 (1:1, 9:16, 16:9, 3:4, 4:3, 3:2, 2:3, 5:4, 4:5, 21:9, auto) ### `output_format` **可选** · `value` 暂无描述。 (png, jpeg, jpg) **Request example** ```json { "model": "nano-banana", "prompt": "创建一张励志海报，粗体衬线字写上 'Never Give Up'，背景是日落山脉。" } ``` ### 模型 Skill — nano-banana 安装一次 skill，开发时使用本页的变体 ID。 ```sh npx skills add runapi-ai/nano-banana -g ``` ```text Install the Nano Banana skill for this app: 1. Add runapi-ai/nano-banana with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps with model ID nano-banana. 4. Confirm the install path when done. ``` ### 用 model skill 使用 nano-banana 1. **安装** — 安装该模型线对应的 model skill。 2. **配置** — 把 model 字段设置为本页展示的完整模型 ID。 3. **调用** — 按 skill 说明把提示词、输入文件和回调处理接入应用。 4. **接收** — 从 RunAPI 读取任务响应、webhook 回调或缓存输出 URL。 ### nano-banana 与其它变体的差异 - **VS NANO-BANANA-2: 1K 分辨率；快速基线版本（2025 年 8 月）** — 基于 Gemini 3.1 Flash；最佳多角色一致性，4–8 秒 - **VS NANO-BANANA-2-LITE: 1K 分辨率；快速基线版本（2025 年 8 月）** — 最快、成本最低的 Nano Banana 图像模型，适合快速生成与迭代 - **VS NANO-BANANA-EDIT: 1K 分辨率；快速基线版本（2025 年 8 月）** — 从现有图片进行提示词驱动的编辑 ## 应用场景 **产品摄影** 为缺少棚拍照片的电商商品自动生成场景化产品图。 **游戏与概念设计** 快速概念化环境和角色，再进入最终美术制作。 **编辑配图** 为博客文章和专栏批量生成独特封面图和插图。 ## Nano Banana nano banana 常见问题 ### 如何选择 nano-banana？ 传入 quickstart 中显示的模型 ID。 ### 该变体的限流？ Key 级限流随使用层级伸缩。当前限制见定价页。 ### 能切到其它变体吗？ 可以——变体只是参数，改 model 字段即可。 ### 支持流式吗？ 模型支持流式时，RunAPI 端到端流式。 ### 质量问题在哪里报？ 在公共 GitHub 仓库提 issue 或邮件联系 support。 ### 需要单独的提供方账户吗？ 不需要。你的 RunAPI API key 足以访问此 variant 以及目录中的所有其他模型，无需底层提供方账户。 ### 相关 - [nano-banana-2-lite](https://runapi.ai/zh-CN/models/nano-banana/2-lite.md) — 由 Google 提供 · $0.03 / 次调用 - [nano-banana-edit](https://runapi.ai/zh-CN/models/nano-banana/edit.md) — 由 Google 提供 · $0.03 / 次调用 - [nano-banana-2](https://runapi.ai/zh-CN/models/nano-banana/2.md) — 由 Google 提供 · $0.13 / 次调用 - [nano-banana-pro](https://runapi.ai/zh-CN/models/nano-banana/pro.md) — 由 Google 提供 · $0.19 / 次调用 ### 立即体验 Nano Banana。 - [免费注册](https://runapi.ai/zh-CN/login) - [阅读快速开始 →](https://runapi.ai/zh-CN/docs/api/nano-banana/text-to-image) ## 需要团队接入支持？ 我们可以协助团队接入、完成系统集成并解答技术问题。 [联系我们](https://runapi.ai/zh-CN/contact.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-CN/.md) ### 产品 - [模型目录](https://runapi.ai/zh-CN/models.md) - [定价](https://runapi.ai/zh-CN/pricing.md) - [提供方](https://runapi.ai/zh-CN/models#all-models) ### 开发者 - [文档](https://runapi.ai/zh-CN/docs/guides) - [SDK](https://runapi.ai/zh-CN/sdk.md) - [CLI](https://runapi.ai/zh-CN/cli.md) - [MCP Server](https://runapi.ai/zh-CN/mcp.md) - [x402](https://runapi.ai/zh-CN/x402.md) ### 指南 - [Claude Code 与 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md) - [Cursor API 设置](https://runapi.ai/zh-CN/cursor-api-setup.md) - [RunAPI 与 OpenRouter](https://runapi.ai/zh-CN/openrouter-alternative.md) ### 公司 - [企业版](https://runapi.ai/zh-CN/contact.md) - [联系](https://runapi.ai/zh-CN/contact.md) ### 法律 - [服务条款](https://runapi.ai/zh-CN/terms.md) - [隐私政策](https://runapi.ai/zh-CN/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-CNicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "SoftwareApplication", "name": "Nano Banana nano-banana", "applicationCategory": "DeveloperApplication", "offers": { "@type": "Offer", "price": "0.0312", "priceCurrency": "USD", "priceSpecification": { "@type": "UnitPriceSpecification", "unitText": "次调用" } } }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://runapi.ai/zh-CN" }, { "@type": "ListItem", "position": 2, "name": "Models", "item": "https://runapi.ai/zh-CN/models" }, { "@type": "ListItem", "position": 3, "name": "Nano Banana", "item": "https://runapi.ai/zh-CN/models/nano-banana" }, { "@type": "ListItem", "position": 4, "name": "nano-banana", "item": "https://runapi.ai/zh-CN/models/nano-banana/nano-banana" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "HowTo", "name": "用 model skill 使用 nano-banana", "description": "通过 RunAPI 使用 nano-banana——Nano Banana 系列。按次计费，包含模型 ID、规格参数和开发者接入指南。", "totalTime": "PT5M", "step": [ { "@type": "HowToStep", "position": 1, "name": "安装", "text": "安装该模型线对应的 model skill。", "url": "https://runapi.ai/zh-CN/models/nano-banana/nano-banana#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "配置", "text": "把 model 字段设置为本页展示的完整模型 ID。", "url": "https://runapi.ai/zh-CN/models/nano-banana/nano-banana#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "调用", "text": "按 skill 说明把提示词、输入文件和回调处理接入应用。", "url": "https://runapi.ai/zh-CN/models/nano-banana/nano-banana#how-step-3" }, { "@type": "HowToStep", "position": 4, "name": "接收", "text": "从 RunAPI 读取任务响应、webhook 回调或缓存输出 URL。", "url": "https://runapi.ai/zh-CN/models/nano-banana/nano-banana#how-step-4" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "如何选择 nano-banana？", "acceptedAnswer": { "@type": "Answer", "text": "传入 quickstart 中显示的模型 ID。" } }, { "@type": "Question", "name": "该变体的限流？", "acceptedAnswer": { "@type": "Answer", "text": "Key 级限流随使用层级伸缩。当前限制见定价页。" } }, { "@type": "Question", "name": "能切到其它变体吗？", "acceptedAnswer": { "@type": "Answer", "text": "可以——变体只是参数，改 model 字段即可。" } }, { "@type": "Question", "name": "支持流式吗？", "acceptedAnswer": { "@type": "Answer", "text": "模型支持流式时，RunAPI 端到端流式。" } }, { "@type": "Question", "name": "质量问题在哪里报？", "acceptedAnswer": { "@type": "Answer", "text": "在公共 GitHub 仓库提 issue 或邮件联系 support。" } }, { "@type": "Question", "name": "需要单独的提供方账户吗？", "acceptedAnswer": { "@type": "Answer", "text": "不需要。你的 RunAPI API key 足以访问此 variant 以及目录中的所有其他模型，无需底层提供方账户。" } } ] } ] ```