通过一个 API 调用 Nano Banana 2 和 Nano Banana Pro
Puzzle 通过统一 API（https://api.puzzle.team）提供 Nano Banana 2（nano-banana-v2）和 Nano Banana Pro（nano-banana-pro）的访问能力。按使用量计费：以 USDC 或 USDT 在以太坊、波场或 BNB 上充值，或通过 Telegram 联系支持进行银行转账。余额为零时返回 HTTP 402 insufficient_funds——这是正常结果，不是接口故障。密钥仅显示一次，存储为 SHA-256。Omni、Veo 和 Gemini 上线前返回 422。
快速开始
- 在 https://puzzle.team/login 注册
- 在控制台创建 API 密钥（仅显示一次，存储 SHA-256）
- 调用
POST https://api.puzzle.team/v1/text-generations，携带Authorization: Bearer puz_live_…
curl -X POST https://api.puzzle.team/v1/text-generations \
-H "Authorization: Bearer $PUZZLE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"nano-banana-pro","prompt":"一块青色拼图，棚拍光效","aspect_ratio":"1:1"}'可用模型
| 模型 ID | 状态 |
|---|---|
nano-banana-v2 | ✅ 在线 |
nano-banana-pro | ✅ 在线 |
omni | ⏳ 即将上线（返回 422） |
veo | ⏳ 即将上线（返回 422） |
gemini | ⏳ 即将上线（返回 422） |
关键错误码
| HTTP | code | 说明 |
|---|---|---|
| 401 | unauthorized | 密钥缺失或无效 |
| 402 | insufficient_funds | 余额为 $0.00——充值后重试 |
| 422 | model_unavailable | Omni / Veo / Gemini 尚未上线 |
| 429 | rate_limited | 超过账户请求频率上限 |
充值方式
加密货币在控制台自助操作：USDC 或 USDT，走以太坊、波场或 BNB。转账后粘贴哈希；确认到账后计入余额。 不想用加密货币？微信或 Telegram @PUZZLE_Support_AI 联系——我们开票并入同一余额。没有银行卡结账。
常见问题
- 怎么开始？
- 注册，创建密钥，用 Bearer 调用 /v1。文档里有 curl。提示词可以留，官方 Google SDK 指向我们的域名不会通。
- 充值怎么算？
- 加密在控制台自助：USDC 或 USDT，走以太坊、波场或 BNB。转完贴哈希，确认到账后计入 GET /v1/balance。想走银行而不是加密？加微信，我们开票并入同一余额。没有银行卡结账。
- 402 是什么意思？
- 密钥有效，但已确认余额是 $0.00。充值、等确认，再重试。402 是正常结果，不是接口挂了。
- 提示词会用来训练吗？
- 不会。Puzzle 不用你的提示词或输出训练谷歌或我们自己的模型。
- 密钥丢了还能再看吗？
- 不能。Puzzle 只存 SHA-256 哈希。创建时立刻复制。丢了就撤销，再新建一把。
- 有可用性保障吗？
- 只写在签过的合同里。每账户有请求频率上限，数字不公开。需要合同或额度——加微信。
- 目前可用哪些模型？
- Nano Banana 2 与 Nano Banana Pro 已上线。Omni、Veo 和 Gemini 在上线前返回 422。状态见控制台和文档。