Familia Claude
Los modelos Claude de Anthropic, que incluyen las series Opus, Sonnet, Haiku y Fable. Se recomienda llamarlos a través del endpoint nativo de Anthropic: extended thinking, caché de prompts, entrada de PDF y demás funciones se comportan igual que en la API oficial. El endpoint compatible con OpenAI también está disponible y es adecuado para proyectos que ya usan el SDK de OpenAI.
Tareas habituales
Modelos
Todos los modelos admiten entrada de texto, imágenes y PDF, así como llamadas a herramientas. La lista completa de modelos y los precios en tiempo real están en la página de modelos ; también puede consultarlos con la Models API.
anthropic/claude-opus-5.5anthropic/claude-sonnet-5.5anthropic/claude-haiku-5.5anthropic/claude-fable-5.1El ID de modelo puede omitir el prefijo anthropic/ o usar el formato oficial de Anthropic; todas las formas siguientes apuntan al mismo modelo:
Los alias disponibles para cada modelo figuran en el campo aliases que devuelve la Models API. El campo model de la respuesta usa siempre el formato estándar.
Elección de endpoint
Los parámetros completos de la petición se describen en Anthropic Messages API y Chat Completions API.
Proveedores
Los modelos Claude los ofrecen dos proveedores, y un mismo modelo admite funciones distintas según el proveedor:
En el endpoint nativo de Anthropic, el proveedor se selecciona con una cabecera:
-H "X-OfoxAI-Provider-Type: anthropic"Si el proveedor seleccionado no ofrece el modelo, se devuelve 400 y el mensaje de error enumera los proveedores disponibles, por ejemplo:
No available channel for platform 'anthropic' on model 'anthropic/claude-sonnet-4.6'. Available platforms for this model: aws_bedrock.Otras formas de seleccionarlo: Enrutamiento de proveedores.
Ejemplos de llamada
Python (SDK de Anthropic)
import os
import anthropic
client = anthropic.Anthropic(
base_url="https://api.ofox.io/anthropic",
api_key=os.environ["OFOX_API_KEY"],
)
message = client.messages.create(
model="anthropic/claude-sonnet-4.6",
max_tokens=1024,
system="Eres un ingeniero de backend sénior y respondes de forma concisa.",
messages=[{"role": "user", "content": "Explica en una frase qué es la idempotencia."}],
)
print(message.content[0].text)max_tokens es obligatorio en el endpoint nativo de Anthropic y no puede superar la salida máxima del modelo.
Uso en Claude Code
Claude Code llama a través del endpoint nativo de Anthropic, con la URL base https://api.ofox.io/anthropic. Los pasos de configuración están en Configuración de Claude Code.
https://api.ofox.io/anthropicErrores habituales
Otros errores generales: Gestión de errores.
Documentación oficial
- Anthropic · Resumen de modelos
- Anthropic · Extended thinking
- Anthropic · Caché de prompts
- Anthropic · Compatibilidad con PDF
La documentación oficial describe el comportamiento al llamar directamente a Anthropic. Al llamar a través de OfoxAI, los IDs de modelo y las URL de los endpoints son los de esta página.
Preguntas frecuentes
¿Cómo se escribe el ID de modelo de Claude?
El formato estándar es anthropic/claude-sonnet-4.6. También puede omitir el prefijo anthropic/ o usar los formatos oficiales claude-sonnet-4-6 y claude-sonnet-4-6-20260217; todos apuntan al mismo modelo.
¿Se puede llamar a Claude con el SDK de OpenAI?
Sí. Configure base_url como https://api.ofox.io/v1 e indique un ID de modelo como anthropic/claude-sonnet-4.6. Si necesita extended thinking o información completa de uso de la caché, se recomienda el endpoint nativo de Anthropic.
¿Cómo se activa el modo thinking en Claude?
En el endpoint nativo, envíe thinking: {"type": "enabled", "budget_tokens": 2000}, con budget_tokens de al menos 1024 y menor que max_tokens; o envíe {"type": "adaptive"} para que decida el modelo. En el endpoint compatible con OpenAI, envíe reasoning: {"max_tokens": 2000}. Con thinking activado, no configure temperature.
¿Qué hago si la caché de prompts de Claude no surte efecto?
Compruebe por orden: si ha marcado cache_control en los bloques de contenido fijo (ninguno de los dos endpoints almacena en caché automáticamente); si el contenido alcanza la longitud mínima almacenable en caché; si el prefijo de las dos peticiones es exactamente idéntico; y si entre las dos peticiones han pasado más de 5 minutos.
¿Qué hago si aparece el error prompt is too long?
La entrada supera el contexto del modelo. Haiku 4.5 tiene un contexto de 200K tokens y el resto de modelos Claude, de 1M tokens; puede cambiar de modelo o acortar la entrada.
¿Claude admite un contexto de 1M? ¿Hay que añadir la cabecera beta?
Todos los modelos salvo Haiku 4.5 admiten un contexto de 1M; en OfoxAI no es necesario enviar la cabecera beta.
¿Qué hago si la respuesta de Claude se trunca?
Revise el stop_reason de la respuesta. Si es max_tokens, la salida alcanzó el límite: aumente max_tokens. Con thinking activado, el contenido del thinking también consume el límite de max_tokens.
¿Qué proveedor ofrece Claude en OfoxAI?
Todos los modelos los ofrece Amazon Bedrock, que es el proveedor predeterminado. Fable 5, Opus 4.8, Opus 4.7 y Sonnet 5 también están disponibles con el proveedor Anthropic, solo en el endpoint nativo de Anthropic y seleccionándolo con la cabecera X-OfoxAI-Provider-Type: anthropic.
¿Claude puede buscar en la web?
Sí, pero requiere seleccionar el proveedor Anthropic, solo con Fable 5, Opus 4.8, Opus 4.7 y Sonnet 5, y solo en el endpoint nativo de Anthropic. Añada {"type": "web_search_20250305", "name": "web_search"} a tools.
¿Claude puede leer PDF?
Sí. En el endpoint nativo, use un bloque de contenido document con el PDF codificado en base64; en el endpoint compatible con OpenAI, use un bloque de contenido file con file_data en formato data:application/pdf;base64,...