Gempix 2 API

Documentação da API GemPix2

Documentação completa da API para o Serviço de Geração de Imagens GemPix2 usando modelos de IA Google Gemini

Obter PreçoVer planos de preços GemPix2

Visão Geral da API GemPix2

A API de Geração de Imagens GemPix2 fornece acesso aos modelos de IA Google Gemini para gerar imagens de alta qualidade a partir de prompts de texto e imagens de referência. Nosso serviço GemPix2 oferece uma interface RESTful simples com gerenciamento abrangente de tarefas e suporte a callback.

Principais Recursos do GemPix2

  • • Geração de texto para imagem GemPix2 usando modelos de IA Google Gemini
  • • Suporte GemPix2 para imagens de referência (até 4 imagens)
  • • Processamento assíncrono de tarefas GemPix2 com rastreamento de status
  • • Suporte a callback webhook GemPix2 para notificações em tempo real
  • • API RESTful GemPix2 com respostas JSON
  • • Autenticação por token Bearer GemPix2

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

Primeiros Passos com GemPix2

  1. 1. Registre-se para obter uma chave da API GemPix2 em nosso servidor de produção
  2. 2. Inclua sua chave da API GemPix2 no cabeçalho Authorization
  3. 3. Envie uma solicitação POST para o endpoint de geração de imagens GemPix2
  4. 4. Use o task_id retornado pelo GemPix2 para verificar o status da geração
  5. 5. Recupere suas imagens geradas pelo GemPix2 quando a tarefa estiver completa

Autenticação

Todas as solicitações da API devem ser autenticadas usando autenticação de token Bearer. Inclua sua chave de API no cabeçalho Authorization de cada solicitação.

Método de Autenticação

Use autenticação de token HTTP Bearer incluindo sua chave de API no cabeçalho Authorization:

Authorization: Bearer <your-api-key>

Formato de Exemplo da Chave de API

Authorization: Bearer dk-1234567890abcdef

Exemplo de Solicitação

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

Autenticação Válida

  • ✅ Chave de API é válida
  • ✅ Conta do usuário está ativa
  • ✅ Créditos suficientes disponíveis

Erros Comuns

  • ❌ Chave de API ausente
  • ❌ Formato de chave de API inválido
  • ❌ Conta expirada ou inativa

API de Geração de Imagens GemPix2

Gere imagens usando GemPix2 com modelos de IA Google Gemini e prompts personalizáveis e imagens de referência.

Endpoint

POST /api/image/gen

Parâmetros da Solicitação

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

Exemplos de Solicitação

Geração Básica de Imagem GemPix2

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

Geração GemPix2 Baseada em Imagem com Imagens de Referência

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

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

Respostas de Erro

400 - Bad Request

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

401 - Unauthorized

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

API de Consulta de Tarefa GemPix2

Consultar o status e resultados das tarefas de geração de imagem GemPix2 usando o ID da tarefa retornado do endpoint de geração de imagem GemPix2.

Endpoint

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

Parâmetros de Consulta

ParameterTypeRequiredDescription
task_idstringYesUnique task identifier returned from generation endpoint

Exemplo de Solicitação

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 Status da Tarefa GemPix2

pending - A tarefa GemPix2 foi criada e está aguardando para ser processada
submitted - A tarefa GemPix2 foi enviada para a fila de geração
in_progress - A tarefa GemPix2 está sendo processada atualmente
success - A tarefa GemPix2 foi concluída com sucesso com imagens geradas
failed - A tarefa GemPix2 falhou devido a um erro

Respostas de Erro

404 - Task Not Found

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

401 - Unauthorized

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

Modelos de Dados GemPix2

Referência completa para todos os modelos de dados e esquemas GemPix2 usados nas respostas e solicitações da 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 Disponíveis

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

Tratamento de Erros

Guia completo para tratar erros e entender códigos de resposta da API. Todas as respostas de erro seguem um formato consistente para ajudar você a solucionar problemas de forma eficaz.

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

Melhores Práticas para Tratamento de Erros

  1. 1. Sempre verifique os códigos de status HTTP antes de processar o corpo da resposta:
  2. 2. Implemente backoff exponencial para lógica de repetição em erros 500:
  3. 3. Registre respostas de erro com informações detalhadas para depuração:
  4. 4. Valide entradas antes de enviar solicitações para evitar erros 400:
  5. 5. Trate erros de autenticação solicitando que os usuários atualizem as chaves da API:
  6. 6. Monitore o status da tarefa periodicamente em vez de fazer polling com muita frequência:
  7. 7. Use webhooks quando possível para evitar polling para conclusão de tarefas:

Exemplo de Tratamento de Erros (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;
  }
}