API Messages

POST /v1/messages

Compatible con la API Anthropic Messages. La pasarela redirige de forma transparente a los modelos Claude mediante el canal Anthropic o Bedrock configurado.

Cuerpo de la solicitud

Parámetro	Tipo	Descripción
`model`*	`string`	ID del modelo a usar (p. ej. claude-sonnet-4-6).
`messages`*	`array`	Array de objetos de mensaje con rol (user/assistant) y contenido.
`max_tokens`*	`integer`	Número máximo de tokens a generar.
`system`	`string`	Prompt de sistema para establecer el contexto de la conversación.
`stream`	`boolean`	Si es true, devuelve un flujo de eventos SSE. Predeterminado: false.
`temperature`	`number`	Temperatura de muestreo 0–1. Predeterminado: 1.
`tools`	`array`	Lista de definiciones de herramientas para el uso de herramientas.

Ejemplo de solicitud

POST /v1/messages
Authorization: Bearer YOUR_API_KEY
x-api-key: YOUR_API_KEY

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 256,
  "messages": [
    {"role": "user", "content": "What is the capital of France?"}
  ]
}

Ejemplo de respuesta

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [
    { "type": "text", "text": "The capital of France is Paris." }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 14,
    "output_tokens": 9
  }
}

ℹ

La API Messages acepta ambos Authorization: Bearer y x-api-key para la autenticación, según la convención del SDK de Anthropic.