Documentación
Clave de API de Anthropic (Claude)
Crea una clave de API de Anthropic Claude en platform.claude.com, en Settings → API keys. La clave empieza por sk-ant- y se muestra una sola vez. Una clave de Kunavo permite acceder a los mismos modelos Claude mediante el SDK de OpenAI o la API nativa Messages, sin una cuenta de Anthropic.
Para obtener una clave de API de Anthropic Claude, inicia sesión en la consola de Claude en platform.claude.com, abre Settings → API keys y haz clic en Create Key. Una clave de API de Anthropic empieza por sk-ant- y solo se muestra una vez al crearla. La consola de Anthropic se trasladó de console.anthropic.com a platform.claude.com, y la página de claves ahora está en platform.claude.com/settings/keys. Una clave de API de Anthropic autentica solicitudes a https://api.anthropic.com con el encabezado x-api-key y un encabezado anthropic-version, no con Authorization: Bearer. La sección de preguntas frecuentes sobre precios de Anthropic indica que los nuevos usuarios reciben una pequeña cantidad de créditos gratuitos para probar la API; no hay ningún plan gratuito más allá de esos créditos, por lo que el uso de la API de Claude se factura por token una vez agotados los créditos iniciales.
Kunavo es una pasarela de API de IA independiente y compatible con OpenAI: una clave de API y un saldo de pago por uso permiten acceder a Claude, GPT y modelos de imagen, vídeo y audio, sin necesidad de una cuenta por proveedor. Una clave de API de Kunavo empieza por sk-kn-, se crea en kunavo.com/app/keys y no requiere una cuenta de Anthropic. Kunavo ofrece Claude tanto mediante el endpoint compatible con OpenAI https://api.kunavo.com/v1/chat/completions como mediante el endpoint nativo de Anthropic https://api.kunavo.com/v1/messages, por lo que el SDK oficial de OpenAI puede acceder a Claude cambiando solo base_url. Kunavo funciona con pago por uso desde una recarga mínima de $10 y no ofrece crédito gratuito a las cuentas nuevas.
Opción A: una clave de API directamente de Anthropic
Una clave de la consola de Anthropic es la opción adecuada cuando Claude será el único modelo al que llamará el proyecto. Anthropic factura la clave por token y admite todas las funciones de Claude desde el día de su lanzamiento.
- Ve a
platform.claude.come inicia sesión. La dirección anterior, console.anthropic.com, ahora lleva a la misma consola. - Abre Settings → API keys (enlace directo:
platform.claude.com/settings/keys) y haz clic en Create Key. Las claves de Anthropic tienen el formatosk-ant-...y se muestran una sola vez. - Añade un método de pago en Facturación. Anthropic concede a los nuevos usuarios una pequeña cantidad de créditos gratuitos y, después, factura por token.
- Envía la clave como
x-api-key, junto con un encabezadoanthropic-version.
# Anthropic direct — x-api-key, not Bearer
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-5",
"max_tokens": 256,
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'Conviene tener en cuenta una consecuencia: una clave de Anthropic solo permite acceder a Claude. Un proyecto que también llame a modelos GPT, de imagen o de vídeo necesita una cuenta, una clave, un SDK y una factura independientes para cada proveedor.
Opción B: una clave de Kunavo para Claude y todo lo demás
Kunavo ofrece Claude mediante una API compatible con OpenAI y la API nativa Anthropic Messages. Una sola clave sk-kn- permite acceder a Claude y a todos los demás modelos del catálogo con un único saldo financiado mediante Stripe, sin una cuenta de Anthropic.
| Clave de la consola de Anthropic | Clave de Kunavo | |
|---|---|---|
| Modelos | Solo Claude | Claude, GPT, imagen, vídeo y audio |
| Punto de conexión | api. | api. |
| APIs | API Messages | Compatible con OpenAI + API Messages |
| Encabezado de autenticación | x-api-key | Authorization: Bearer |
| Cuenta del proveedor | Se requiere una cuenta de Anthropic | No se requiere ninguna |
| Facturación | Anthropic, por token | Un único saldo financiado mediante Stripe |
| Formato de clave | sk-ant-... | sk-kn-... |
- Crea una cuenta de Kunavo y añade una recarga de $10. Kunavo funciona con pago por uso y el saldo nunca caduca.
- Genera una clave en
/app/keys. La clave de Kunavo se muestra una sola vez; guárdala en una variable de entorno. - Configura el SDK de OpenAI para usar
https://api.kunavo.com/v1y llama a un identificador de Claude.
Clave de API de Claude frente a clave de API de Anthropic
Una «clave de API de Anthropic» y una «clave de API de Claude» son la misma credencial con dos nombres. Anthropic es la empresa, Claude es la familia de modelos y la clave creada en la consola de Claude autentica las llamadas a la API de Claude. La diferencia entre las dos claves siguientes está en su origen y en aquello a lo que permiten acceder:
- Clave de la consola de Anthropic (
sk-ant-...): se crea enplatform.claude.com/settings/keys. Solo permite llamar a Claude y Anthropic la factura por token. - Clave de Kunavo (
sk-kn-...): se crea enkunavo.com/app/keys. Permite llamar a los mismos modelos Claude mediante el SDK de OpenAI o la API nativa Messages, además de modelos GPT, de imagen, vídeo y audio, con un único saldo financiado mediante Stripe y sin una cuenta de Anthropic.
Llamar a Claude con Python
Conserva el SDK oficial de OpenAI. Toda la migración consiste en cambiar base_url y el nombre del modelo.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["KUNAVO_API_KEY"],
base_url="https://api.kunavo.com/v1", # the only line that changes
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Explain quicksort in one paragraph."}],
)
print(resp.choices[0].message.content)Llamar a Claude con Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.KUNAVO_API_KEY,
baseURL: "https://api.kunavo.com/v1",
});
const resp = await client.chat.completions.create({
model: "claude-sonnet-5",
messages: [{ role: "user", content: "Explain quicksort in one paragraph." }],
});
console.log(resp.choices[0].message.content);También puedes llamar a Claude con curl
curl https://api.kunavo.com/v1/chat/completions \
-H "Authorization: Bearer $KUNAVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'/v1/messages. Consulta la referencia de la API Messages.La clave de API de Claude no funciona
Una clave de API de Claude que devuelve 401 authentication_error suele fallar por uno de estos cinco motivos: el encabezado no es el correcto para el endpoint, la clave se envía a un endpoint al que no pertenece, hay espacios en blanco o comillas ocultos en la variable de entorno, la clave se revocó o la URL base no corresponde a esa clave.
La causa más común es que no coincida el encabezado. La API nativa de Anthropic requiere x-api-key y anthropic-version. Los endpoints compatibles con OpenAI, incluido Kunavo, requieren Authorization: Bearer. Una clave sk-ant- solo funciona con api.anthropic.com, y una clave sk-kn- solo funciona con api.kunavo.com.
| Síntoma | Causa probable | Solución |
|---|---|---|
401 unauthorized | La clave es incorrecta, se revocó o se envió con un encabezado que no corresponde al endpoint | Vuelve a crear la clave en /app/keys y envía Authorization: Bearer sk-kn-… |
402 insufficient_ | El saldo está vacío o se alcanzó el límite de gasto por clave | Recarga el saldo o aumenta el límite de esa clave |
model not found | Identificador incorrecto | Usa un identificador exacto como claude-sonnet-5; explora /models |
429 rate limit | Demasiadas solicitudes en poco tiempo | Espera y vuelve a intentarlo con un retraso exponencial |
Cada error que aparece a continuación tiene una guía detallada con el JSON exacto del error, todas las causas conocidas y soluciones listas para copiar y pegar: 401 invalid api key, 429 rate_limit_error, credit balance too low / 402, 529 overloaded y model_not_found.
Usar la API de Claude sin tarjeta de crédito
Anthropic acepta las principales tarjetas de crédito para las cuentas estándar de la API de Claude y reserva la facturación por factura para clientes empresariales, por lo que, en la vía directa, la tarjeta es un requisito práctico.
El saldo de Kunavo se puede recargar completamente sin tarjeta mediante cualquiera de estos métodos: ACH bank debit (US bank accounts, settles in 3–5 business days), Alipay (mainland China), WeChat Pay (mainland China), UPI (India), Pix (Brazil), iDEAL (Netherlands), Bancontact (Belgium), EPS (Austria), MB WAY (Portugal), Satispay (Italy), BLIK (Poland), Bacs Direct Debit (United Kingdom, settles in several business days), Pay by Bank (United Kingdom, Ireland and Finland), Crypto (stablecoins) (US-dollar checkouts). Kunavo fija los precios de las recargas en USD y Stripe convierte el importe en la página de pago, así que un comprador brasileño escanea un código Pix para pagar un importe en reales, sin tener que buscar una tarjeta autorizada para compras internacionales. También hay monederos vinculados a tarjetas, pero se omiten deliberadamente de esa lista, porque un monedero que depende de una tarjeta no responde a la pregunta. La lista completa de métodos está en la referencia de facturación.
Qué modelo Claude usar
- claude-haiku-4-5: el más barato y rápido, para clasificación de gran volumen y asistencia. Kunavo ofrece Claude Haiku 4.5 a $0.70 por cada 1M de tokens de entrada y $3.50 por cada 1M de tokens de salida.
- claude-sonnet-5: la opción equilibrada predeterminada para la mayoría de las tareas de razonamiento, recuperación y programación; el Sonnet más reciente, con un rendimiento cercano a Opus en programación y tareas con agentes. Kunavo ofrece Claude Sonnet 5 a $1.40 / $7.00 por cada 1M de tokens, frente al precio de lista de Anthropic de $2.00 / $10.00.
- claude-sonnet-4-6: el Sonnet anterior, para prompts que ya estén adaptados a él. Kunavo ofrece Claude Sonnet 4.6 a $2.10 / $10.50 por cada 1M de tokens.
- claude-opus-5: para razonamiento complejo y contextos extensos. Kunavo ofrece Claude Opus 5 a $3.50 / $17.50 por cada 1M de tokens, frente al precio de lista de Anthropic de $5.00 / $25.00.
- claude-fable-5: el modelo más capaz de Anthropic, para razonamiento de frontera y agentes con horizontes prolongados; se lanzó el 1 de septiembre de 2026. Kunavo lo ofrece a $7.00 / $35.00 por cada 1M de tokens, frente al precio de lista de Anthropic de $10.00 / $50.00. La versión anterior, claude-fable-5, sigue disponible a la misma tarifa.
Lista de comprobación de seguridad de claves de API
- Nunca expongas una clave de API en el cliente. Redirige cada llamada a través de un servidor que controles.
- Usa una clave de API por proyecto o entorno para poder revocar una clave filtrada sin interrumpir todo lo demás.
- Rota las claves de API cada trimestre. Kunavo permite tener varias claves activas a la vez, lo que ofrece un periodo de transición sin interrupciones durante la rotación.
Preguntas frecuentes
¿Cómo puedo obtener una clave de API de Anthropic Claude?
Para obtener una clave de API de Anthropic Claude, inicia sesión en la consola de Claude en platform.claude.com, abre Settings → API keys y haz clic en Create Key. Una clave de API de Anthropic empieza por sk-ant- y solo se muestra al crearla, por lo que debes copiarla y guardarla en ese momento. La consola de Anthropic se trasladó de console.anthropic.com a platform.claude.com, y la página de claves está en platform.claude.com/settings/keys. Una clave de API de Anthropic autentica solicitudes a https://api.anthropic.com mediante el encabezado x-api-key junto con un encabezado anthropic-version, no con un encabezado Authorization: Bearer.
¿Una clave de API de Anthropic es lo mismo que una clave de API de Claude?
Una clave de API de Anthropic y una clave de API de Claude son la misma credencial con dos nombres. Anthropic es la empresa y Claude es la familia de modelos; la clave creada en la consola de Claude (sk-ant-...) autentica las llamadas a la API de Claude. Una clave de API de Kunavo (sk-kn-...) es una credencial distinta, de otra empresa, que permite acceder a los mismos modelos Claude, además de GPT y modelos multimedia, mediante un único endpoint compatible con OpenAI.
¿La API de Claude es gratuita?
La API de Claude no es gratuita de forma continuada. La sección de preguntas frecuentes sobre precios de Anthropic indica que los nuevos usuarios reciben una pequeña cantidad de créditos gratuitos para probar la API; Anthropic no publica el importe de esos créditos y no hay ningún plan gratuito más allá de ellos. Por tanto, el uso de la API de Claude se factura por token una vez agotados los créditos iniciales. Kunavo tampoco ofrece crédito gratuito a las cuentas nuevas: una cuenta de Kunavo comienza con una recarga mínima de $10, el saldo nunca caduca y las llamadas fallidas 4xx y 5xx nunca se facturan.
¿Por qué no funciona mi clave de API de Claude?
Una clave de API de Claude que devuelve 401 authentication_error suele fallar por uno de estos cinco motivos: el encabezado no es el correcto para el endpoint, la clave se envía a un endpoint al que no pertenece, hay espacios en blanco o comillas ocultos en la variable de entorno, la clave se revocó o la URL base es incorrecta. La API nativa de Anthropic en api.anthropic.com requiere x-api-key y anthropic-version; los endpoints compatibles con OpenAI requieren Authorization: Bearer. Una clave sk-ant- solo funciona con api.anthropic.com y una clave de Kunavo sk-kn- solo funciona con api.kunavo.com.
¿Puedo usar la API de Claude sin tarjeta de crédito?
Anthropic acepta las principales tarjetas de crédito para las cuentas estándar de la API de Claude y reserva la facturación por factura para clientes empresariales, por lo que, en la vía directa, la tarjeta es un requisito práctico. El saldo de Kunavo se puede recargar sin tarjeta mediante varios métodos: ACH bank debit (US bank accounts, settles in 3–5 business days), Alipay (mainland China), WeChat Pay (mainland China), UPI (India), Pix (Brazil), iDEAL (Netherlands), Bancontact (Belgium), EPS (Austria), MB WAY (Portugal), Satispay (Italy), BLIK (Poland), Bacs Direct Debit (United Kingdom, settles in several business days), Pay by Bank (United Kingdom, Ireland and Finland), Crypto (stablecoins) (US-dollar checkouts). Kunavo fija los precios de las recargas en USD y Stripe convierte el importe en la página de pago; así, un comprador brasileño paga un precio en dólares en reales. Ninguna de las dos opciones ofrece acceso gratuito continuo: usar Claude implica pagar por los tokens en ambos casos.
¿Puedo llamar a Claude con el SDK de OpenAI?
Se puede llamar a Claude con el SDK oficial de OpenAI mediante el endpoint de Kunavo compatible con OpenAI. Configura base_url como https://api.kunavo.com/v1, pasa una clave de Kunavo como token bearer y establece model con un identificador de Claude, como claude-sonnet-5. La API de Anthropic en api.anthropic.com no acepta solicitudes de completado de chat con formato OpenAI, así que para llamar a Claude directamente necesitas el SDK de Anthropic o la API nativa Messages.
¿Cuál es la diferencia entre una clave de API de Anthropic y una clave de API de Kunavo?
Una clave de API de Anthropic llama únicamente a modelos Claude y se factura a través de Anthropic. Una clave de API de Kunavo permite llamar a Claude y a modelos GPT, de imagen, vídeo y audio mediante una sola API compatible con OpenAI; todo se factura a través de un único saldo financiado con Stripe. Para una clave de API de Anthropic hace falta una cuenta de Anthropic; para una de Kunavo, no.
¿Con qué modelo Claude debería empezar?
Empieza con claude-sonnet-5, la opción equilibrada predeterminada para la mayoría de las tareas de razonamiento, recuperación y programación. Pasa a claude-haiku-4-5 para clasificación de gran volumen y asistencia, con un coste bajo. Usa claude-opus-5 para razonamiento complejo y recurre a claude-fable-5, el modelo más capaz de Anthropic, solo para razonamiento de frontera y agentes con horizontes prolongados.
¿Cuánto cuesta la API de Claude?
Anthropic factura la API de Claude por token, con tarifas que varían según el nivel del modelo: Claude Haiku 4.5 es el más barato y Claude Fable 5, el más caro. Kunavo ofrece los mismos modelos Claude por debajo del precio de lista de Anthropic en todos los modelos: Claude Opus 5 cuesta $3.50 / $17.50 por 1M de tokens frente a los $5.00 / $25.00 de Anthropic; Claude Haiku 4.5 cuesta $0.70 / $3.50 frente a los $1.00 / $5.00 de Anthropic; y Claude Sonnet 5 cuesta $1.40 / $7.00 frente a la tarifa introductoria de $2.00 / $10.00, que Anthropic convirtió en su precio estándar permanente el 31 de agosto de 2026.
¿Kunavo forma parte de Anthropic?
Kunavo es una pasarela independiente que revende el acceso a estos modelos. Kunavo no es Anthropic, Google ni OpenAI, y no entrena ni aloja los modelos que ofrece.
Qué es Kunavo y qué no es
Kunavo es una pasarela de API de IA independiente y compatible con OpenAI: una clave de API y un saldo de pago por uso permiten acceder a Claude, GPT y modelos de imagen, vídeo y audio, sin necesidad de una cuenta por proveedor.
Kunavo es una pasarela independiente que revende el acceso a estos modelos. Kunavo no es Anthropic, Google ni OpenAI, y no entrena ni aloja los modelos que ofrece.
La documentación propia de Anthropic en platform.claude.com es la fuente autorizada sobre sus productos, precios y políticas. Esta página reproduce el procedimiento publicado por Anthropic e indica la fecha en que se verificó cada afirmación; junto a él, presenta la alternativa de Kunavo.