Documentation Index
Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
Use this file to discover all available pages before exploring further.
🔥 最新发布：谷歌于 2026年2月26日发布了 Nano Banana 2 (
gemini-3.1-flash-image-preview)，Pro 级画质 + Flash 级速度，按量低至 $0.025/张！查看 Nano Banana 2 文档🆕 2026年5月29日更新（去掉
-preview）：谷歌更新了官方文档，推出去掉 -preview 的正式模型名 gemini-3-pro-image，API易已同步上线支持。- 原模型名仍可用：
gemini-3-pro-image-preview继续正常调用，价格不变，现有代码无需改动。 - 两个名字都能跑：可按需选用新名
gemini-3-pro-image或原-preview名。
最新版本
- Nano Banana 2：
gemini-3.1-flash-image-preview（🔥 2026年2月26日上线）— 查看详情 - Nano Banana Pro：
gemini-3-pro-image-preview（2025年11月20日上线）
前代版本
- 正式版：
gemini-2.5-flash-image（稳定版，支持 10 种宽高比） - 预览版：
gemini-2.5-flash-image-preview（⚠️ 已于2025年10月30日下线）
📚 最新文档
飞书完整使用指南 - 更新最快，支持评论互动访问飞书文档获取最新的使用教程、技巧分享和问题解答。文档持续更新，遇到问题可直接在飞书上评论交流。
核心优势
-
🔥 Nano Banana Pro 新特性：
- 🎯 4K 高清支持：支持 1K、2K、4K 三种分辨率，最高可达 4096×4096
- 📝 文本渲染之王：图像中的文字清晰可读，适合海报、广告等场景
- ✨ 局部编辑：支持摄像机角度、焦点、色彩分级、场景照明调整
- 🧠 智能推理：基于 Gemini 3 Pro，更好地理解复杂提示词
-
🚀 通用优势：
- ⚡ 生成速度：Nano Banana Pro 约 20 秒，前代版本约 10 秒
- 💰 价格实惠：结合充值优惠，性价比极高
- 🔄 完全兼容：完全兼容谷歌官方 Gemini API 格式
- 🎨 谷歌技术：基于谷歌最新、最强的图像生成/编辑技术
在线调试 API
文生图 API
输入文本提示词生成图片，带交互式 Playground 在线调试。
图片编辑 API
上传图片 + 编辑指令生成新图片，带交互式 Playground 在线调试。
为什么选 API易 的 Nano Banana Pro
Nano Banana Pro / 2 是 API易 消耗量排名第一的图像模型——稳定、可靠、速度快。如果你期望跟专业的团队合作，那选 API易 就对了。 针对 Nano Banana Pro 这种谷歌最新旗舰、内容安全管控严格的模型，API易 在稳定性、成本、接入体验三方面做了深度优化：官方通道 · 与 Gemini 一致
完全兼容谷歌官方 Gemini API 格式（
/v1beta/models/.../generateContent），同时支持 OpenAI SDK 模式，请求体、响应字段、错误码与官方一致，迁移零改造。不限并发 · 企业可放量
无谷歌 AI Studio 的 RPM/RPD 硬限制，企业批量出图、高峰流量都能线性放大，避免被官方配额打断。
官网 31-38% 价格
按次 $0.09/张（官方 4K $0.24），叠加 充值加赠活动 最低可达官方 31.25%——4K 场景最多省 68.75%。
全球零门槛接入
无需海外服务器或代理，国内机房、家宽网络、海外节点均可直连
api.apiyi.com，延迟稳定、免去出海改造。模型生态齐全
同系列覆盖 Nano Banana 2（性价比 + Flash 速度）、Nano Banana Pro（极致画质）、Nano Banana 第一代（基础版），按场景自由组合。
专业服务 · 企业陪跑
团队深耕图像生成场景，具备丰富的选型、调优与集成经验，可为企业客户提供从 PoC 到生产上线的完整技术支持。
调用方式
使用谷歌原生 Gemini API 格式调用：不支持的功能
价格对比
| 模型 | 定价 | 优势 |
|---|---|---|
| Nano Banana Pro (4K) | $0.09/张（约¥0.52） | 🔥 4K 支持，约官方 38% |
| Nano Banana Pro (1K-2K) | $0.09/张（约¥0.52） | 🔥 高清出图，约官方 67% |
| Nano Banana | $0.025/张（约¥0.15） | ⭐ 快速生成，官方 52% |
| gpt-image-1 | 较高 | - |
| flux-kontext-pro | $0.035/张 | 持平 |
分组介绍
Nano Banana Pro 在 API易提供两个分组，可在后台「令牌设置」中切换：| 分组 | 倍率 | 适用场景 |
|---|---|---|
Default 默认分组 | 1.0x | 基础通道，按次 $0.09/张；默认推荐 |
NanoBananaEnterprise 企业分组 | 1.4x | 兜底通道，按次 $0.126/张，默认紧张/超时高发时手动切换，稳定优先 |
NanoBananaEnterprise 即可临时过渡。
令牌「计费模式」推荐：选 按量优先（Pay-as-you-go Priority）—— 同时兼容 Nano Banana Pro 的按次计费 和 Nano Banana 2 的按量计费，一把令牌跑全系列。
兼容性说明
如果你之前使用过以下模型，可以直接替换模型名称：升级到最新版本
- 任何旧版本 →
gemini-3-pro-image-preview（🔥 推荐，Nano Banana Pro）- 支持 4K 高清出图
- 文本渲染能力最强
- 局部编辑功能
使用稳定版本
gpt-4o-image→gemini-2.5-flash-imagesora_image→gemini-2.5-flash-image- 旧版 Nano Banana →
gemini-2.5-flash-image
API 错误处理指南
Nano Banana Pro 有严格的内容安全管控，可能在多个层级拒绝不合规请求。candidatesTokenCount
最高优先级值为 0 时，内容在审核阶段被拒绝，未生成任何候选内容。
finishReason
次要优先级值非
STOP（如 PROHIBITED_CONTENT、SAFETY）时，表示生成过程中被拒绝。API 文本响应
拒绝说明API 返回拒绝说明文本而非图片数据时，应将这些说明展示给用户。
完整错误处理文档详细错误处理流程、代码实现示例和最佳实践，请访问：
https://xinqikeji.feishu.cn/wiki/Rslqw724YiBwlokHmRLcMVKHnRfFAQ
应该选择 Nano Banana 2 还是 Pro？
应该选择 Nano Banana 2 还是 Pro？
追求性价比推荐 Nano Banana 2 (
gemini-3.1-flash-image-preview)：- Pro 级画质 + Flash 级速度
- 按量计费低至 $0.025/张
- 支持 14 种宽高比（比 Pro 多 4 种）
- 独有：思维模式、图片搜索 Grounding
gemini-3-pro-image-preview)：- 最高保真度
- 定价 $0.09/次
应该选择 Pro 版本还是前代版本？
应该选择 Pro 版本还是前代版本？
新项目推荐：Nano Banana Pro (
gemini-3-pro-image-preview)✅ Pro 版优势：- 支持 4K 超高清分辨率
- 业界最佳文本渲染质量
- 高级局部编辑功能
- 定价仅约官方 38-67%
gemini-2.5-flash-image) 适合：- 预算敏感场景（约$0.025/张 vs $0.09/张）
- 需要快速生成（10s vs 20s）
- 现有项目迁移
如何从其他图像模型切换到 Nano Banana？
如何从其他图像模型切换到 Nano Banana？
只需将模型名称从
gpt-4o-image 或 sora_image 更改为 gemini-3-pro-image-preview（推荐 Pro）或 gemini-2.5-flash-image（前代），其他参数保持不变。生成的图片是什么格式？
生成的图片是什么格式？
模型返回 base64 编码的图片数据，通常为 PNG 或 JPEG 格式。代码会自动检测格式并保存为对应的文件类型。
支持图片编辑功能吗？
支持图片编辑功能吗？
是的，Nano Banana Pro 支持图片生成和图片编辑。请查看 图片编辑 API 参考。