Per iniziare con Nano Banana Pro API

Nano Banana Pro API è un'interfaccia pratica e pronta per la produzione per generare immagini con gli ultimi modelli basati su Gemini. Questa guida a Nano Banana Pro API si concentra sull'uso nel mondo reale: come creare prompt, strutturare richieste, interpretare risposte e costruire un flusso di lavoro su cui il tuo prodotto può fare affidamento.

Se desideri la panoramica ufficiale, le demo e il contesto del prodotto di Nano Banana 2, inizia dall'hub Nano Banana 2.

Cos'è Nano Banana Pro API?

Nano Banana Pro API ti offre una semplice interfaccia REST per la generazione di immagini di alta qualità. Invii un prompt e riferimenti opzionali e ricevi output di immagini che puoi archiviare e distribuire nella tua app. È progettata per i team che necessitano di risultati coerenti, flussi di lavoro ripetibili e modelli di integrazione prevedibili.

Quando usare Nano Banana Pro API

Usa Nano Banana Pro API quando desideri elementi visivi veloci e on-demand senza costruire una pipeline di modelli interna:

• Contenuti di marketing per annunci e landing page
• Immagini di prodotto per cataloghi ed elenchi e-commerce
• Bozze creative per concetti iniziali e mood board

Capacità principali

L'API è costruita attorno ad alcuni punti di forza fondamentali che contano nella produzione:

• Generazione text-to-image per trasformare il linguaggio naturale in immagini
• Creazione image-to-image per remixare o costruire su scatti esistenti
• Output consapevoli dei riferimenti per mantenere coerenti stile e soggetto
• Prestazioni scalabili per alimentare lavori in batch e flussi di lavoro automatizzati

Avvio rapido di Nano Banana Pro API

1. Ottieni l'accesso

Crea un account nella dashboard di EvoLink, quindi genera una chiave API per il tuo progetto. Conserva la chiave in un archivio segreto sicuro e non esporla mai nel codice lato client.

2. Fai la tua prima richiesta

Ecco un esempio cURL minimo. Sostituisci i segnaposto con i tuoi valori effettivi.

curl -X POST "API_BASE/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "prompt": "A beautiful sunset over mountains, digital art style",
    "size": "ASPECT_RATIO",
    "quality": "RESOLUTION_TIER"
  }'

3. Gestire la risposta

La risposta di solito include metadati e un elenco di URL o ID immagine. Salva rapidamente i risultati e archiviali nel tuo livello di archiviazione per l'accesso a lungo termine.

{
  "created": 1737014400,
  "data": [
    {
      "url": "IMAGE_URL"
    }
  ]
}

Parametri principali che dovresti conoscere

Questi sono i parametri che userai più spesso quando chiami Nano Banana Pro API:

• model: Usa il modello abilitato per il tuo account. Scegli un livello economico per le bozze e un livello premium per le risorse finali.
• prompt: Il tuo testo di istruzione. Sii esplicito su soggetto, stile e atmosfera.
• size: Le proporzioni o il preset di dimensione che si adatta al tuo posizionamento (quadrato, verticale o orizzontale).
• quality: Il livello di risoluzione necessario per l'output finale.
• image_urls: Immagini di riferimento opzionali se desideri mantenere coerenti soggetto o stile.

Lavori asincroni e URL immagine

Molti team eseguono l'API in modo asincrono: invia un lavoro, interroga l'attività finché non termina, quindi scarica e archivia l'immagine. Gli URL possono avere una scadenza, quindi trattali come effimeri e spostali nel tuo archivio non appena sono pronti.

Playbook dei Prompt

Il modo più rapido per migliorare i risultati è utilizzare una struttura di prompt chiara. Una formula semplice funziona bene:

Soggetto + Contesto + Stile + Illuminazione + Composizione + Qualità

Ecco altri consigli pratici sui prompt:

1. Sii specifico - Nomina il soggetto e descrivi i dettagli chiave.
2. Definisci lo stile - Fotorealistico, acquerello, cinematografico, editoriale.
3. Controlla la composizione - Primo piano, campo largo, vista dall'alto o centrato.

Esempi di Prompt

Controllo qualità e iterazione

Tratta la generazione come un ciclo di progettazione veloce. Inizia con un prompt ampio, quindi itera:

• Aggiungi o rimuovi dettagli in base al primo output.
• Blocca uno stile prima di perfezionare un soggetto.
• Salva i migliori prompt in modo che il tuo team possa riutilizzarli in seguito.
• Usa immagini di riferimento quando la coerenza è importante in una serie.

Checklist di produzione

Usa questa checklist prima di distribuire Nano Banana Pro API nel tuo flusso di lavoro:

• Chiave API archiviata in un archivio segreto sicuro lato server
• Prompt di base documentati per i tuoi casi d'uso principali
• Immagini di output salvate in un archivio permanente

Riepilogo

Nano Banana Pro API è un modo affidabile per generare elementi visivi di alta qualità con un'interfaccia REST pulita. Inizia con prompt chiari, itera rapidamente e documenta i tuoi migliori risultati. Per i team che distribuiscono velocemente, questo mantiene il flusso creativo in movimento senza strumenti pesanti.