Nano Banana Pro API

Справочник разработчика по API Nano Banana Pro

Полный справочник разработчика по API платформы для визуального производства Nano Banana Pro на базе передовых технологий машинного обучения

Посмотреть тарифыУзнайте о тарифных планах подписки на API Nano Banana Pro

Обзор Nano Banana Pro API

Сервис Nano Banana Pro API позволяет создавать качественные изображения. Он использует передовые движки машинного обучения для генерации изображений по текстовым подсказкам и опорным фотографиям. Наше решение предоставляет простой REST-интерфейс с полным управлением задачами и уведомлениями в реальном времени.

Ключевые возможности Nano Banana Pro API

  • • Преобразование текста в изображение с помощью передовых движков машинного обучения.
  • • Поддержка опорных изображений (до 4 изображений).
  • • Асинхронная обработка задач с отслеживанием прогресса в реальном времени.
  • • Уведомления через вебхуки о мгновенных изменениях статуса.
  • • RESTful-интерфейс, возвращающий структурированные данные JSON.
  • • Механизм аутентификации через Bearer-токен.

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

Быстрый старт с Nano Banana Pro API

  1. 1. Создайте аккаунт Nano Banana Pro API и получите учетные данные на нашем официальном сайте.
  2. 2. Включите ваш токен аутентификации Nano Banana Pro API в заголовок 'Authorization'.
  3. 3. Отправьте POST-запрос на эндпоинт генерации изображений Nano Banana Pro API.
  4. 4. Используйте полученный ID задачи Nano Banana Pro API, чтобы проверить статус обработки.
  5. 5. Получите ваши сгенерированные изображения Nano Banana Pro API по завершении обработки.

Аутентификация доступа

Все запросы API должны включать действительную аутентификацию с использованием учётных данных токена Bearer. Включите ваш API-ключ в заголовок Authorization для каждого запроса.

Метод аутентификации

Используйте HTTP аутентификацию Bearer token, включив ваши учётные данные API в заголовок Authorization:

Authorization: Bearer <your-api-key>

Формат API-ключа пример

Authorization: Bearer dk-1234567890abcdef

Пример запроса

curl -X POST "https://api.defapi.org/api/image/gen" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key-here" \
  -d '{
    "model": "google/gempix2",
    "prompt": "A beautiful landscape"
  }'

Действительная аутентификация

  • ✅ Учётные данные API не истекли
  • ✅ Регистрация аккаунта в порядке
  • ✅ Достаточный баланс аккаунта доступен

Распространённые проблемы

  • ❌ Отсутствуют учётные данные API в запросе
  • ❌ Неверный или неправильно отформатированный API-ключ
  • ❌ Аккаунт отключён или доступ к аккаунту отозван

Создание изображений API Nano Banana Pro

Создавайте изображения с помощью API Nano Banana Pro с использованием продвинутых технологий машинного обучения и гибких текстовых подсказок вместе с эталонными изображениями.

Конечная точка API

POST /api/image/gen

Параметры запроса

ParameterTypeRequiredDescription
modelstringYesModel identifier (e.g., "google/gempix2")
promptstringYesText prompt describing the image
imagesarrayNoReference image URLs (max 4)
callback_urlstringNoWebhook URL for completion notifications

Примеры использования

Базовое создание изображений API Nano Banana Pro

{
  "model": "google/gempix2",
  "prompt": "A beautiful girl dancing in a garden"
}

Генерация на основе эталона API Nano Banana Pro с примерами изображений

{
  "model": "google/gempix2",
  "prompt": "Put them in a basket",
  "images": [
    "https://cdn.openai.com/API/docs/images/body-lotion.png",
    "https://cdn.openai.com/API/docs/images/soap.png"
  ],
  "callback_url": "https://example.com/webhook/image-callback"
}

Формат ответа

{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "ta12345678-1234-1234-1234-123456789abc"
  }
}

Обработка ошибок

400 - Bad Request

{"code": 1, "message": "failed", "detail": "prompt is required"}

401 - Unauthorized

{"code": 1, "message": "Invalid API key"}

Статус задачи Nano Banana Pro API

Проверка статуса и результатов задач генерации изображений Nano Banana Pro API по их ID, который возвращается конечной точкой API.

Конечная точка API

GET /api/task/query?task_id=<task_id>

Параметры запроса

ParameterTypeRequiredDescription
task_idstringYesUnique task identifier returned from generation endpoint

Пример запроса

curl -X GET "https://api.defapi.org/api/task/query?task_id=ta823dfb-eaac-44fd-aec2-3e2c7ba8e071" \
  -H "Authorization: Bearer your-api-key-here"

Типы статусов задачи Nano Banana Pro API

pending - Задача создана и ожидает начала обработки.
submitted - Задача поставлена в очередь на обработку.
in_progress - Задача сейчас обрабатывается.
success - Задача успешно завершена, изображения готовы.
failed - Задача завершилась с ошибкой.

Ответы с ошибками

404 - Task Not Found

{"code": 1, "message": "task not found"}

401 - Unauthorized

{"code": 401, "message": "Invalid API key"}

Структуры данных Nano Banana Pro API

Справочник по всем форматам данных и схемам Nano Banana Pro API, используемым в запросах и ответах.

ImageGenResult

Represents a generated image result.

{
  "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
}
FieldTypeDescription
imagestringImage URL or base64 data URI

CallbackPayload

Payload sent to the callback_url when task status changes to final states.

{
  "result": [
    {
      "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
    }
  ],
  "status": "success",
  "task_id": "ta5c9705-b8ae-4cb9-aa6f-97c4fee88c8d",
  "consumed": "0.500000",
  "status_reason": {
    "message": null
  }
}
FieldTypeDescription
resultarrayArray of ImageGenResult objects (null if failed)
statusstringFinal task status (success/failed)
task_idstringUnique task identifier
consumedstringCredits consumed by the task
status_reasonobjectStatus details including error message if failed

Поддерживаемые модели Nano Banana Pro API

google/gempix2Nano Banana image generation model
google/gemini-2.5-flash-imageGemini 2.5 Flash image model

Управление ошибками

Руководство по обработке ошибок и кодам ответа API. Все ошибки имеют единый формат для простоты диагностики.

Коды состояния HTTP

200

OK

Request was successful

400

Bad Request

Invalid request parameters or malformed JSON

401

Unauthorized

Invalid, missing, or expired API key

404

Not Found

Task not found or endpoint doesn't exist

500

Internal Server Error

Server-side error occurred

Лучшие практики обработки ошибок

  1. Проверяйте HTTP-коды перед обработкой ответа.
  2. При ошибках 500 используйте экспоненциальную задержку для повторных попыток.
  3. Сохраняйте для отладки полные логи ошибок.
  4. Проверяйте параметры перед отправкой запроса, чтобы избежать ошибок 400.
  5. Для решения проблем аутентификации обновите API-ключи клиента.
  6. Проверяйте статус задачи через разумные интервалы, а не слишком часто.
  7. Используйте webhook'и, чтобы не постоянно проверять статус задачи.

Пример обработки ошибок (JavaScript)

async function generateImage(prompt, apiKey) {
  try {
    const response = await fetch('https://api.defapi.org/api/image/gen', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        model: 'google/gempix2',
        prompt: prompt
      })
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API Error ${response.status}: ${errorData.message}`);
    }

    const data = await response.json();
    return data.data.task_id;

  } catch (error) {
    console.error('Image generation failed:', error.message);
    throw error;
  }
}