Gempix 2 API

Documentazione API GemPix2

Documentazione API completa per il Servizio di Generazione Immagini GemPix2 che utilizza i modelli AI di Google Gemini

Ottieni PrezzoVisualizza i piani tariffari GemPix2

Panoramica API GemPix2

L'API di Generazione Immagini GemPix2 fornisce accesso ai modelli AI di Google Gemini per generare immagini di alta qualità da prompt di testo e immagini di riferimento. Il nostro servizio GemPix2 offre un'interfaccia RESTful semplice con gestione completa dei task e supporto callback.

Caratteristiche Principali di GemPix2

  • • Generazione GemPix2 da testo a immagine usando i modelli AI di Google Gemini
  • • Supporto GemPix2 per immagini di riferimento (fino a 4 immagini)
  • • Elaborazione asincrona dei task GemPix2 con tracciamento dello stato
  • • Supporto webhook callback GemPix2 per notifiche in tempo reale
  • • API RESTful GemPix2 con risposte JSON
  • • Autenticazione GemPix2 con token Bearer

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

Iniziare con GemPix2

  1. 1. Registrati per ottenere una chiave API GemPix2 sul nostro server di produzione
  2. 2. Includi la tua chiave API GemPix2 nell'header Authorization
  3. 3. Invia una richiesta POST all'endpoint di generazione immagini GemPix2
  4. 4. Usa il task_id restituito da GemPix2 per controllare lo stato della generazione
  5. 5. Recupera le tue immagini generate da GemPix2 quando il task è completato

Autenticazione

Tutte le richieste API devono essere autenticate utilizzando l'autenticazione Bearer token. Includi la tua chiave API nell'header Authorization di ogni richiesta.

Metodo di Autenticazione

Usa l'autenticazione HTTP Bearer token includendo la tua chiave API nell'header Authorization:

Authorization: Bearer <your-api-key>

Formato Esempio Chiave API

Authorization: Bearer dk-1234567890abcdef

Esempio di Richiesta

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

Autenticazione Valida

  • ✅ La chiave API è valida
  • ✅ L'account utente è attivo
  • ✅ Crediti sufficienti disponibili

Errori Comuni

  • ❌ Chiave API mancante
  • ❌ Formato chiave API non valido
  • ❌ Account scaduto o inattivo

API Generazione Immagini GemPix2

Genera immagini usando GemPix2 con i modelli AI Google Gemini e prompt personalizzabili e immagini di riferimento.

Endpoint

POST /api/image/gen

Parametri di Richiesta

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

Esempi di Richiesta

Generazione Immagini GemPix2 di Base

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

Generazione GemPix2 Basata su Immagini con Immagini di Riferimento

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

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

Risposte di Errore

400 - Bad Request

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

401 - Unauthorized

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

API Query Task GemPix2

Interroga lo stato e i risultati delle attività di generazione immagini GemPix2 utilizzando l'ID dell'attività restituito dall'endpoint di generazione immagini GemPix2.

Endpoint

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

Parametri di Query

ParameterTypeRequiredDescription
task_idstringYesUnique task identifier returned from generation endpoint

Esempio di Richiesta

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

Valori di Stato Attività GemPix2

pending - L'attività GemPix2 è stata creata ed è in attesa di essere elaborata
submitted - L'attività GemPix2 è stata inviata alla coda di generazione
in_progress - L'attività GemPix2 è attualmente in elaborazione
success - L'attività GemPix2 è stata completata con successo con le immagini generate
failed - L'attività GemPix2 è fallita a causa di un errore

Risposte di Errore

404 - Task Not Found

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

401 - Unauthorized

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

Modelli di Dati GemPix2

Riferimento completo per tutti i modelli di dati e schemi GemPix2 utilizzati nelle risposte e richieste dell'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

Modelli GemPix2 Disponibili

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

Gestione degli Errori

Guida completa per gestire gli errori e comprendere i codici di risposta dell'API. Tutte le risposte di errore seguono un formato consistente per aiutarti a risolvere i problemi in modo efficace.

Codici di Stato 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

Migliori Pratiche per la Gestione degli Errori

  1. 1. Controlla sempre i codici di stato HTTP prima di elaborare il corpo della risposta:
  2. 2. Implementa un backoff esponenziale per la logica di retry sui 500 errori:
  3. 3. Registra le risposte di errore con informazioni dettagliate per il debug:
  4. 4. Valida gli input prima di inviare le richieste per evitare errori 400:
  5. 5. Gestisci gli errori di autenticazione chiedendo agli utenti di aggiornare le chiavi API:
  6. 6. Monitora lo stato delle attività periodicamente invece di fare polling troppo frequentemente:
  7. 7. Usa i webhook quando possibile per evitare il polling per il completamento delle attività:

Codice di Esempio per Gestione Errori (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;
  }
}