GPT-Image 2.6 Flare e Sunburst sono disponibiliDa $0.025 per immagine
OmniaKey
Accedi

Configurazione della chiave API

Chiave API Nano Banana: ottenere, configurare e testare

Prima di configurare la chiave API Nano Banana, scelga chi la emette. Chiave, URL dell’API e ID del modello devono corrispondere. I passaggi seguenti configurano l’accesso tramite OmniaKey.

Chiave ufficiale del fornitore

Per una chiave emessa e fatturata direttamente da Google, segua le istruzioni dell'account e della chiave API del fornitore.

Apri le istruzioni della chiave ufficiale

Chiave API OmniaKey

Usi un unico saldo e un'unica chiave OmniaKey per i modelli disponibili sul suo account. La chiave funziona con l'endpoint OmniaKey.

Ottieni una chiave API

01Crei una chiave API OmniaKey

Acceda, apra API Keys e crei una chiave per la sua applicazione. Controlli quota, scadenza e restrizioni sui modelli. Aggiunga saldo prima di avviare richieste di generazione.

Ottieni una chiave API

02Imposti chiave e URL dell'API

Esegua i comandi nel proprio terminale e sostituisca il segnaposto con la chiave. Conservi la chiave sul server o in un gestore di segreti. Non la inserisca mai nel codice del browser né in un repository pubblico.

bash / zsh
export OMNIAKEY_API_KEY="YOUR_OMNIAKEY_API_KEY"
export OMNIAKEY_BASE_URL="https://api.omniakey.com/v1"

03Verifichi l'autenticazione

Richieda l'elenco dei modelli senza avviare un'attività di generazione. Una risposta riuscita è JSON con un array data. Questo verifica l'accesso della chiave; non dimostra che ogni modello sia abilitato per il suo account.

GET /v1/models
curl --fail-with-body "$OMNIAKEY_BASE_URL/models" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

04Usi il formato di richiesta del modello

Selezioni un modello nella pagina della famiglia, copi il suo ID API e segua la documentazione API corrispondente. La sola autenticazione non verifica i parametri di generazione.

La generazione di immagini e video usa POST /v1/media/tasks. Mantenga la stessa Idempotency-Key quando reinvia la stessa richiesta, salvi l'ID attività restituito e interroghi GET /v1/media/tasks/{id} per il risultato.

Richiesta di generazione di esempio (a pagamento)

Questa richiesta usa il saldo dell'account. Controlli prima il prezzo del modello scelto. L'esempio segue il formato di richiesta documentato; l'account deve comunque avere accesso al modello.

POST /v1/media/tasks
curl --fail-with-body 'https://api.omniakey.com/v1/media/tasks' \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: nano-banana-first-request-001" \
  -d '{
  "model": "gemini-nano-banana-2.1",
  "type": "image",
  "operation": "generate",
  "input": {
    "prompt": "A paper boat on a quiet lake at sunset."
  },
  "parameters": {
    "image_size": "1K",
    "aspect_ratio": "1:1"
  }
}'

Interroga l'attività media

Sostituisca YOUR_TASK_ID con l'ID restituito dalla richiesta di creazione. Interroghi finché l'attività non raggiunge uno stato finale. Per un'attività riuscita, scarichi gli URL in assets prima che scadano. Usi una nuova chiave di idempotenza solo per una nuova attività.

GET /v1/media/tasks/{id}
curl --fail-with-body "https://api.omniakey.com/v1/media/tasks/YOUR_TASK_ID" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"
Leggi la documentazione API

Se la connessione non riesce

  • 401: controlli che la chiave sia completa, attiva ed emessa per l'URL API che sta chiamando.
  • 403: controlli le restrizioni sui modelli della chiave e i permessi disponibili per il suo account.
  • 404 o HTML al posto di JSON: controlli l'host dell'API e il prefisso di versione. Usi api.omniakey.com, non l'indirizzo del sito.
  • 429: riduca la concorrenza e segua le indicazioni di retry della risposta. Non reinvii le attività di generazione con nuove chiavi di idempotenza.