Gempix 2 API

Документация GemPix2 API

Полная документация API для сервиса генерации изображений GemPix2 с использованием AI моделей Google Gemini

Узнать ценуПосмотреть тарифы GemPix2

Обзор GemPix2 API

API генерации изображений GemPix2 предоставляет доступ к AI моделям Google Gemini для создания высококачественных изображений по текстовым prompt'ам и референсным изображениям. Наш сервис GemPix2 предлагает простой RESTful интерфейс с полным управлением задачами и поддержкой callback'ов.

Ключевые возможности GemPix2

  • • Генерация изображений GemPix2 из текста с помощью AI моделей Google Gemini
  • • Поддержка GemPix2 референсных изображений (до 4 изображений)
  • • Асинхронная обработка задач GemPix2 с отслеживанием статуса
  • • Поддержка GemPix2 webhook callback'ов для уведомлений в реальном времени
  • • RESTful API GemPix2 с JSON ответами
  • • Аутентификация GemPix2 через Bearer токен

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

Начало работы с GemPix2

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

Аутентификация

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

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

Используйте HTTP Bearer токен аутентификацию, включив ваш 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 генерации изображений GemPix2

Генерируйте изображения с помощью GemPix2 используя модели Google Gemini AI с настраиваемыми промптами и референсными изображениями.

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

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

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

Базовая генерация изображений GemPix2

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

Генерация изображений GemPix2 на основе референсных изображений

{
  "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 запроса задач GemPix2

Запрос статуса и результатов задач генерации изображений GemPix2 с использованием ID задачи, возвращенного из конечной точки генерации изображений GemPix2.

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

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"

Значения статуса задач GemPix2

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

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

404 - Task Not Found

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

401 - Unauthorized

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

Модели данных GemPix2

Полный справочник всех моделей данных и схем GemPix2, используемых в ответах и запросах 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

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

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. 1. Всегда проверяйте HTTP коды состояния перед обработкой тела ответа:
  2. 2. Используйте экспоненциальную задержку для повторных попыток при ошибках 500:
  3. 3. Записывайте ответы об ошибках с подробной информацией для отладки:
  4. 4. Проверяйте входные данные перед отправкой запросов, чтобы избежать ошибок 400:
  5. 5. Обрабатывайте ошибки аутентификации, предлагая пользователям обновить API ключи:
  6. 6. Периодически проверяйте статус задач вместо слишком частого опроса:
  7. 7. Используйте вебхуки когда возможно, чтобы избежать опроса для завершения задач:

Пример обработки ошибок (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;
  }
}