Référence développeur Nano Banana Pro API
Guide complet pour développeurs de la plateforme Nano Banana Pro API, alimentée par des technologies avancées d'apprentissage automatique
Aperçu de Nano Banana Pro API
Le service Visual Production de Nano Banana Pro API permet aux développeurs de se connecter à des moteurs d'apprentissage automatique avancés pour produire des images de haute qualité à partir de textes d'invite et de photos de référence. Notre solution propose une interface REST simple, une gestion complète des tâches et des notifications en temps réel.
Principales fonctionnalités de Nano Banana Pro API
- • Conversion texte-en-image via des moteurs d'apprentissage automatique de pointe
- • Support d'images de référence (jusqu'à 4 images)
- • Traitement asynchrone des tâches avec suivi de progression en temps réel
- • Notifications via webhook pour les changements d'état immédiats
- • Interface REST renvoyant des données JSON structurées
- • Mécanisme d'authentification par token Bearer
overview.base_url
https://api.defapi.orgoverview.api_version
v1.0.0Démarrage rapide de Nano Banana Pro API
- 1. Créez un compte Nano Banana Pro API et obtenez vos identifiants sur notre site officiel
- 2. Ajoutez votre token d'authentification Nano Banana Pro API dans l'en-tête Authorization
- 3. Envoyez une requête POST au endpoint de génération d'images de Nano Banana Pro API
- 4. Utilisez l'ID de tâche renvoyé par Nano Banana Pro API pour vérifier l'état du traitement
- 5. Récupérez vos images générées par Nano Banana Pro API une fois le traitement terminé
Authentification d'accès
Toutes les requêtes API doivent inclure une authentification valide via un jeton Bearer. Incluez votre clé API dans l'en-tête Authorization pour chaque requête.
Méthode d'authentification
Utilisez l'authentification par jeton Bearer HTTP en incluant vos identifiants API dans l'en-tête Authorization :
Authorization: Bearer <your-api-key>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
- ✅ Les identifiants API n'ont pas expiré
- ✅ Le compte est en règle
- ✅ Solde du compte suffisant
Problèmes courants
- ❌ Identifiants API manquants dans la requête
- ❌ Clé API invalide ou mal formatée
- ❌ Compte désactivé ou accès au compte révoqué
Génération d'images - Nano Banana Pro API
Créez des images avec l'API Nano Banana Pro utilisant des technologies d'apprentissage automatique avancées. Utilisez des prompts textuels et des images de référence.
Point de terminaison API
POST /api/image/genParamètres de la 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 d'utilisation
Création d'image basique avec l'API Nano Banana Pro
{
"model": "google/gempix2",
"prompt": "A beautiful girl dancing in a garden"
}Génération basée sur références avec images d'exemple - API Nano Banana Pro
{
"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"
}
}Gestion des erreurs
400 - Bad Request
{"code": 1, "message": "failed", "detail": "prompt is required"}401 - Unauthorized
{"code": 1, "message": "Invalid API key"}Statut des tâches de l'API Nano Banana Pro
Consulter le statut et les résultats des tâches de génération d'images de l'API Nano Banana Pro. Utilisez l'ID de tâche renvoyé par l'endpoint de génération d'images.
Point de terminaison de l'API
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"
Types de statut des tâches de l'API Nano Banana Pro
pending - La tâche de l'API Nano Banana Pro a été créée et attend le début du traitementsubmitted - La tâche de l'API Nano Banana Pro a été mise en file d'attente pour traitementin_progress - La tâche de l'API Nano Banana Pro est en cours de traitementsuccess - La tâche de l'API Nano Banana Pro s'est terminée avec succès et les images générées sont prêtesfailed - La tâche de l'API Nano Banana Pro a rencontré une erreur et n'a pas pu être terminéeRéponses d'erreur
404 - Task Not Found
{"code": 1, "message": "task not found"}401 - Unauthorized
{"code": 401, "message": "Invalid API key"}Structures de données de l'API Nano Banana Pro
Référence complète des formats de données et schémas utilisés dans les requêtes et réponses de l'API Nano Banana Pro.
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 pris en charge par l'API Nano Banana Pro
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 interpréter les codes de réponse API. Tous les messages d'erreur suivent un format cohérent pour faciliter le dépannage.
Codes d'état 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 des erreurs
- Toujours vérifier les codes d'état HTTP avant de traiter la réponse
- Mettre en place un backoff exponentiel pour les réessais en cas d'erreurs 500
- Consigner les messages d'erreur avec le contexte complet pour le débogage
- Valider les paramètres d'entrée avant d'envoyer les requêtes pour éviter les erreurs 400
- Résoudre les problèmes d'authentification en demandant aux clients de rafraîchir leurs identifiants API
- Surveiller l'avancement des tâches à intervalles raisonnables au lieu de sonder sans cesse
- Utiliser des webhooks quand c'est possible pour éviter de sonder en permanence l'état d'achèvement
Exemple de gestion des 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;
}
}