Home / Documentazione / Avvio rapido

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

  1. Registra un account e conferma il tuo indirizzo email.
  2. Ricarica i crediti o acquista un piano illimitato. I nuovi account ricevono un bonus sulla prima ricarica in criptovaluta: consulta Prezzi.
  3. Apri la dashboard, vai a Chiavi APIe crea una chiave. Inizia con sk-.
  4. 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

SintomoCausaSoluzione
401Chiave mancante, digitata in modo errato o inviata nell'header sbagliatoIl formato Anthropic usa x-api-key; il formato OpenAI usa Authorization: Bearer
402Nessun credito e nessun piano attivoRicarica o acquista un piano
404 su /v1/chat/completionsIl client chiama il percorso Anthropic con un corpo OpenAI, o viceversaAbbina il formato all'endpoint: consulta Panoramica
model_not_foundL'ID del modello non è scritto esattamente come restituito da /v1/modelsCopia l'ID dall'endpoint dei modelli