Claude
Claude Sonnet 5.5 · Messages
Texto / Claude / Claude Sonnet 5.5 / Messages
POST
/v1/messagesParámetros de solicitud
Authorization
Añade un header Authorization cuyo valor sea Bearer seguido de tu API key.
Authorization: Bearer ****************
anthropic-version: 2023-06-01
Parámetros de header
Content-TypestringOpcional
application/json
AcceptstringOpcional
application/json
Parámetros de bodyapplication/jsonobligatorio
modelstringObligatorio
ID del modelo, fijo en `claude-sonnet-5-5`
messagesarray[object]Obligatorio
Lista de mensajes de la conversación; cada uno tiene `role` (user / assistant) y `content` (texto o bloques de contenido)
max_tokensintegerObligatorio
Número máximo de tokens a generar; obligatorio en la API de Anthropic
systemstring | array[object]Opcional
Prompt de sistema, pasado como campo de nivel superior (no como mensaje)
streambooleanOpcional
Si se transmite la respuesta (SSE), por defecto `false`
stop_sequencesarray[string]Opcional
Secuencias de parada personalizadas; detienen la generación al alcanzarse
toolsarray[object]Opcional
Definiciones de herramientas para el uso de herramientas
tool_choiceobjectOpcional
Controla si se usa una herramienta y cuál
metadataobjectOpcional
Metadatos de la solicitud, como `user_id`
thinkingobjectOpcional
El razonamiento adaptativo se activa por defecto si se omite este campo; usa `disabled` para desactivarlo
output_configobjectOpcional
Configuración de salida; los campos disponibles dependen del modelo
Ejemplo
{ "model": "claude-sonnet-5-5", "max_tokens": 1024, "messages": [ { "role": "user", "content": "Hola, cuéntame sobre ti" } ]}Código de ejemplo
curl https://api.hotrouter.ai/v1/messages \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "claude-sonnet-5-5", "max_tokens": 1024, "messages": [ { "role": "user", "content": "Hola, cuéntame sobre ti" } ] }'Respuesta
200 · Éxito
idstringObligatorio
Id único de esta respuesta
typestringObligatorio
Tipo de objeto (message)
rolestringObligatorio
Rol del mensaje
contentarray[object]Obligatorio
Array de bloques de contenido
stop_reasonstringOpcional
Razón de fin (end_turn / max_tokens, etc.)
usageobjectObligatorio
Uso de tokens de esta llamada
Ejemplo
{ "id": "msg_xxx", "type": "message", "role": "assistant", "content": [ { "type": "text", "text": "¡Hola! Encantado de conocerte…" } ], "stop_reason": "end_turn", "usage": { "input_tokens": 12, "output_tokens": 24 }}