Inicio / Documentación / API de mensajes

API de mensajes

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

Ver como Markdown Preguntar a ChatGPT Preguntar en Claude

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
`metadata`	objeto	no	Se transmite sin modificaciones; `user_id` es útil para tu propia atribución

Ejemplo

curl 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

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

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

Transmisión en tiempo realSalida token a token Uso de herramientasLlamadas a funciones ErroresModos de fallo