Gempix 2 API

GemPix2 API Documentatie

Volledige API documentatie voor GemPix2 Image Generation Service met Google Gemini AI modellen

Prijs OpvragenBekijk GemPix2 prijsplannen

GemPix2 API Overzicht

De GemPix2 Image Generation API biedt toegang tot Google Gemini AI modellen voor het genereren van hoogwaardige afbeeldingen uit tekstprompts en referentieafbeeldingen. Onze GemPix2 service biedt een eenvoudige RESTful interface met uitgebreid taakbeheer en callback ondersteuning.

GemPix2 Belangrijkste Functies

  • • GemPix2 tekst-naar-afbeelding generatie met Google Gemini AI modellen
  • • GemPix2 ondersteuning voor referentieafbeeldingen (tot 4 afbeeldingen)
  • • GemPix2 asynchrone taakverwerking met statustracking
  • • GemPix2 webhook callback ondersteuning voor realtime meldingen
  • • GemPix2 RESTful API met JSON responses
  • • GemPix2 Bearer token authenticatie

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

GemPix2 Aan de Slag

  1. 1. Meld je aan voor een GemPix2 API key op onze productieserver
  2. 2. Voeg je GemPix2 API key toe in de Authorization header
  3. 3. Stuur een POST request naar het GemPix2 image generation endpoint
  4. 4. Gebruik de geretourneerde GemPix2 task_id om de generatiestatus te controleren
  5. 5. Haal je GemPix2 gegenereerde afbeeldingen op wanneer de taak voltooid is

Authenticatie

Alle API-verzoeken moeten worden geauthenticeerd met Bearer token authenticatie. Voeg je API-sleutel toe in de Authorization header van elk verzoek.

Authenticatie Methode

Gebruik HTTP Bearer token authenticatie door je API-sleutel in de Authorization header op te nemen:

Authorization: Bearer <your-api-key>

Voorbeeld API-sleutel Formaat

Authorization: Bearer dk-1234567890abcdef

Verzoek Voorbeeld

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

Geldige Authenticatie

  • ✅ API-sleutel is geldig
  • ✅ Gebruikersaccount is actief
  • ✅ Voldoende credits beschikbaar

Veelvoorkomende Fouten

  • ❌ Ontbrekende API-sleutel
  • ❌ Ongeldig API-sleutel formaat
  • ❌ Verlopen of inactief account

GemPix2 Afbeelding Generatie API

Genereer afbeeldingen met GemPix2 met Google Gemini AI-modellen en aanpasbare prompts en referentieafbeeldingen.

Eindpunt

POST /api/image/gen

Verzoek Parameters

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

Verzoek Voorbeelden

Basis GemPix2 Afbeelding Generatie

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

GemPix2 Afbeelding-gebaseerde Generatie met Referentieafbeeldingen

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

Reactie Formaat

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

Fout Reacties

400 - Bad Request

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

401 - Unauthorized

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

GemPix2 Taak Query API

Vraag de status en resultaten op van GemPix2 afbeeldingsgeneratie taken met behulp van de taak ID die wordt geretourneerd door het GemPix2 afbeeldingsgeneratie endpoint.

Endpoint

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

Query Parameters

ParameterTypeRequiredDescription
task_idstringYesUnique task identifier returned from generation endpoint

Voorbeeld Verzoek

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 Taak Status Waarden

pending - GemPix2 taak is aangemaakt en wacht om verwerkt te worden
submitted - GemPix2 taak is ingediend bij de generatie wachtrij
in_progress - GemPix2 taak wordt momenteel verwerkt
success - GemPix2 taak succesvol voltooid met gegenereerde afbeeldingen
failed - GemPix2 taak mislukt door een fout

Fout Antwoorden

404 - Task Not Found

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

401 - Unauthorized

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

GemPix2 Data Modellen

Volledige referentie voor alle GemPix2 data modellen en schema's die gebruikt worden in de API antwoorden en verzoeken.

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 Beschikbare Modellen

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

Foutafhandeling

Uitgebreide gids voor het afhandelen van fouten en het begrijpen van API-responscodes. Alle foutresponses volgen een consistent formaat om je effectief te helpen bij het oplossen van problemen.

HTTP-statuscodes

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

Best practices voor foutafhandeling

  1. 1. Controleer altijd HTTP-statuscodes voordat je de response body verwerkt:
  2. 2. Implementeer exponential backoff voor retry-logica bij 500 fouten:
  3. 3. Log foutresponses met gedetailleerde informatie voor debugging:
  4. 4. Valideer inputs voordat je requests verstuurt om 400 fouten te voorkomen:
  5. 5. Behandel authenticatiefouten door gebruikers te vragen hun API-sleutels bij te werken:
  6. 6. Monitor taakstatus periodiek in plaats van te vaak te pollen:
  7. 7. Gebruik webhooks waar mogelijk om polling voor taakvoltooiing te vermijden:

Voorbeeld foutafhandeling (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;
  }
}