Riferimento API
apikey.sh parla il protocollo OpenAI. Qualsiasi SDK, framework o tool che già funziona con OpenAI funziona anche qui cambiando base_url.Guida rapida
Crea una chiave nella dashboard, mettila in una variabile d'ambiente, poi imposta la base URL:from openai import OpenAI
client = OpenAI(
api_key="sk-ak-...", # your key from apikey.sh
base_url="https://apikey.sh/v1", # change only this line
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)Base URL
La stessa chiave API funziona su tutti i domini qui sotto — scegli quello che preferisci.L'SDK Anthropic usa la base URL senza /v1 (per esempio https://apikey.sh).
https://apikey.sh/v1attivohttps://api.onie.net/v1attivoAutenticazione
Invia la chiave in un header:
Authorization: Bearer sk-ak-... # or, with the Anthropic SDK: x-api-key: sk-ak-...La chiave viene mostrata una sola volta, alla creazione. Se la perdi creane una nuova e revoca la vecchia — la revoca è immediata.
Endpoint
| POST | /v1/chat/completions | Genera completions (supporta SSE streaming e tool calling) |
| POST | /v1/embeddings | Crea embedding per RAG e ricerca semantica |
| POST | /v1/images/generations | Genera immagini (modelli gpt-image-*) |
| GET | /v1/models | Elenca i modelli disponibili per la chiave corrente |
Streaming
Aggiungi stream: true per ricevere i token in tempo reale via SSE:
stream = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Write a short poem"}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="")Prompt caching
Sui modelli supportati (la linea GPT-5.x) il prefisso ripetuto del prompt viene messo in cache automaticamente e fatturato alla tariffa cache — circa il 90% in meno dei token nuovi. Non devi cambiare nulla nel codice; i token serviti dalla cache sono visibili in Consumo nella dashboard.Le risposte includono usage.prompt_tokens_details.cached_tokens per fare la verifica da solo.
Limiti per chiave
Ogni chiave può avere il proprio tetto di spesa e il proprio elenco di modelli consentiti. È il modo sicuro di condividere le chiavi tra progetti o colleghi senza che uno solo prosciughi il budget. Si configura in Dashboard → Chiavi API.
Codici di errore
401 | Chiave non valida, revocata o account sospeso |
402 | Credito esaurito — ricarica dalla dashboard |
403 | Modello non incluso nell'elenco consentito della chiave |
429 | Limite di richieste della chiave superato |
5xx | Errore del provider a monte — riprova tra qualche secondo |