EN RU 中文
$ cat /faq
▸ What is Sosana API?

A unified API for AI generation — images (Nano Banana, Nano Banana Pro, GPT Image), video (Veo) and text (Claude, Gemini) — behind a single token, with async tasks, webhooks and an OpenAI-compatible chat endpoint.

▸ How do I get started?

Sign in, copy an API key from the cabinet (/keys), then POST your prompt to /api/image/create-async and either poll the task or receive a webhook when it is ready.

▸ Can I edit images or use reference inputs?

Yes. Pass up to 10 input images via image_urls (https URLs or base64) to guide generation or edit existing images.

▸ What sizes and aspect ratios are supported?

Set aspect_ratio per request. nano-banana-pro renders at 1K, 2K or 4K depending on the model variant you pick.

▸ How does pricing work?

Prepaid and pay-per-image, from $0.0095. Full prices are under /pricing, and you are only billed for successful results.

▸ Is there a signup bonus?

Yes — sign up with Google using a @gmail.com address and your account starts with $1 of free credit, enough to generate your first images right away. Google Workspace accounts on other domains and registration by email code give no credit.

▸ How reliable is the service?

Requests are balanced across multiple providers by live health, failed tasks retry automatically without double-billing, and results are stored on redundant S3.

▸ Are there rate limits?

No hard per-user rate limit — the API is fully async, so you can submit tasks in parallel and they are processed as fast as capacity allows. Our infrastructure handles up to 10M requests per day.

▸ How long are my images stored?

Generated images are stored on S3 for 7 days and served over a fast CDN — download or copy them to your own storage within that window.

▸ Do you support webhooks?

Yes. Pass a webhook_url and we POST the result when the task completes; otherwise poll GET /api/image/{uid}.

▸ What about content moderation?

Prompts pass moderation, and our prompt optimizer reduces false rejections. Rejected tasks are marked MODERATED and are not billed.

▸ Can I use generated images commercially?

Yes — you own the images you generate and may use them commercially, subject to these Terms and the underlying model providers' usage policies.

$ cd /