Vai al contenuto
NotHolyDocs

Inizio

Autenticazione

Invia la chiave API come token Bearer o in x-api-key. Le chiavi appartengono a un'organizzazione e possono avere budget e limiti sui modelli.

Vedi in Markdown

Ogni richiesta ha bisogno di una chiave API. Inviala in uno di questi due header:

HeaderFormato
AuthorizationBearer nh_live_...
x-api-keynh_live_... (quello che inviano gli SDK di Anthropic)
curl
curl https://api.notholy.com/v1/models -H "x-api-key: $NOTHOLY_API_KEY"

Chiavi

Le chiavi si creano nella console, in Chiavi API. Ogni chiave appartiene a un'organizzazione e a un workspace. Il segreto viene mostrato una volta e salvato solo come hash.

Una chiave può avere:

  • Un budget totale e un budget giornaliero in USD. Quando ciò che resta del budget non copre una richiesta, il suo limite di output si riduce per rientrarci, e sotto i 16 token la richiesta riceve 402 key_budget_exceeded.
  • Un elenco di modelli consentiti. Gli altri modelli ricevono 403 key_not_allowed.
  • Una data di scadenza.
  • Un elenco di indirizzi IP o intervalli CIDR consentiti. Gli altri indirizzi ricevono 403 key_not_allowed.

La revoca di una chiave vale dalla richiesta successiva.

Chiavi nel codice

Leggi la chiave dall'ambiente. Non metterla in un commit. Se una chiave finisce in giro, revocala dalla console e creane una nuova.

Non mettere mai una chiave nel codice lato client. Chiama l'API dal tuo server o dal terminale e tieni le chiavi in variabili d'ambiente o in un secret store.

Python
import os
from openai import OpenAI

client = OpenAI(base_url="https://api.notholy.com/v1", api_key=os.environ["NOTHOLY_API_KEY"])

print([m.id for m in client.models.list()])

Errori

StatoCodiceSignificato
401invalid_api_keyChiave assente, sbagliata, revocata o scaduta
403key_not_allowedLa chiave non può usare questo modello, o non può essere usata da questo indirizzo IP
403account_suspendedL'organizzazione è sospesa. Contatta il supporto
403consent_requiredChi ha creato la chiave ha rifiutato o revocato il consenso al trattamento da parte di partner in altri paesi. Può accettarlo dalla console

Prossimi passi