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

A unified API for AI image generation — Nano Banana, Nano Banana Pro and GPT Image — behind a single token, with async tasks and webhooks.

How do I get started?

Sign in, copy your token from /token, then POST your prompt to /api/banana/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 — every new account gets $1 of free credit on registration, enough to generate your first images right away.

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/banana/{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 /