Documentation API GemPix2
Documentation API complète pour le Service de Génération d'Images GemPix2 utilisant les modèles IA Google Gemini
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.orgoverview.api_version
v1.0.0Démarrage avec GemPix2
- 1. Inscrivez-vous pour obtenir une clé API GemPix2 sur notre serveur de production
- 2. Incluez votre clé API GemPix2 dans l'en-tête Authorization
- 3. Envoyez une requête POST au point de terminaison de génération d'images GemPix2
- 4. Utilisez le task_id GemPix2 retourné pour vérifier le statut de génération
- 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-1234567890abcdefExemple 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/genParamètres de requête
| Parameter | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | Model identifier (e.g., "google/gempix2") |
| prompt | string | Yes | Text prompt describing the image |
| images | array | No | Reference image URLs (max 4) |
| callback_url | string | No | Webhook 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
| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | Yes | Unique 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éesubmitted - La tâche GemPix2 a été soumise à la file de générationin_progress - La tâche GemPix2 est actuellement en cours de traitementsuccess - La tâche GemPix2 s'est terminée avec succès avec des images généréesfailed - La tâche GemPix2 a échoué en raison d'une erreurRé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"
}| Field | Type | Description |
|---|---|---|
| image | string | Image 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
}
}| Field | Type | Description |
|---|---|---|
| result | array | Array of ImageGenResult objects (null if failed) |
| status | string | Final task status (success/failed) |
| task_id | string | Unique task identifier |
| consumed | string | Credits consumed by the task |
| status_reason | object | Status details including error message if failed |
Modèles GemPix2 disponibles
google/gempix2Nano Banana image generation modelgoogle/gemini-2.5-flash-imageGemini 2.5 Flash image modelGestion 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
OK
Request was successful
Bad Request
Invalid request parameters or malformed JSON
Unauthorized
Invalid, missing, or expired API key
Not Found
Task not found or endpoint doesn't exist
Internal Server Error
Server-side error occurred
Bonnes pratiques de gestion d'erreurs
- 1. Vérifiez toujours les codes de statut HTTP avant de traiter le corps de la réponse:
- 2. Implémentez un délai exponentiel pour la logique de nouvelle tentative sur les erreurs 500:
- 3. Enregistrez les réponses d'erreur avec des informations détaillées pour le débogage:
- 4. Validez les entrées avant d'envoyer des requêtes pour éviter les erreurs 400:
- 5. Gérez les erreurs d'authentification en demandant aux utilisateurs de mettre à jour leurs clés API:
- 6. Surveillez le statut des tâches périodiquement au lieu d'interroger trop fréquemment:
- 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;
}
}