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

Visualizza PrezziEsplora le opzioni di abbonamento Nano Banana 2

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.org

overview.api_version

v1.0.0

Guida all'Implementazione di Nano Banana 2

  1. 1. Registrati per ottenere le credenziali API Nano Banana 2 attraverso la nostra piattaforma principale
  2. 2. Inserisci il tuo token di accesso Nano Banana 2 nel parametro Authorization
  3. 3. Invia una richiesta POST al terminale di creazione visuale Nano Banana 2
  4. 4. Utilizza l'identificatore di lavoro Nano Banana 2 fornito per la verifica dello stato
  5. 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-1234567890abcdef

Dimostrazione 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/gen

Variabili di Invio

ParameterTypeRequiredDescription
modelstringYesModel identifier (e.g., "google/gempix2")
promptstringYesText prompt describing the image
imagesarrayNoReference image URLs (max 4)
callback_urlstringNoWebhook 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

ParameterTypeRequiredDescription
task_idstringYesUnique 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'elaborazione
submitted - Lavoro Nano Banana 2 inserito nella sequenza di produzione
in_progress - Lavoro Nano Banana 2 attualmente in fase di elaborazione attiva
success - Lavoro Nano Banana 2 finalizzato con successo con immagini create
failed - Lavoro Nano Banana 2 terminato a causa di complicazioni tecniche

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

Configurazioni Supportate Nano Banana 2

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

Gestione 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

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

Approcci Raccomandati per la Risoluzione dei Problemi

  1. Verificare sempre gli indicatori di risposta HTTP prima di analizzare il contenuto di output
  2. Implementare algoritmi di ritardo progressivo per meccanismi di ripetizione durante complicazioni 500
  3. Documentare le notifiche di problema con dettagli completi per scopi di troubleshooting
  4. Confermare la validità dell'input prima dell'invio della richiesta per prevenire complicazioni 400
  5. Affrontare i problemi di verifica richiedendo aggiornamenti delle credenziali API dai clienti
  6. Monitorare la progressione del lavoro a intervalli ragionevoli piuttosto che eccessive richieste di stato
  7. 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;
  }
}