Avvio rapido
Ottieni una chiave, imposta due variabili d'ambiente ed effettua la tua prima richiesta in circa un minuto.
Questa pagina ti guida da zero fino a ottenere una risposta funzionante. Presuppone solo curl; le versioni degli SDK sono riportate in SDK.
Passaggio 1 — Crea una chiave
- Registra un account e conferma il tuo indirizzo email.
- Ricarica i crediti o acquista un piano illimitato. I nuovi account ricevono un bonus sulla prima ricarica in criptovaluta: consulta Prezzi.
- Apri la dashboard, vai a Chiavi APIe crea una chiave. Inizia con
sk-. - Copiala subito: il valore completo viene mostrato una sola volta.
Passaggio 2 — Esportala
export CLAUDEAPIKEY="sk-your-key-here"
Passaggio 3 — Chiama l'API
Formato Anthropic
curl https://aiprimetech.io/v1/messages \
-H "x-api-key: $CLAUDEAPIKEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello"}]
}'
Formato OpenAI
Modelli identici, struttura del messaggio diversa: scegli quella compatibile con il tuo client:
curl https://aiprimetech.io/v1/chat/completions \
-H "Authorization: Bearer $CLAUDEAPIKEY" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [{"role": "user", "content": "Hello"}]
}'
Passaggio 4 — Verifica a cosa puoi accedere
curl https://aiprimetech.io/v1/models \
-H "Authorization: Bearer $CLAUDEAPIKEY"
La risposta restituisce tutti gli ID dei modelli a cui la tua chiave può accedere. Usa questi ID senza modificarli nel model campo.
Passaggio 5 — Configura uno strumento reale per usarla
Per Claude Code, l'intera configurazione si riduce a due variabili:
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_AUTH_TOKEN="$CLAUDEAPIKEY"
claude
Se
ANTHROPIC_API_KEY è già impostata nella tua shell, Claude Code potrebbe addebitare l'utilizzo a quella chiave e ignorare il tuo abbonamento senza avvisarti. Rimuovila quando passi da una configurazione all'altra. Consulta Claude Code.Risoluzione dei problemi della prima chiamata
| Sintomo | Causa | Soluzione |
|---|---|---|
401 | Chiave mancante, digitata in modo errato o inviata nell'header sbagliato | Il formato Anthropic usa x-api-key; il formato OpenAI usa Authorization: Bearer |
402 | Nessun credito e nessun piano attivo | Ricarica o acquista un piano |
404 su /v1/chat/completions | Il client chiama il percorso Anthropic con un corpo OpenAI, o viceversa | Abbina il formato all'endpoint: consulta Panoramica |
model_not_found | L'ID del modello non è scritto esattamente come restituito da /v1/models | Copia l'ID dall'endpoint dei modelli |