Source: https://aiprimetech.io/it/docs/getting-started/quickstart/

[Home](/it/) / [Documentazione](/it/docs/) / Avvio rapido 

# Avvio rapido 

Ottieni una chiave, imposta due variabili d'ambiente ed effettua la tua prima richiesta in circa un minuto. 

 Copia pagina [ Visualizza in Markdown](/it/docs/getting-started/quickstart.md) [ Chiedi a ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/getting-started/quickstart.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Chiedi in Claude](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/getting-started/quickstart.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

Questa pagina ti guida da zero fino a ottenere una risposta funzionante. Presuppone solo curl; le versioni degli SDK sono riportate in [SDK](/it/docs/sdks/). 

## Passaggio 1 — Crea una chiave 
- [Registra un account](/register) e conferma il tuo indirizzo email.
- [Ricarica i crediti](/it/topup/) o [acquista un piano illimitato](/it/plans/). I nuovi account ricevono un bonus sulla prima ricarica in criptovaluta: consulta [Prezzi](/it/docs/billing/pricing/).
- 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 

```
Copyexport CLAUDEAPIKEY="sk-your-key-here"
```

## Passaggio 3 — Chiama l'API 

### Formato Anthropic 

```
Copycurl 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: 

```
Copycurl 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 

```
Copycurl 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: 

```
Copyexport 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](/it/docs/guides/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](/it/topup/) o [acquista un piano](/it/plans/)

 | 404 su /v1/chat/completions | Il client chiama il percorso Anthropic con un corpo OpenAI, o viceversa | Abbina il formato all'endpoint: consulta [Panoramica](/it/docs/api-reference/overview/)

 | model_not_found | L'ID del modello non è scritto esattamente come restituito da /v1/models | Copia l'ID dall'endpoint dei modelli 

[AutenticazioneRiferimento per header e variabili d'ambiente](/it/docs/getting-started/authentication/)[API MessagesSchema completo di richiesta e risposta](/it/docs/api-reference/messages/)[ErroriTutti i codici di stato e il loro significato](/it/docs/api-reference/errors/) 

[PrecedenteIntroduzione](/it/docs/getting-started/introduction/)[AvantiAutenticazione](/it/docs/getting-started/authentication/)