Техническое руководство API Nano Banana 2

Подробная техническая документация для сервиса визуального производства Nano Banana 2 с использованием передовых возможностей искусственного интеллекта

Посмотреть тарифыИзучите варианты подписки Nano Banana 2

Введение в API Nano Banana 2

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

Основные возможности Nano Banana 2

  • Преобразование текста в изображение Nano Banana 2 с использованием передовых систем ИИ
  • Совместимость Nano Banana 2 с образцами графики (максимум 4 изображения)
  • Неблокирующее выполнение задач Nano Banana 2 с мониторингом прогресса
  • Интеграция webhook в Nano Banana 2 для мгновенных обновлений статуса
  • REST архитектура Nano Banana 2 с JSON-ответами
  • Система проверки Bearer токенов Nano Banana 2

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

Руководство по внедрению Nano Banana 2

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

Проверка личности

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

Метод проверки

Используйте HTTP Bearer токен, встраивая ваши учетные данные в параметр Authorization:

Authorization: Bearer <your-api-key>

Структура примера ключа доступа

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 создания изображений Nano Banana 2

Создавайте изображения с помощью Nano Banana 2 с продвинутыми ИИ системами и гибкими текстовыми инструкциями плюс образцы изображений.

Терминал подключения

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

Примеры реализации

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

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

Создание Nano Banana 2 на основе референса с образцами графики

{
  "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"}

API статуса задач Nano Banana 2

Отслеживание прогресса и результатов задач визуального производства Nano Banana 2 с использованием идентификатора задачи, предоставленного терминалом создания визуальных материалов Nano Banana 2.

Терминал подключения

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 2

pending - Инициализация задачи Nano Banana 2 завершена, ожидается начало обработки
submitted - Задача Nano Banana 2 добавлена в очередь производства
in_progress - Задача Nano Banana 2 в настоящее время активно обрабатывается
success - Задача Nano Banana 2 успешно завершена с созданными визуальными материалами
failed - Задача Nano Banana 2 прервана из-за технических проблем

Ответы об ошибках

404 - Task Not Found

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

401 - Unauthorized

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

Информационные структуры Nano Banana 2

Полная документация для всех информационных конфигураций и шаблонов Nano Banana 2, используемых в 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 2

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;
  }
}