POST /v1/messages

Autenticació

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

També s'accepta l'autenticació del portador.

Sol·licitud

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."}
    ]
  }'

Resposta

{
  "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
  }
}

Transmissió en directe

Afegeix "stream": true. Model Gate reenvia esdeveniments SSE compatibles amb Anthropic i registra l'ús final del testimoni per a la liquidació.

Àlies i comptabilitat

Si es proporciona un àlies, se substitueix pel model canònic abans que la sol·licitud s'entri a la cua o s'enviï aigües amunt. Els preus, el cost d'ús, l'historial de sol·licituds i les restriccions del model utilitzen el model canònic.

Estat	Significat	Acció
400	Sol·licitud no vàlida	Comproveu el cos de la sol·licitud i l'identificador del model.
401	Clau no vàlida o bloquejada	Verifiqueu o gireu la clau de l'API.
429	S'ha superat el límit de tarifa o concurrència	Respecte Retry-After i torna-ho a provar amb backoff.
5xx	Error temporal en aigües amunt o passarel·la	Torneu a provar les sol·licituds idempotents amb retrocés exponencial.