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

Configurazione della chiave API

Chiave API GPT: ottenere, configurare e testare

Prima di configurare la chiave API GPT, 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 OpenAI, 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.

Il client deve supportare il protocollo del modello scelto. Controlli la documentazione del modello prima di passare tra Chat Completions, Responses o un endpoint nativo del fornitore.

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/responses
curl --fail-with-body 'https://api.omniakey.com/v1/responses' \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-6.1-sol",
  "input": "Explain what an API key does in one sentence."
}'
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.