Referencia de la API
Messages (formato Anthropic)
Modelos de este endpoint (5)
/v1/messagesEl formato nativo de Anthropic, servido con la misma bearer key. Claude Code y los SDK oficiales de anthropic funcionan cambiando solo la URL base — sin adaptador ni traducción de formato.
#Parámetros de la solicitud
modelstringobligatorioUn ID de modelo de Claude de la página de modelos, p. ej. claude-opus-5-5.
max_tokensintegerobligatorioObligatorio en el formato de Anthropic — el límite estricto de salida.
messagesarrayobligatorioTurnos al estilo Anthropic: {role: user|assistant, content}.
systemstringopcionalPrompt del sistema — aquí es un campo de nivel superior, no un rol de mensaje.
streambooleanopcionalTransmite eventos SSE nativos de Anthropic (message_start, content_block_delta, …).
temperaturenumberopcionalDe 0 a 1 en la escala de Anthropic.
toolsarrayopcionalDefiniciones de herramientas de Anthropic; los bloques tool_use vuelven en content.
Encabezado anthropic-version
#Errores relacionados
- 400 invalid_request_errorCuerpo mal formado o parámetro no admitido para este modelo.
- 401Bearer token no válido o ausente. Esta ruta no tiene error.code — compara por el estado.
- 402 insufficient_user_quotaEl saldo de la billetera no cubre la estimación reservada previamente.
- 429Limitación por clave. Cuerpo vacío; espera el Retry-After. Un 429 que sí incluye insufficient_user_quota indica en cambio un límite de gasto diario.
- 503 model_not_foundModelo desconocido, o ningún canal sano lo atiende ahora mismo.
#Ejemplo de solicitud
curl https://www.aisplice.store/v1/messages \
-H "Authorization: Bearer sk-YOUR_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-5-5",
"max_tokens": 512,
"messages": [{"role": "user", "content": "Say hello."}]
}'#Respuesta
{
"id": "msg_…",
"type": "message",
"role": "assistant",
"model": "claude-opus-5-5",
"content": [{"type": "text", "text": "Hello!"}],
"stop_reason": "end_turn",
"usage": {"input_tokens": 10, "output_tokens": 5}
}¿Sigues con el problema?
Envíanos el ID de solicitud o el mensaje de error y lo revisaremos.