模式: Text to Image
Comic Strip
建议的测试配置: 1:1
示例与提示词
看看 Nano Banana 2 API 能创作什么
真实的 Nano Banana 2 输出及其背后的提示词。复制提示词并在 Playground 中测试。
模式: Image Editing
Magazine Cover
建议的测试配置: 1:1
模式: Text to Image
Illustrated Guide
建议的测试配置: 1:1
模式: Image Editing
High-Res Upscale
建议的测试配置: 1:1
模型规格
构建前先了解设置。
Topview API Platform 文档所列 Nano Banana 2 设置的快速参考。每种模式有各自的输入要求。
| 参数 | 取值 |
|---|---|
| 提供商 / 模型 | Google / Nano Banana 2 |
| API 路由 | google/nano-banana-2 |
| 生成模式 | Text to Image · Image Editing |
| 分辨率 | 1K · 2K · 4K (default 1K) |
| 宽高比 | 1:1 · 16:9 · 9:16 |
| Image Editing 输入 | 1–2 images |
| 提示词长度 | Up to 4,000 characters |
| 任务模式 | Async submission + polling + output retrieval |
| 价格 | Per generated image; settlement follows actual usage |
开发者快速开始
从 API 密钥到第一张图片。
使用 Platform API 密钥提交异步预测，然后轮询返回的任务 ID 以获取输出。
# Set TOPVIEW_API_PLATFORM_KEY once. Preserve REQUEST_KEY and input for uncertain retries.
# For a NEW task only, unset REQUEST_KEY first. Save data.id to resume GET only.
: "${TOPVIEW_API_PLATFORM_KEY:?Set TOPVIEW_API_PLATFORM_KEY first}"
export REQUEST_KEY="${REQUEST_KEY:-$(uuidgen)}"
curl --fail-with-body 'https://platform-backend.topview.ai/api/v1/models/google/nano-banana-2/text-to-image/predictions' \
-H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY" \
-H "Idempotency-Key: $REQUEST_KEY" \
-H 'Content-Type: application/json' \
--data '{
"prompt": "A blue ceramic cup on a wooden table",
"aspect_ratio": "1:1",
"resolution": "1k"
}'
# Poll data.id until completed or failed.
curl --fail-with-body 'https://platform-backend.topview.ai/api/v1/predictions/REQUEST_ID' \
-H "Authorization: Bearer $TOPVIEW_API_PLATFORM_KEY"示例与 Platform 文档中的 Nano Banana 2 text-to-image 请求一致。请仅在服务器端保存 TOPVIEW_API_PLATFORM_KEY。
步骤 1
获取 API 密钥
登录 Topview API Platform，创建具备所需模型权限的 API 密钥。请妥善保管密钥，并用它验证 API 请求。
步骤 2
生成或编辑图片
提交文本提示词，或上传用于编辑的参考图。配置支持的图像设置，发送 API 请求，并保存返回的任务 ID。
步骤 3
获取图片
检查任务状态直至生成完成。获取图片 URL，查看最终用量费用，并保存生成的图片。
面向生产工作流
将一两张源图变成可直接使用的概念图
Nano Banana 2 为图像生成产品提供精选尺寸与常见宽高比，适合实用营销与编辑任务。
商品场景变体
在使用一两张编辑参考的同时，将商品照片变成其他背景或生活方式呈现。
社交活动格式
使用 1:1、16:9 或 9:16，为帖子、缩略图和广告位创建方形、宽屏与竖版图像概念。
双参考构图
用两张源图引导组合视觉概念，例如将产品放入选定环境。
高分辨率营销草稿
为活动概念、视觉样稿与素材审阅流程选择 1K、2K 或 4K 输出。
为什么选择 TOPVIEW API
面向实用集成的直观图像设置
在测试与构建时，Topview 持续展示 Nano Banana 2 支持的模式、输出尺寸与参考图上限。
比较三个分辨率档位
在决定各任务合适尺寸前，查看 1K、2K 与 4K 的当前按图价格。
测试单图与双图编辑
使用 Playground 与文档，确认编辑路由如何处理模型支持的参考图输入。
聚焦常见输出比例
实现三种支持格式——方形、横向与纵向——而不暴露不支持的宽高比选项。
与 Nano Banana 2.1 比较
使用同一 Platform 账户，评估应用是否需要 2.1 变体更广的宽高比与参考图支持。
Nano Banana 2 API 常见问题
你可以打开 Nano Banana 2 Playground 查看设置。API 用量从 Platform USD 余额扣费，促销积分会随时间变化。请在 Topview API Platform 查看工作区当前资格与余额。
Topview API Platform 列出 Text to Image 与 Image Editing。Image Editing 接受一两张输入图与提示词。
Nano Banana 2 以 1:1、16:9 或 9:16 输出 1K、2K 或 4K 图像。价格取决于分辨率。
在 Topview API Platform 上，Nano Banana 2.1 支持 14 种宽高比、最多 14 个编辑输入与更长提示词，且当前按图费率更低。Nano Banana 2 支持三种宽高比与最多两个编辑输入。选择前请比较两张价格表。
创建 Platform API 密钥，向 Nano Banana 2 端点提交带 Idempotency-Key 的预测，保存返回的任务 ID 并轮询至完成。结果 URL 可能过期，请及时下载图片。密钥请保存在服务器端。
下一张图片从这里开始
使用 Nano Banana 2 API 构建
在 Playground 中试用第一条提示词，比较当前价格，或按文档将 Nano Banana 2 集成到应用中。