Documentation API GemPix2

Documentation API complète pour le Service de Génération d'Images GemPix2 utilisant les modèles IA Google Gemini

Obtenir le PrixVoir les tarifs GemPix2

Aperçu de l'API GemPix2

L'API de Génération d'Images GemPix2 donne accès aux modèles IA Google Gemini pour générer des images de haute qualité à partir de prompts texte et d'images de référence. Notre service GemPix2 offre une interface RESTful simple avec une gestion complète des tâches et un support de callback.

Fonctionnalités Clés de GemPix2

  • Génération GemPix2 texte-vers-image utilisant les modèles IA Google Gemini
  • Support GemPix2 pour les images de référence (jusqu'à 4 images)
  • Traitement GemPix2 asynchrone des tâches avec suivi du statut
  • Support GemPix2 de callback webhook pour les notifications en temps réel
  • API GemPix2 RESTful avec réponses JSON
  • Authentification GemPix2 par token Bearer

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

Démarrage avec GemPix2

  1. 1. Inscrivez-vous pour obtenir une clé API GemPix2 sur notre serveur de production
  2. 2. Incluez votre clé API GemPix2 dans l'en-tête Authorization
  3. 3. Envoyez une requête POST au point de terminaison de génération d'images GemPix2
  4. 4. Utilisez le task_id GemPix2 retourné pour vérifier le statut de génération
  5. 5. Récupérez vos images GemPix2 générées quand la tâche est terminée

Authentification

Toutes les requêtes API doivent être authentifiées en utilisant l'authentification par token Bearer. Incluez votre clé API dans l'en-tête Authorization de chaque requête.

Méthode d'authentification

Utilisez l'authentification HTTP Bearer token en incluant votre clé API dans l'en-tête Authorization :

Authorization: Bearer <your-api-key>

Format d'exemple de clé API

Authorization: Bearer dk-1234567890abcdef

Exemple de requête

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

Authentification valide

  • La clé API est valide
  • Le compte utilisateur est actif
  • Crédits suffisants disponibles

Erreurs courantes

  • Clé API manquante
  • Format de clé API invalide
  • Compte expiré ou inactif

API de génération d'images GemPix2

Générez des images en utilisant GemPix2 avec les modèles IA Google Gemini et des prompts personnalisables et images de référence.

Point de terminaison

POST /api/image/gen

Paramètres de requête

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

Exemples de requête

Génération d'image GemPix2 de base

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

Génération GemPix2 basée sur image avec images de référence

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

Format de réponse

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

Réponses d'erreur

400 - Bad Request

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

401 - Unauthorized

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

API de Requête de Tâche GemPix2

Interroger le statut et les résultats des tâches de génération d'images GemPix2 en utilisant l'ID de tâche retourné par l'endpoint de génération d'images GemPix2.

Point de terminaison

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

Paramètres de requête

ParameterTypeRequiredDescription
task_idstringYesUnique task identifier returned from generation endpoint

Exemple de requête

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

Valeurs de statut des tâches GemPix2

pending - La tâche GemPix2 a été créée et attend d'être traitée
submitted - La tâche GemPix2 a été soumise à la file de génération
in_progress - La tâche GemPix2 est actuellement en cours de traitement
success - La tâche GemPix2 s'est terminée avec succès avec des images générées
failed - La tâche GemPix2 a échoué en raison d'une erreur

Réponses d'erreur

404 - Task Not Found

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

401 - Unauthorized

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

Modèles de données GemPix2

Référence complète pour tous les modèles de données et schémas GemPix2 utilisés dans les réponses et requêtes de l'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

Modèles GemPix2 disponibles

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

Gestion des erreurs

Guide complet pour gérer les erreurs et comprendre les codes de réponse de l'API. Toutes les réponses d'erreur suivent un format cohérent pour vous aider à résoudre efficacement les problèmes.

Codes de statut 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

Bonnes pratiques de gestion d'erreurs

  1. 1. Vérifiez toujours les codes de statut HTTP avant de traiter le corps de la réponse:
  2. 2. Implémentez un délai exponentiel pour la logique de nouvelle tentative sur les erreurs 500:
  3. 3. Enregistrez les réponses d'erreur avec des informations détaillées pour le débogage:
  4. 4. Validez les entrées avant d'envoyer des requêtes pour éviter les erreurs 400:
  5. 5. Gérez les erreurs d'authentification en demandant aux utilisateurs de mettre à jour leurs clés API:
  6. 6. Surveillez le statut des tâches périodiquement au lieu d'interroger trop fréquemment:
  7. 7. Utilisez des webhooks quand c'est possible pour éviter d'interroger l'achèvement des tâches:

Exemple de gestion d'erreurs (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;
  }
}