Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://docs.runblob.io/llms.txt

Use this file to discover all available pages before exploring further.

Base URL: https://platform.runblob.io

​
POST /v1/gemini/generate

Создаёт асинхронную задачу Nano Banana (Gemini Image Generation). Поддерживает text-to-image, редактирование изображений и multi-image композицию для моделей Standard, Pro и V2.

​
Доступные модели

МодельЗначениеВарианты качестваМакс. изображенийОписание
Standardstandardтолько standard4Быстрая генерация на Gemini 2.5 Flash
Proprostandard, 2k, 4k8Высокое качество на Gemini 3.0 Pro
Nano Banana 2v2standard, 2k, 4k8Следующее поколение на Gemini 3.1 Flash
​
prompt
string
обязательно
Текстовое описание изображения (1–4000 символов)
​
model
string
по умолчанию:"standard"
Версия модели: "standard", "pro" или "v2"
​
quality
string
по умолчанию:"standard"
Качество (для моделей pro и v2): "standard", "2k" или "4k"
​
aspect_ratio
string
по умолчанию:"auto"
Соотношение сторон. Варианты:
  • "auto" — автоматически
  • Ландшафт: "21:9", "16:9", "4:3", "3:2"
  • Квадрат: "1:1"
  • Портрет: "9:16", "3:4", "2:3"
  • Гибкие: "5:4", "4:5"
​
temperature
number
по умолчанию:"0.7"
Уровень креативности от 0 до 1. Выше — креативнее результат.
​
images
array
Массив входных изображений (Base64 или URL) для редактирования/трансформации. До 4 для standard, до 8 для pro и v2.
​
callback_url
string
URL webhook для уведомлений о готовности
curl -X POST https://platform.runblob.io/v1/gemini/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cute orange cat sitting on a windowsill, golden hour lighting",
    "model": "standard",
    "aspect_ratio": "16:9"
  }'

​
Ответ

{
  "task_uuid": "ffd473d5-5bef-4e14-bf22-8d559be3c19f",
  "status": "pending",
  "price": "0.0200"
}
​
task_uuid
string
UUID задачи генерации для проверки статуса
​
status
string
Начальный статус, всегда "pending"
​
price
string
Сумма списания в USD
Генерация обычно занимает 7–30 секунд. Используйте task_uuid для проверки статуса или настройте webhooks.
Параметр quality (2k, 4k) доступен только для моделей pro и v2. Использование с standard приведёт к ошибке.

​
Входные изображения

Можно передать входные изображения для редактирования или трансформации. Лимит: 4 изображения для standard, 8 изображений для pro и v2.
  • Base64: "data:image/jpeg;base64,/9j/4AAQ..."
  • URL: "https://example.com/image.jpg"
  • Макс. размер: 20 MB на изображение
  • Форматы: JPEG, PNG, WEBP
{
  "prompt": "Combine these images into a collage",
  "images": [
    "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
    "https://example.com/image2.jpg",
    "data:image/png;base64,iVBORw0KGgo..."
  ]
}