Introducción
Claude Opus 4.5 es un modelo de chat de la gama Opus de Anthropic, disponible aquí como un endpoint compatible con OpenAI en /v1/chat/completions. Una ventana de 198.000 tokens guarda decenas de turnos de historial tal cual, y una sola respuesta puede llegar a 32.768 tokens: lo justo para una escena completa o un capítulo corto.
Además del esfuerzo de razonamiento low, medium o high, acepta temperature (de 0 a 1, 1 por defecto) y top_p. El contenido de los mensajes es texto e imágenes, puedes adjuntar hasta 128 tools por solicitud y la respuesta llega por Server-Sent Events cuando lo pides.
Funciones y aspectos destacados
198.000 tokens, leídos tal como se escribieron
A los treinta turnos de un roleplay lo primero que falla es la memoria, no la prosa: de dónde viene el personaje, qué aceptó, qué línea dijo que nunca cruzaría. 198.000 tokens mantienen ese historial palabra por palabra en la solicitud, así que el modelo lee las líneas originales y no un resumen que ya perdió justo las que importaban.
Muestreo que todavía puedes ajustar
temperature va de 0 a 1 con 1 por defecto, y top_p de 0,01 a 1. Baja la temperature en una pasada de continuidad que no debe inventar nada nuevo y déjala en 1 para diálogos que tienen que sorprender. El esfuerzo de razonamiento es un ajuste aparte: low, medium o high.
Salida estructurada con una llamada a tool forzada
Este endpoint no tiene response_format, así que la salida legible por máquina pasa por tools: hasta 128 definiciones de funciones por solicitud, con tool_choice en auto, none, required o una función concreta. Pon el esquema JSON en los parámetros de una tool, fuérzala y valida los argumentos que vuelven.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
messages | Sí | Turnos de conversación ordenados. El contenido es una cadena o un array de partes text e |
max_tokens | No | Limita la respuesta a 32.768, alrededor de un sexto de la ventana de lectura. Por defecto, 4.096; súbelo antes de escribir un capítulo. |
reasoning_effort | No | low, medium o high, medium por defecto. Súbelo cuando la respuesta tenga que conciliar detalles antes de que el modelo escriba. |
stop | No | Hasta 4 secuencias, como cadena o como arreglo. La respuesta termina en cuanto el modelo escribe una de ellas, y el texto que coincide no se devuelve. mínimo 1 caracteres · mínimo 1 elementos · máximo 4 elementos |
temperature | No | De 0 a 1, 1 por defecto. Déjalo en 0 siempre que la respuesta la lea código, y no lo toques una vez que una obra ha encontrado su voz. |
top_p | No | De 0,01 a 1. Ajusta este o temperature, nunca los dos en la misma comparación. |
tools | No | Hasta 128 definiciones de funciones por solicitud. máximo 128 elementos |
parallel_tool_calls | No | true o false, true por defecto: el modelo puede pedir varias llamadas a herramientas en un mismo turno. Valor predeterminado: |
tool_choice | No | auto, none, required, o un objeto que nombre una función. |
Precios
Entrada $4.50 / Salida $22.50 por 1 millón de tokens
Casos de uso
Chat de personaje que no se sale del papel
Envía la ficha del personaje en el mensaje de sistema y la transcripción en curso como messages. Decenas de turnos después, el modelo todavía puede citar lo que se prometió en el turno tres, porque el turno tres sigue en la solicitud.
Continuaciones del largo de una escena
32.768 tokens equivalen más o menos a una escena larga o un capítulo corto. Pide la siguiente escena con max_tokens por encima de los 4.096 por defecto y llegará de una pieza, no en tres fragmentos unidos a mano.
Estado de la historia que tu app puede guardar
Define una tool como update_story_state con campos para lugar, relaciones e hilos abiertos, fuérzala cada pocos turnos y guarda los argumentos en tu app. La prosa y el estado salen del mismo contexto, así que no se contradicen.
Guía de prompts y consejos prácticos
Deja la persona y los límites en el mensaje de sistema
Origen, forma de hablar, límites firmes, persona narrativa y tiempo verbal van en el mensaje de sistema, que nunca se sale de la solicitud. El mensaje de usuario lleva solo el turno actual, de modo que un recorte posterior quita transcripción y nunca personaje.
Sube max_tokens antes de pedir extensión
Los 4.096 tokens por defecto dan para unas pocas páginas. Para una escena completa, fija max_tokens de forma explícita, hasta 32.768; una respuesta cortada a mitad de párrafo cuesta más de rescatar que una que se planeó corta desde el principio.
Conoce dónde termina la ventana
Con unos seis tokens leídos por cada uno escrito, una solicitud que pide reproducir una entrada larga choca primero con el tope de respuesta, y un max_tokens mayor que 32.768 no pasa la validación. Las partes de video y audio se rechazan, y los 198.000 tokens cubren a la vez el prompt de sistema, el historial y cada resultado de tool.
Inicio rápido de la API
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "anthropic/claude-opus-4.5/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
