EN RU 中文
$ cat /faq
▸ Что такое Sosana API?

Единый API для AI-генерации — изображения (Nano Banana, Nano Banana Pro, GPT Image), видео (Veo) и текст (Claude, Gemini) — под одним токеном, с асинхронными задачами, вебхуками и OpenAI-совместимым чат-эндпоинтом.

▸ С чего начать?

Войдите, скопируйте API-ключ в кабинете (/keys), отправьте промпт POST-запросом на /api/image/create-async и либо опрашивайте задачу, либо получите вебхук, когда результат готов.

▸ Можно ли редактировать изображения или использовать референсы?

Да. Передайте до 10 входных изображений через image_urls (https-ссылки или base64), чтобы направлять генерацию или редактировать существующие изображения.

▸ Какие размеры и соотношения сторон поддерживаются?

Соотношение сторон задаётся параметром aspect_ratio для каждого запроса. nano-banana-pro отдаёт результат в 1K, 2K или 4K в зависимости от выбранного варианта модели.

▸ Как устроена оплата?

Предоплата по модели «оплата за изображение», от $0.0095. Полные цены — в разделе /pricing, списание только за успешные результаты.

▸ Есть ли бонус за регистрацию?

Да — при регистрации через Google с адресом @gmail.com на счёт зачисляется $1, этого хватает, чтобы сразу сгенерировать первые изображения. Аккаунтам Google Workspace на других доменах и при регистрации по коду на почту бонус не начисляется.

▸ Насколько надёжен сервис?

Запросы балансируются между несколькими провайдерами по их состоянию, неудачные задачи повторяются автоматически без двойного списания, а результаты хранятся в резервируемом S3.

▸ Есть ли ограничения по частоте запросов?

Жёстких ограничений на пользователя нет — API полностью асинхронный, можно отправлять задачи параллельно, и они обрабатываются с максимально доступной скоростью. Наша инфраструктура выдерживает до 10 млн запросов в сутки.

▸ Сколько хранятся мои изображения?

Сгенерированные изображения хранятся в S3 в течение 7 дней и отдаются через быстрый CDN — скачайте или скопируйте их в своё хранилище в течение этого срока.

▸ Поддерживаете ли вы вебхуки?

Да. Передайте webhook_url, и мы отправим результат POST-запросом по завершении задачи; иначе опрашивайте GET /api/image/{uid}.

▸ Как обстоят дела с модерацией?

Промпты проходят модерацию, а наш оптимизатор промптов снижает число ложных отказов. Отклонённые задачи помечаются как MODERATED и не тарифицируются.

▸ Можно ли использовать сгенерированные изображения в коммерческих целях?

Да — вы владеете сгенерированными изображениями и можете использовать их в коммерческих целях с учётом наших Условий и политик использования базовых провайдеров моделей.

$ cd /