商品与生活方式概念
根据提示词创建商品相关场景，或修改单张商品照片以获得不同视觉效果。
模型规格
构建前先了解设置。
Topview API Platform 文档所列 Nano Banana 设置的快速参考。每种模式有各自的输入要求。
| 参数 | 取值 |
|---|---|
| 提供商 / 模型 | Google / Nano Banana |
| API 路由 | google/nano-banana |
| 生成模式 | Text to Image · Image Editing |
| 分辨率 | Standard output (no resolution parameter) |
| 宽高比 | 1:1 · 16:9 · 9:16 · 4:3 · 3:4 |
| Image Editing 输入 | 1 image |
| 提示词长度 | 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/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"
}'
# 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 text-to-image 请求一致。请仅在服务器端保存 TOPVIEW_API_PLATFORM_KEY。
步骤 1
获取 API 密钥
登录 Topview API Platform，创建具备所需模型权限的 API 密钥。请妥善保管密钥，并用它验证 API 请求。
步骤 2
生成或编辑图片
提交文本提示词，或上传用于编辑的参考图。配置支持的图像设置，发送 API 请求，并保存返回的任务 ID。
步骤 3
获取图片
检查任务状态直至生成完成。获取图片 URL，查看最终用量费用，并保存生成的图片。
面向生产工作流
为日常应用加入简单的图像创建与编辑
原版 Nano Banana API 以一种标准输出尺寸和精简的参考编辑控件，支持常见图像生成任务。
五种比例的社交图形
在含 4:3 与 3:4 的五种支持宽高比中，生成方形、横向或纵向概念图。
单图创意编辑
让用户用一张编辑输入重塑照片风格、改变周围环境，或探索新的构图方向。
入门级图像功能
为创作者工具、内部流程或小型营销应用加入基础 text-to-image 与单图编辑。
为什么选择 TOPVIEW API
原版 Nano Banana API 的简洁入口
对于想使用原版模型而非更新 Nano Banana 变体的团队，Topview 提供已文档化的模式与格式选项。
标准尺寸计价模型
查看当前按图费率，无需添加不支持的 2K 或 4K 分辨率选择器。
五种支持的宽高比
在映射产品输出设置前，先测试 1:1、16:9、9:16、4:3 与 3:4。
测试单图编辑
使用专用编辑路由与文档化输入要求，用单张源图探索基于提示词的编辑。
比较 Nano Banana 系列
在同一 Topview 工作区中，随输出与编辑需求变化，评估原版模型与 Lite、2、2.1。
Nano Banana API 常见问题
你可以打开 Nano Banana Playground 查看设置。API 用量从 Platform USD 余额扣费，促销积分会随时间变化。请在 Topview API Platform 查看工作区当前资格与余额。
Topview API Platform 列出 Text to Image 与 Image Editing。Image Editing 接受一张输入图与提示词。
Nano Banana 支持 1:1、16:9、9:16、4:3 与 3:4。没有分辨率参数；每次请求返回一种标准输出尺寸。
Nano Banana 与 Nano Banana 2 Lite 均提供无分辨率选择器的简单按图计费。请按支持的宽高比、编辑输入与当前费率选择。若需要可选 2K 或 4K 输出，请比较 Nano Banana 2 与 Nano Banana 2.1。
创建 Platform API 密钥，向 Nano Banana 端点提交带 Idempotency-Key 的预测，保存返回的任务 ID 并轮询至完成。结果 URL 可能过期，请及时下载图片。密钥请保存在服务器端。
探索相关 API
更多 AI 图像模型，同一目的地。
下一张图片从这里开始
使用 Nano Banana API 构建
在 Playground 中试用第一条提示词，比较当前价格，或按文档将 Nano Banana 集成到应用中。