Panoramica

​

Accesso all’API

L’API è resa disponibile tramite la nostra Console web. Puoi utilizzare il Workbench per provare l’API nel browser e poi generare chiavi API nelle Impostazioni Account. Usa gli spazi di lavoro per segmentare le tue chiavi API e controllare la spesa per caso d’uso.

​

Autenticazione

Tutte le richieste all’API di Anthropic devono includere un header x-api-key con la tua chiave API. Se stai utilizzando gli SDK Client, imposterai l’API quando costruisci un client, e poi l’SDK invierà l’header per tuo conto con ogni richiesta. Se ti stai integrando direttamente con l’API, dovrai inviare questo header tu stesso.

​

Tipi di contenuto

L’API di Anthropic accetta sempre JSON nei corpi delle richieste e restituisce JSON nei corpi delle risposte. Dovrai inviare l’header content-type: application/json nelle richieste. Se stai utilizzando gli SDK Client, questo sarà gestito automaticamente.

​

Limiti di dimensione delle richieste

L’API ha una dimensione massima di richiesta di 32 MB per gli endpoint standard, inclusi l’API Messages e l’API Token Counting. Se superi questo limite, riceverai un errore 413 request_too_large da Cloudflare. Endpoint specifici hanno limiti diversi:

• Endpoint standard (Messages, Token Counting): 32 MB
• API Batch: 256 MB
• API Files: 500 MB

​

Header di Risposta

L’API di Anthropic include i seguenti header in ogni risposta:

• request-id: Un identificatore globalmente unico per la richiesta.

• anthropic-organization-id: L’ID dell’organizzazione associato alla chiave API utilizzata nella richiesta.

​

Esempi

curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'

curl https://api.anthropic.com/v1/messages \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-20250514",
    "max_tokens": 1024,
    "messages": [
        {"role": "user", "content": "Hello, world"}
    ]
}'

pip install anthropic

import anthropic

client = anthropic.Anthropic(
    # defaults to os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)
message = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ]
)
print(message.content)

npm install @anthropic-ai/sdk

import Anthropic from '@anthropic-ai/sdk';

const anthropic = new Anthropic({
  apiKey: 'my_api_key', // defaults to process.env["ANTHROPIC_API_KEY"]
});

const msg = await anthropic.messages.create({
  model: "claude-opus-4-20250514",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello, Claude" }],
});
console.log(msg);