Riferimento API
Messages (formato Anthropic)
Modelli su questo endpoint (5)
/v1/messagesIl formato nativo di Anthropic, servito con la stessa chiave bearer. Claude Code e gli SDK anthropic ufficiali funzionano cambiando solo l'URL di base — nessun adattatore, nessuna conversione di formato.
#Parametri della richiesta
modelstringobbligatorioUn ID di modello Claude dalla pagina dei modelli, per esempio claude-opus-5-5.
max_tokensintegerobbligatorioObbligatorio nel formato Anthropic — il limite massimo di output.
messagesarrayobbligatorioTurni in stile Anthropic: {role: user|assistant, content}.
systemstringfacoltativoPrompt di sistema — qui è un campo di primo livello, non un ruolo dei messaggi.
streambooleanfacoltativoTrasmette in streaming eventi SSE nativi Anthropic (message_start, content_block_delta, …).
temperaturenumberfacoltativoDa 0 a 1 nella scala di Anthropic.
toolsarrayfacoltativoDefinizioni degli strumenti Anthropic; i blocchi tool_use tornano in content.
Header anthropic-version
#Errori correlati
- 400 invalid_request_errorCorpo malformato o parametro non supportato per questo modello.
- 401Bearer token non valido o mancante. Su questo percorso non c'è error.code — basati sullo stato.
- 402 insufficient_user_quotaIl saldo del portafoglio non copre la stima pre-riservata.
- 429Limitazione per chiave. Corpo vuoto; attendi Retry-After. Un 429 che contiene insufficient_user_quota indica invece un limite di spesa giornaliero.
- 503 model_not_foundModello sconosciuto, oppure nessun canale funzionante lo serve al momento.
#Esempio di richiesta
curl https://www.aisplice.store/v1/messages \
-H "Authorization: Bearer sk-YOUR_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-5-5",
"max_tokens": 512,
"messages": [{"role": "user", "content": "Say hello."}]
}'#Risposta
{
"id": "msg_…",
"type": "message",
"role": "assistant",
"model": "claude-opus-5-5",
"content": [{"type": "text", "text": "Hello!"}],
"stop_reason": "end_turn",
"usage": {"input_tokens": 10, "output_tokens": 5}
}Non hai ancora risolto?
Inviaci l'ID richiesta o il messaggio di errore e verificheremo.