Referencia de la API

Messages (formato Anthropic)

POST/v1/messages

El 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

  • modelstringobligatorio

    Un ID de modelo de Claude de la página de modelos, p. ej. claude-opus-5-5.

  • max_tokensintegerobligatorio

    Obligatorio en el formato de Anthropic — el límite estricto de salida.

  • messagesarrayobligatorio

    Turnos al estilo Anthropic: {role: user|assistant, content}.

  • systemstringopcional

    Prompt del sistema — aquí es un campo de nivel superior, no un rol de mensaje.

  • streambooleanopcional

    Transmite eventos SSE nativos de Anthropic (message_start, content_block_delta, …).

  • temperaturenumberopcional

    De 0 a 1 en la escala de Anthropic.

  • toolsarrayopcional

    Definiciones de herramientas de Anthropic; los bloques tool_use vuelven en content.

Encabezado anthropic-version

Envía anthropic-version: 2023-06-01, como espera la API oficial. Authorization: Bearer funciona aquí; también se acepta x-api-key para los SDK de Anthropic sin modificar.

#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.

Tabla completa de códigos de error →

#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

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