Guida Tecnica API Nano Banana 2
Documentazione tecnica approfondita per il Servizio di Produzione Visiva Nano Banana 2 che utilizza sofisticate capacità di intelligenza artificiale
Introduzione all'API Nano Banana 2
L'API di Produzione Visuale Nano Banana 2 permette l'integrazione con sistemi di intelligenza artificiale avanzati per creare immagini di alta qualità da descrizioni testuali e grafiche di esempio. La nostra piattaforma Nano Banana 2 offre un'architettura REST semplice con ampie capacità di coordinazione dei lavori e notifiche.
Funzionalità Principali di Nano Banana 2
- • Trasformazione testo-immagine Nano Banana 2 utilizzando sistemi di intelligenza artificiale all'avanguardia
- • Compatibilità Nano Banana 2 con grafiche di esempio (massimo 4 immagini)
- • Esecuzione non-bloccante dei lavori Nano Banana 2 con monitoraggio dei progressi
- • Integrazione webhook Nano Banana 2 per aggiornamenti di stato istantanei
- • Architettura REST Nano Banana 2 che fornisce risposte in formato JSON
- • Sistema di verifica credenziali Bearer Nano Banana 2
overview.base_url
https://api.defapi.orgoverview.api_version
v1.0.0Guida all'Implementazione di Nano Banana 2
- 1. Registrati per ottenere le credenziali API Nano Banana 2 attraverso la nostra piattaforma principale
- 2. Inserisci il tuo token di accesso Nano Banana 2 nel parametro Authorization
- 3. Invia una richiesta POST al terminale di creazione visuale Nano Banana 2
- 4. Utilizza l'identificatore di lavoro Nano Banana 2 fornito per la verifica dello stato
- 5. Ottieni le tue immagini fabbricate Nano Banana 2 al completamento del compito
Verifica dell'Identità
Ogni richiesta API richiede autenticazione tramite verifica del token Bearer. Includi le tue credenziali di accesso nel parametro Authorization per ogni trasmissione.
Metodo di Verifica
Implementa la validazione del token HTTP Bearer incorporando le tue credenziali di accesso nel parametro Authorization:
Authorization: Bearer <your-api-key>Struttura Chiave di Accesso di Esempio
Authorization: Bearer dk-1234567890abcdefDimostrazione di Invio
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"
}'Verifica Riuscita
- ✅ Le credenziali di accesso rimangono attuali
- ✅ La registrazione del client mantiene lo stato attivo
- ✅ I crediti del servizio adeguati persistono
Problemi Frequenti
- ❌ Credenziali di accesso assenti
- ❌ Configurazione della chiave di accesso errata
- ❌ Registrazione disattivata o sospesa
API di Produzione Visuale Nano Banana 2
Crea immagini utilizzando Nano Banana 2 con sistemi di intelligenza artificiale sofisticati e prompt testuali adattabili più immagini di esempio.
Terminale di Connessione
POST /api/image/genVariabili di Invio
| 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 |
Illustrazioni di Implementazione
Creazione Visuale Fondamentale Nano Banana 2
{
"model": "google/gempix2",
"prompt": "A beautiful girl dancing in a garden"
}Produzione Basata su Riferimento Nano Banana 2 con Grafiche di Esempio
{
"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"
}Struttura di Output
{
"code": 0,
"message": "ok",
"data": {
"task_id": "ta12345678-1234-1234-1234-123456789abc"
}
}Gestione dei Problemi
400 - Bad Request
{"code": 1, "message": "failed", "detail": "prompt is required"}401 - Unauthorized
{"code": 1, "message": "Invalid API key"}API Stato Lavoro Nano Banana 2
Investiga il progresso e i risultati dei lavori di produzione visiva di Nano Banana 2 utilizzando l'identificatore del compito fornito dal terminale di creazione visiva di Nano Banana 2.
Terminale di Connessione
GET /api/task/query?task_id=<task_id>Variabili di Investigazione
| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | Yes | Unique task identifier returned from generation endpoint |
Illustrazione di Invio
curl -X GET "https://api.defapi.org/api/task/query?task_id=ta823dfb-eaac-44fd-aec2-3e2c7ba8e071" \ -H "Authorization: Bearer your-api-key-here"
Categorie Stato Lavoro Nano Banana 2
pending - Inizializzazione lavoro Nano Banana 2 completata in attesa dell'avvio dell'elaborazionesubmitted - Lavoro Nano Banana 2 inserito nella sequenza di produzionein_progress - Lavoro Nano Banana 2 attualmente in fase di elaborazione attivasuccess - Lavoro Nano Banana 2 finalizzato con successo con immagini createfailed - Lavoro Nano Banana 2 terminato a causa di complicazioni tecnicheRisposte ai Problemi
404 - Task Not Found
{"code": 1, "message": "task not found"}401 - Unauthorized
{"code": 401, "message": "Invalid API key"}Strutture Informative Nano Banana 2
Documentazione completa per tutte le configurazioni e i modelli informativi di Nano Banana 2 utilizzati nelle comunicazioni e invii 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 |
Configurazioni Supportate Nano Banana 2
google/gempix2Nano Banana image generation modelgoogle/gemini-2.5-flash-imageGemini 2.5 Flash image modelGestione dei Problemi
Manuale completo per gestire le complicazioni e interpretare gli indicatori di risposta dell'API. Tutte le notifiche di problema seguono una formattazione standardizzata che permette metodologie di risoluzione efficienti.
Indicatori di Risposta 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
Approcci Raccomandati per la Risoluzione dei Problemi
- Verificare sempre gli indicatori di risposta HTTP prima di analizzare il contenuto di output
- Implementare algoritmi di ritardo progressivo per meccanismi di ripetizione durante complicazioni 500
- Documentare le notifiche di problema con dettagli completi per scopi di troubleshooting
- Confermare la validità dell'input prima dell'invio della richiesta per prevenire complicazioni 400
- Affrontare i problemi di verifica richiedendo aggiornamenti delle credenziali API dai clienti
- Monitorare la progressione del lavoro a intervalli ragionevoli piuttosto che eccessive richieste di stato
- Utilizzare l'integrazione webhook quando possibile per eliminare il monitoraggio costante del completamento
Esempio di Gestione Problemi (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;
}
}