POST /v1/messages

Autenticación

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

También se acepta la autenticación del portador.

Pedido

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

Respuesta

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

Transmisión

Agregar "stream": true. Model Gate reenvía eventos SSE compatibles con Anthropic y registra el uso final del token para la liquidación.

Alias ​​y contabilidad

Si se proporciona un alias, se reemplaza con el modelo canónico antes de que la solicitud se ponga en cola o se envíe en sentido ascendente. Los precios, el costo de uso, el historial de solicitudes y las restricciones del modelo utilizan el modelo canónico.

Estado	Significado	Acción
400	Solicitud no válida	Verifique el cuerpo de la solicitud y el ID del modelo.
401	Clave no válida o congelada	Verifique o rote la clave API.
429	Se superó el límite de tasa o simultaneidad	Respeto Retry-After y vuelva a intentarlo con retroceso.
5xx	Error temporal de subida o de puerta de enlace	Vuelva a intentar solicitudes idempotentes con retroceso exponencial.