Claude Sonnet 5.5 · Messages

POST/v1/messages

Pará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"
    }
  ]
}

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

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

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

Claude Sonnet 5.5 · Messages

Parámetros de solicitud

Código de ejemplo

Respuesta

On this page