La API de Anthropic es la interfaz de modelos que ofrece Anthropic para llamar a la familia de modelos Claude. Mucha gente confunde «Anthropic API», «Claude API» y «Claude Code», pero describen capas distintas.
Este artículo explica qué es la API de Anthropic, cómo llamarla, en qué se diferencia del protocolo de OpenAI y las dos formas habituales de acceder a ella desde China continental.
Nota: Anthropic y Claude son marcas registradas de sus respectivos propietarios. Este artículo refleja el uso habitual a octubre de 2026. Los endpoints y precios están sujetos a la documentación oficial y a este sitio.
1. Cómo se relacionan los tres conceptos
- Anthropic: la empresa que desarrolla los modelos Claude.
- Anthropic API / Claude API: la interfaz para llamar a los modelos Claude, normalmente la API de Messages.
- Claude Code: la herramienta de programación de línea de comandos de Anthropic, que llama a los modelos a través de la API internamente.
Por eso «Anthropic API» y «Claude API» aparecen de forma intercambiable en la documentación. En la mayoría de contextos se refieren a la misma interfaz de modelos.
2. Qué ofrece la API de Anthropic
1. API de Messages
El endpoint principal es POST /v1/messages. El cuerpo de la petición incluye:
modelmax_tokensmessagessystem(opcional)temperature,top_py parámetros similares (opcionales)tools(opcional)
2. Cabeceras de petición
La interfaz nativa suele requerir:
x-api-key: sk-...
anthropic-version: 2023-06-01
content-type: application/json
Algunas versiones y gateways también aceptan un token Bearer. Sigue la documentación de tu configuración.
3. Niveles de modelo
Los niveles habituales de Claude:
| Nivel | Ideal para |
|---|---|
| Opus | Razonamiento complejo, agentes de larga duración, problemas difíciles |
| Sonnet | Programación diaria, corrección de errores, revisión de código |
| Haiku | Tareas simples, procesamiento por lotes, cargas de bajo coste |
Los nombres de modelo concretos y los precios están en Precios de modelos.
3. Ejemplo de llamada directa
export ANTHROPIC_API_KEY="sk-your-key"
curl "https://api.anthropic.com/v1/messages" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 256,
"messages": [
{"role": "user", "content": "Explain the Messages API in three sentences."}
]
}'
Si usas un SDK, inicialízalo como espera el SDK de Anthropic. No reutilices el formato de petición del SDK de OpenAI.
4. En qué se diferencia la API de Anthropic de la API de OpenAI
| Dimensión | API de Anthropic | API de OpenAI |
|---|---|---|
| Ruta principal | /v1/messages |
/v1/chat/completions |
| Cabecera de autenticación | x-api-key |
Authorization: Bearer |
| Cabecera de versión | anthropic-version |
Ninguna |
| Formato de mensajes | messages más system |
messages con un rol system |
| Llamadas a herramientas | tools |
tools / functions |
| SDK | SDK de Anthropic | SDK de OpenAI |
Las dos no son directamente compatibles. Muchos gateways ofrecen ambos puntos de entrada: un endpoint compatible con Anthropic para Claude Code y otro compatible con OpenAI para los SDK y herramientas de OpenAI.
5. Dos formas de acceder desde China continental
Opción A: acceso oficial directo
Base URL: https://api.anthropic.com
Encaja en equipos que pueden llegar a Anthropic de forma fiable y ya tienen cuenta y método de pago oficiales.
Opción B: ZSQH AI Gateway
- Endpoint compatible con Anthropic:
https://ai.zhongshangqihang.com(para Claude Code y herramientas similares) - Endpoint compatible con OpenAI:
https://ai.zhongshangqihang.com/v1(para SDK y herramientas de OpenAI)
Regístrate en ZSQH AI Gateway, crea una clave, recarga saldo y empieza a usarlo. Los nombres de modelo están en Precios de modelos.
6. Llamar a Claude con el SDK de OpenAI
Si tus herramientas solo admiten el protocolo de OpenAI, usa el endpoint compatible con OpenAI del gateway:
from openai import OpenAI
client = OpenAI(
api_key="sk-your-key",
base_url="https://ai.zhongshangqihang.com/v1",
)
resp = client.chat.completions.create(
model="claude-sonnet-4-5",
messages=[{"role": "user", "content": "Reply with OK only"}],
)
print(resp.choices[0].message.content)
Ten en cuenta que este no es el protocolo nativo de Anthropic, así que los parámetros y capacidades pueden diferir. Cuando necesites llamadas a herramientas nativas o caché, prioriza el endpoint compatible con Anthropic.
7. Entender la facturación
La API de Anthropic normalmente factura tokens de entrada, tokens de salida y caché. Ten en cuenta:
- Los tokens de salida suelen costar más que los de entrada.
- Un contexto largo multiplica el número de tokens de entrada.
- Los aciertos de caché ahorran dinero, pero no todas las peticiones llegan a la caché.
- Los precios varían mucho entre niveles: Opus, Sonnet y Haiku.
Para los precios unitarios actuales, consulta Precios de modelos. Para métodos de estimación, consulta Precios de Claude Code: suscripción o API.
8. Preguntas frecuentes
¿La API de Anthropic y la API de Claude son lo mismo?
En la mayoría de contextos se refieren a la misma interfaz de modelos con nombres distintos.
¿La API de Anthropic admite el formato de OpenAI?
No de forma nativa. Necesitas el endpoint compatible con OpenAI de un gateway o una capa adaptadora.
¿Cómo puedo llamarla de forma fiable desde China continental?
Puedes usar el acceso oficial directo si tu red lo permite, o un gateway accesible desde China continental. Presta atención al cumplimiento de datos y a las condiciones del servicio.
¿Qué interfaz usa Claude Code?
Claude Code usa la API de Messages de Anthropic. Para la configuración, consulta la guía de la API de Claude Code.
Próximos pasos
Si necesitas acceso estable desde China continental, una factura unificada o cambiar entre varios modelos, regístrate en ZSQH AI Gateway, crea una clave de prueba y completa una petición de Messages. Los nombres de modelo y los precios están en Precios de modelos.
Lecturas relacionadas:
