Skip to main content
POST
Gemini API: генерация по тексту
Создавайте изображения по описанию с Nano Banana Pro, 2 или 2.1. POST /v1beta/models/{model}:generateContent Генерация по тексту и редактирование используют один адрес API. Для редактирования в запрос добавляют референс.

Проверить запрос

Введите BetterToken API Key в x-goog-api-key, выберите model и измените описание в contents. Начните с 1K и 1:1, затем нажмите Send.
Нажатие Send отправляет реальный запрос генерации и может привести к списанию средств. Дождитесь синхронного ответа. После тайм-аута или обрыва проверьте историю расходов и результат запроса, прежде чем отправлять его повторно.
Все три модели предлагают 1K, 2K и 4K. Nano Banana 2 и 2.1 поддерживают 14 пропорций, Pro — 10. X-BetterToken-Max-Images ограничивает число возвращаемых и оплачиваемых изображений, но не гарантирует это количество. Пропорции
BetterToken API не поддерживает генерацию с поиском, включая Google Web Search и Image Search grounding. Не добавляйте поисковые инструменты.
Для генерации по тексту достаточно описания; референс не нужен. Используйте нестриминговый generateContent. Files, Batch, Interactions и стриминг не поддерживаются.

Прочитать ответ

Изображения находятся в candidates[].content.parts[].inlineData. Переберите элементы, пропустите thought: true, декодируйте data и выберите расширение по mimeType. Изображение не обязательно находится первым и не всегда имеет формат PNG.

Связанные руководства

Авторизации

x-goog-api-key
string
header
обязательно

BetterToken API Key.

Заголовки

X-BetterToken-Max-Images
integer
по умолчанию:1

Предел возвращаемых и оплачиваемых изображений, а не гарантированное количество. По умолчанию 1.

Требуемый диапазон: 1 <= x <= 4

Параметры пути

model
enum<string>
по умолчанию:nano-banana-2.1
обязательно

Model ID BetterToken. Выберите одну из трёх моделей Nano Banana.

Доступные опции:
nano-banana-pro,
nano-banana-2,
nano-banana-2.1

Тело

application/json
contents
object[]
обязательно

История диалога. Для следующих правок сохраняйте полный content модели и thoughtSignature.

Minimum array length: 1
generationConfig
object

Настройки генерации.

Ответ

Результат генерации. Проверьте финальные изображения и finishReason.

candidates
object[]
promptFeedback
object
usageMetadata
object