Riferimento per Sviluppatori API Nano Banana Pro

Il servizio di produzione visiva dell'API Nano Banana Pro permette agli sviluppatori di connettersi a motori di machine learning avanzati per produrre immagini di alta qualità da prompt testuali e fotografie di riferimento. La nostra soluzione API Nano Banana Pro fornisce un'interfaccia REST semplice con funzionalità complete di gestione delle attività e notifiche in tempo reale.

Tutte le richieste API devono includere un'autenticazione valida tramite le credenziali del token Bearer. Includi la tua chiave API nell'header Authorization per ogni richiesta.

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

Crea immagini usando l'API Nano Banana Pro con tecnologie di machine learning avanzate e prompt testuali flessibili, insieme a immagini di riferimento.

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

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

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

Usa l'ID del task per controllare lo stato e i risultati della generazione immagini dell'API Nano Banana Pro.

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

Riferimento completo a tutti i formati dati e schemi dell'API Nano Banana Pro usati nelle richieste e risposte.

{
  "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
}

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

Guida completa per gestire gli errori e interpretare i codici di risposta delle API. Tutti i messaggi di errore seguono un formato coerente per facilitare la risoluzione dei problemi.

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;
  }
}