快速结论
- 调用入口是 POST /v1/images/generations,请按文档使用 Nano Banana 2 对应模型标识提交图像任务。
- 支持 prompt 文生图和 reference_images 参考图生成,适合广告、电商、社媒和批量创意素材。
- 生成流程采用异步任务模式,先返回任务 ID,再通过图片任务状态接口轮询结果。
- 官方对比价格按 1K / 2K / 4K 分辨率约为 $0.04 / $0.05 / $0.088 每张;ToAPIs 当前投放页固定价为 $0.025 / $0.030 / $0.040 每张,最终以账户当前价格为准。
- 按 ToAPIs 1K 档 $0.025/张估算,充值 $10 大约可继续生成 400 张 1K 图片;如果按 4K 档 $0.040/张估算,约可生成 250 张 4K 图片。
关键参数
- model | string | 必填 | nano_banana_2 | - | 使用 ToAPIs 文档或价格表中的 Nano Banana 2 模型标识。
- prompt | string | 必填 | - | - | 图片生成的主提示词。
- size | string | 可选 | 1:1 | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | 输出宽高比,实际可选值以文档和模型能力为准。
- resolution | string | 可选 | 1K | 1K | 2K | 4K | 输出分辨率档位,影响单张价格和生成成本。
- reference_images | string[] | 可选 | - | URL 数组 | 参考图 URL 数组,用于参考图生成和风格/主体约束。
- response_format | string | 可选 | url | url | b64_json | 返回结果格式,建议优先使用 URL。
常见错误
- 400 invalid_request_error: 触发=缺少 model/prompt,或分辨率、比例、参考图字段不符合文档要求。; 修复=按 ToAPIs 文档校验 model、prompt、size、resolution、reference_images。; 重试=修正参数后重试,不建议盲重试。
- 401 authentication_error: 触发=Authorization 头缺失或 API Key 无效。; 修复=检查 Bearer Token 格式和密钥权限。; 重试=修复鉴权后再重试。
- 429 rate_limit_exceeded: 触发=请求频率、并发或当前 credits 命中限制。; 修复=做指数退避,降低并发,并检查账户 credits。; 重试=建议 1s/2s/4s 退避并加入抖动;连续触发时先排队。
