POST /v1/messages

Autenticazione

x-api-key: mg_live_...
anthropic-version: 2023-06-01
content-type: application/json

È accettata anche l'autenticazione del portatore.

Richiesta

curl https://api.model-gate.com/v1/messages \
  -H "x-api-key: mg_live_..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4.6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "Write a short release note."}
    ]
  }'

Risposta

{
  "id": "msg_example",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4.6",
  "content": [{"type": "text", "text": "This release improves documentation and model routing."}],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 11,
    "output_tokens": 9,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

Streaming

Aggiungere "stream": true. Model Gate inoltra eventi SSE compatibili con l'ambiente antropico e registra l'utilizzo finale del token per la liquidazione.

Alias ​​e contabilità

Se viene fornito un alias, viene sostituito con il modello canonico prima che la richiesta venga accodata o inviata a monte. Prezzi, costi di utilizzo, cronologia delle richieste e restrizioni del modello utilizzano il modello canonico.

Stato	Senso	Azione
400	Richiesta non valida	Controllare il corpo della richiesta e l'ID del modello.
401	Chiave non valida o bloccata	Verifica o ruota la chiave API.
429	Limite di velocità o concorrenza superato	Rispetto Retry-After e riprovare con il backoff.
5xx	Errore temporaneo upstream o gateway	Riprovare le richieste idempotenti con backoff esponenziale.