Техническое руководство API 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.orgoverview.api_version
v1.0.0Руководство по внедрению Nano Banana 2
- 1. Зарегистрируйтесь для получения API ключей Nano Banana 2 через нашу основную платформу
- 2. Встройте ваш токен доступа Nano Banana 2 в параметр Authorization
- 3. Отправьте POST запрос на терминал создания изображений Nano Banana 2
- 4. Используйте предоставленный идентификатор задачи Nano Banana 2 для проверки статуса
- 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Параметры отправки
| Parameter | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | Model identifier (e.g., "google/gempix2") |
| prompt | string | Yes | Text prompt describing the image |
| images | array | No | Reference image URLs (max 4) |
| callback_url | string | No | Webhook 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>Переменные расследования
| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | Yes | Unique 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"
}| Field | Type | Description |
|---|---|---|
| image | string | Image 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
}
}| Field | Type | Description |
|---|---|---|
| result | array | Array of ImageGenResult objects (null if failed) |
| status | string | Final task status (success/failed) |
| task_id | string | Unique task identifier |
| consumed | string | Credits consumed by the task |
| status_reason | object | Status details including error message if failed |
Поддерживаемые конфигурации Nano Banana 2
google/gempix2Nano Banana image generation modelgoogle/gemini-2.5-flash-imageGemini 2.5 Flash image modelУправление ошибками
Полное руководство по управлению осложнениями и интерпретации индикаторов ответа API. Все уведомления о проблемах соответствуют стандартизированному формату, обеспечивая эффективные методы решения.
HTTP-коды ответов
OK
Request was successful
Bad Request
Invalid request parameters or malformed JSON
Unauthorized
Invalid, missing, or expired API key
Not Found
Task not found or endpoint doesn't exist
Internal Server Error
Server-side error occurred
Рекомендуемые подходы к решению проблем
- Всегда проверяйте HTTP-коды ответов перед анализом содержимого
- Используйте алгоритмы прогрессивной задержки для повторов при ошибках 500
- Записывайте уведомления о проблемах с подробными деталями для устранения неполадок
- Проверяйте валидность входных данных перед отправкой запроса, чтобы избежать ошибок 400
- Решайте проблемы авторизации, запрашивая обновление API-ключей у клиентов
- Отслеживайте прогресс задач через разумные интервалы вместо чрезмерных запросов статуса
- Используйте 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;
}
}