aisplice

Riferimento API

Messages (formato Anthropic)

POST/v1/messages

Il 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

  • modelstringobbligatorio

    Un ID di modello Claude dalla pagina dei modelli, per esempio claude-opus-5-5.

  • max_tokensintegerobbligatorio

    Obbligatorio nel formato Anthropic — il limite massimo di output.

  • messagesarrayobbligatorio

    Turni in stile Anthropic: {role: user|assistant, content}.

  • systemstringfacoltativo

    Prompt di sistema — qui è un campo di primo livello, non un ruolo dei messaggi.

  • streambooleanfacoltativo

    Trasmette in streaming eventi SSE nativi Anthropic (message_start, content_block_delta, …).

  • temperaturenumberfacoltativo

    Da 0 a 1 nella scala di Anthropic.

  • toolsarrayfacoltativo

    Definizioni degli strumenti Anthropic; i blocchi tool_use tornano in content.

Header anthropic-version

Invia anthropic-version: 2023-06-01 come si aspetta l'API ufficiale. Qui funziona Authorization: Bearer; per gli SDK Anthropic standard è accettato anche x-api-key.

#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.

Tabella completa dei codici di errore →

#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

response.json
{
  "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.