# Puzzle — AI Image Generation API

> Run Nano Banana 2 and Nano Banana Pro via one API. Usage-based credit — crypto or bank. Veo, Omni, and Gemini coming soon.

## What Puzzle is

Puzzle provides access to Nano Banana 2 (`nano-banana-v2`) and Nano Banana Pro (`nano-banana-pro`) through one unified API at https://api.puzzle.team. Billing is usage-based: fund your balance with USDC/USDT on Ethereum, Tron, or BNB, or contact support for bank transfer.

## Quick start

1. Sign up at https://puzzle-cloud.com/login
2. Create an API key in the dashboard (shown once, SHA-256 stored)
3. Call `POST https://api.puzzle.team/v1/text-generations` with `Authorization: Bearer puz_live_…`

## Docs for agents

- Full reference (EN): https://puzzle-cloud.com/docs.md
- Full reference (ZH): https://puzzle-cloud.com/docs-zh.md
- OpenAPI 3.1: https://puzzle-cloud.com/openapi.json
- Docs page: https://puzzle-cloud.com/docs

## Live models

- `nano-banana-v2` — text-to-image and image-to-image
- `nano-banana-pro` — text-to-image and image-to-image (higher quality)

## Coming soon (HTTP 422 until live)

- `omni`
- `veo`
- `gemini` ← Puzzle model id, not Gemini Apps

## Key facts

- Auth: `Authorization: Bearer puz_live_…`
- Empty balance returns HTTP **402** `insufficient_funds` — expected, not a down endpoint
- Keys shown once, SHA-256 at rest; revoke and recreate if lost
- No card checkout; no prompts used for training
- SLA and per-account RPM: unpublished, available in signed contracts only

## Support

Telegram: https://t.me/PUZZLE_Support_AI  
WhatsApp: contact via Telegram  
WeChat: contact via Telegram

SKIPPED WECHAT_ID
SKIPPED WHATSAPP_E164