Chiave API GPT Image 2: come ottenere l'accesso e fare la prima richiesta

Sì, GPT Image 2 ha un'API e su SeedRouter basta una chiave API per accedervi. Accedi, crea una chiave nella pagina chiavi API, aggiungi crediti nella pagina di fatturazione e invia la chiave in un header Authorization: Bearer a https://api.seedrouter.ai/v1/images/generations. La chiave viene mostrata per intero una sola volta, al momento della creazione, quindi copiala subito nell'ambiente del tuo server.

I passaggi qui sotto ti portano da zero account a un'immagine finita e coprono i quattro errori che bloccano la maggior parte delle prime richieste.

Come si ottiene una chiave API GPT Image 2?

1. Accedi a SeedRouter con il tuo account Google.
2. Apri chiavi API e crea una chiave. Dalle un nome che indichi dove verrà usata, per esempio production-server.
3. Copia subito la chiave. Dopo questa schermata ne vedi solo una versione mascherata, e una chiave persa non si può recuperare: revocala e creane una nuova.
4. Aggiungi crediti nella pagina di fatturazione. Una chiave funziona non appena esiste, ma una richiesta ha bisogno di crediti per essere eseguita.

Una sola chiave dà accesso a tutti i modelli di SeedRouter, quindi non ti serve una chiave separata per GPT Image 2 e GPT Image 2.5. Crea piuttosto chiavi separate per ogni ambiente: così revocare la chiave di staging non può rompere la produzione.

Dove va conservata la chiave API?

Sul tuo server, in una variabile d'ambiente, e da nessun'altra parte:

export SEEDROUTER_API_KEY="your-key"

Non mettere mai la chiave nel JavaScript del browser, nel pacchetto di un'app mobile o in un repository pubblico. Chiunque la legga può spendere i tuoi crediti. Se il tuo prodotto ha un front end, fai in modo che chiami il tuo back end, e lascia che sia il back end a chiamare l'API con la chiave.

Se una chiave viene esposta, revocala subito nella pagina chiavi API. Una chiave revocata smette di funzionare e le richieste che la usano vengono rifiutate.

Come si fa la prima richiesta con la chiave?

Invia la chiave come bearer token. La risposta è un riferimento all'attività, non l'immagine:

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "An amber glass bottle on a cream background, studio lighting",
    "size": "1024x1024",
    "quality": "low"
  }'

Salva l'id dalla risposta e interroga GET https://api.seedrouter.ai/v1/tasks/{id} con lo stesso header finché status non è completed. L'attività completata elenca gli URL delle immagini. Per un ciclo completo in codice, vedi l'API GPT Image 2 in Python.

Due ID modello servono GPT Image 2 con gli stessi campi: gpt-image-2 applica un prezzo fisso per immagine consegnata, mentre gpt-image-2-official addebita i token che ogni generazione riporta. La chiave funziona con entrambi. I prezzi correnti sono nella pagina del modello.

Quali errori incontra di solito una nuova chiave API?

Due sviste causano la maggior parte dei fallimenti alla prima richiesta. La prima è una chiave incollata con un carattere mancante o uno spazio di troppo, che restituisce 10001. La seconda è copiare il nome del modello da un titolo, come gpt-image-2.0 o GPT Image 2, invece dell'ID modello, che restituisce 20002. Entrambe vengono rifiutate prima che inizi qualsiasi lavoro, quindi non viene addebitato nulla.

Esiste una chiave API GPT Image 2 gratis?

No. Creare una chiave è gratuito, ma le richieste vengono pagate con crediti prepagati. Quello che non paghi è il fallimento: un'attività che termina failed, o che non restituisce alcuna immagine, non costa nulla. I crediti si acquistano con ricariche una tantum, non scadono mai e non prevedono abbonamento, quindi una piccola prima ricarica basta per testare a fondo un'integrazione.

Si può usare una chiave da Python e JavaScript?

Sì. La chiave è una stringa in un header HTTP, quindi qualsiasi linguaggio in grado di inviare una richiesta HTTP può usarla. Leggila dall'ambiente in ogni runtime: os.environ["SEEDROUTER_API_KEY"] in Python e process.env.SEEDROUTER_API_KEY in Node.js. Tieni il JavaScript lato server; la stessa chiave nel codice del browser è esposta a ogni visitatore.

Domande frequenti

Mi serve una chiave API OpenAI per usare GPT Image 2 qui?

No. La tua chiave SeedRouter è l'unica credenziale che invii. Non devi creare né gestire un account separato altrove per chiamare GPT Image 2 tramite questa API.

Quante chiavi API posso creare?

Abbastanza per averne una per ogni server o servizio; il limite per account è molto al di sopra di ciò che serve a un'integrazione. Ogni chiave si può revocare singolarmente.

Dove vedo quanto ha speso una chiave?

Nello storico di utilizzo. Ogni richiesta riporta il modello e l'addebito, così è facile confrontare una nuova integrazione con la tua stima.

Tieni la chiave sul server e vai in produzione

Crea una chiave per ogni ambiente, conservala in una variabile d'ambiente e inviala come bearer token solo dal tuo back end. Quando la prima richiesta restituisce l'id di un'attività, la parte di accesso è fatta; tutto il resto è nella documentazione dell'API GPT Image 2.