Source: https://aiprimetech.io/es/docs/api-reference/messages/

[Inicio](/es/) / [Documentación](/es/docs/) / API de mensajes 

# API de mensajes 

POST /v1/messages: el endpoint con formato de Anthropic: parámetros, estructura de la respuesta y ejemplos. 

 Copiar página [ Ver como Markdown](/es/docs/api-reference/messages.md) [ Preguntar a ChatGPT](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Preguntar en Claude](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/api-reference/messages.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

El endpoint que utiliza todo cliente compatible con Anthropic, incluidos Claude Code y los SDK oficiales. 

EndpointPOST https://aiprimetech.io/v1/messages

Autenticaciónx-api-key: sk-...

Encabezado de versiónanthropic-version: 2023-06-01

Tipo de contenidoapplication/json 

## Cuerpo de la solicitud 

 | Campo | Tipo | Obligatorio | Descripción

 | model | cadena | sí | Identificador del modelo, exactamente como aparece en /v1/models

 | messages | matriz | sí | Turnos alternos de usuario y asistente, del más antiguo al más reciente

 | max_tokens | entero | sí | Máximo de tokens de salida. La generación se detiene al alcanzar este límite.

 | system | cadena o array | no | Prompt del sistema de nivel superior. No es un rol de mensaje.

 | temperature | número | no | 0–1. Omítelo para usar el valor predeterminado del modelo.

 | top_p | número | no | Muestreo de núcleo. Usa este parámetro o la temperatura, no ambos.

 | stop_sequences | matriz | no | Cadenas que detienen la generación cuando se producen

 | stream | booleano | no | true para eventos enviados por el servidor

 | tools | matriz | no | Definiciones de herramientas: consulta [Uso de herramientas](/es/docs/api-reference/tool-use/)

 | metadata | objeto | no | Se transmite sin modificaciones; user_id es útil para tu propia atribución 

## Ejemplo 

```
Copycurl https://aiprimetech.io/v1/messages \
  -H "x-api-key: $CLAUDEAPIKEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'
```

## Respuesta 

```
Copy{
  "id": "msg_01ABC...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-6",
  "content": [{"type": "text", "text": "..."}],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {"input_tokens": 9, "output_tokens": 12}
}
```

 | Campo | Descripción

 | content | Array de bloques. Los bloques de texto contienen type: text y un text campo; las llamadas a herramientas contienen type: tool_use.

 | stop_reason | end_turn, max_tokens, stop_sequence o tool_use

 | usage.input_tokens | Entrada facturada, incluido todo el historial reenviado

 | usage.output_tokens | Salida facturada: normalmente 4–5 veces la tarifa de entrada 

## Prompts del sistema 

```
Copy{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": "You are a terse assistant. Answer in at most two sentences.",
  "messages": [{"role": "user", "content": "Explain HTTP caching."}]
}
```

Un bloque estable de system es el objetivo ideal para [el almacenamiento en caché de prompts](/es/docs/guides/prompt-caching/) : es idéntico en cada llamada, por lo que puede leerse de la caché por una fracción del precio de entrada. 

## Entrada multimodal 

Los bloques de imagen utilizan la estructura estándar de Anthropic: consulta [Visión](/es/docs/api-reference/vision/). 

[Transmisión en tiempo realSalida token a token](/es/docs/api-reference/streaming/)[Uso de herramientasLlamadas a funciones](/es/docs/api-reference/tool-use/)[ErroresModos de fallo](/es/docs/api-reference/errors/) 

[AnteriorDescripción general de la API](/es/docs/api-reference/overview/)[SiguienteAPI de completado de chat](/es/docs/api-reference/chat-completions/)