Gempix 2 API

Documentación API de GemPix2

Documentación API completa para el Servicio de Generación de Imágenes GemPix2 usando modelos de IA Google Gemini

Obtener PrecioVer planes de precios GemPix2

Resumen de la API GemPix2

La API de Generación de Imágenes GemPix2 proporciona acceso a los modelos de IA Google Gemini para generar imágenes de alta calidad a partir de prompts de texto e imágenes de referencia. Nuestro servicio GemPix2 ofrece una interfaz RESTful simple con gestión completa de tareas y soporte de callbacks.

Características Clave de GemPix2

  • • Generación texto-a-imagen GemPix2 usando modelos de IA Google Gemini
  • • Soporte GemPix2 para imágenes de referencia (hasta 4 imágenes)
  • • Procesamiento asíncrono de tareas GemPix2 con seguimiento de estado
  • • Soporte de callbacks webhook GemPix2 para notificaciones en tiempo real
  • • API RESTful GemPix2 con respuestas JSON
  • • Autenticación con token Bearer GemPix2

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

Primeros Pasos con GemPix2

  1. 1. Regístrate para obtener una clave API GemPix2 en nuestro servidor de producción
  2. 2. Incluye tu clave API GemPix2 en el encabezado de Autorización
  3. 3. Envía una solicitud POST al endpoint de generación de imágenes GemPix2
  4. 4. Usa el task_id devuelto por GemPix2 para verificar el estado de generación
  5. 5. Recupera tus imágenes generadas por GemPix2 cuando la tarea esté completa

Autenticación

Todas las solicitudes de API deben autenticarse usando autenticación Bearer token. Incluye tu clave API en el encabezado Authorization de cada solicitud.

Método de Autenticación

Usa autenticación HTTP Bearer token incluyendo tu clave API en el encabezado Authorization:

Authorization: Bearer <your-api-key>

Formato de Ejemplo de Clave API

Authorization: Bearer dk-1234567890abcdef

Ejemplo de Solicitud

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

Autenticación Válida

  • ✅ La clave API es válida
  • ✅ La cuenta de usuario está activa
  • ✅ Hay suficientes créditos disponibles

Errores Comunes

  • ❌ Falta la clave API
  • ❌ Formato de clave API inválido
  • ❌ Cuenta expirada o inactiva

API de Generación de Imágenes GemPix2

Genera imágenes usando GemPix2 con modelos de Google Gemini AI y prompts personalizables e imágenes de referencia.

Endpoint

POST /api/image/gen

Parámetros de Solicitud

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

Ejemplos de Solicitud

Generación Básica de Imágenes GemPix2

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

Generación GemPix2 Basada en Imágenes con Imágenes de Referencia

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

Formato de Respuesta

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

Respuestas de Error

400 - Bad Request

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

401 - Unauthorized

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

API de Consulta de Tareas GemPix2

Consulta el estado y resultados de las tareas de generación de imágenes GemPix2 usando el ID de tarea devuelto desde el endpoint de generación de imágenes GemPix2.

Endpoint

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

Parámetros de Consulta

ParameterTypeRequiredDescription
task_idstringYesUnique task identifier returned from generation endpoint

Ejemplo de Solicitud

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

Valores de Estado de Tarea GemPix2

pending - La tarea GemPix2 ha sido creada y está esperando ser procesada
submitted - La tarea GemPix2 ha sido enviada a la cola de generación
in_progress - La tarea GemPix2 está siendo procesada actualmente
success - La tarea GemPix2 se completó exitosamente con imágenes generadas
failed - La tarea GemPix2 falló debido a un error

Respuestas de Error

404 - Task Not Found

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

401 - Unauthorized

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

Modelos de Datos GemPix2

Referencia completa para todos los modelos de datos y esquemas GemPix2 utilizados en las respuestas y solicitudes de la 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

Modelos GemPix2 Disponibles

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

Manejo de Errores

Guía completa para manejar errores y comprender los códigos de respuesta de la API. Todas las respuestas de error siguen un formato consistente para ayudarte a solucionar problemas de manera efectiva.

Códigos de Estado 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

Mejores Prácticas para el Manejo de Errores

  1. 1. Siempre verifica los códigos de estado HTTP antes de procesar el cuerpo de la respuesta:
  2. 2. Implementa reintento con retroceso exponencial para errores 500:
  3. 3. Registra las respuestas de error con información detallada para depuración:
  4. 4. Valida las entradas antes de enviar solicitudes para evitar errores 400:
  5. 5. Maneja errores de autenticación solicitando a los usuarios actualizar las claves API:
  6. 6. Monitorea el estado de las tareas periódicamente en lugar de consultar con demasiada frecuencia:
  7. 7. Usa webhooks cuando sea posible para evitar consultas constantes sobre la finalización de tareas:

Código de Ejemplo para Manejo de Errores (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;
  }
}