Documentación

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.

Los detalles de los productos de Anthropic que aparecen en esta página —dirección de la consola, ruta del menú, prefijo de la clave, encabezado de autenticación y política de crédito gratuito— se verificaron por última vez con la documentación oficial de la API de Anthropic el 31 de agosto de 2026.

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.

  1. Ve a platform.claude.com e inicia sesión. La dirección anterior, console.anthropic.com, ahora lleva a la misma consola.
  2. Abre Settings → API keys (enlace directo: platform.claude.com/settings/keys) y haz clic en Create Key. Las claves de Anthropic tienen el formato sk-ant-... y se muestran una sola vez.
  3. 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.
  4. Envía la clave como x-api-key, junto con un encabezado anthropic-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 AnthropicClave de Kunavo
ModelosSolo ClaudeClaude, GPT, imagen, vídeo y audio
Punto de conexiónapi.anthropic.comapi.kunavo.com/v1
APIsAPI MessagesCompatible con OpenAI + API Messages
Encabezado de autenticaciónx-api-keyAuthorization: Bearer
Cuenta del proveedorSe requiere una cuenta de AnthropicNo se requiere ninguna
FacturaciónAnthropic, por tokenUn único saldo financiado mediante Stripe
Formato de clavesk-ant-...sk-kn-...
  1. Crea una cuenta de Kunavo y añade una recarga de $10. Kunavo funciona con pago por uso y el saldo nunca caduca.
  2. Genera una clave en /app/keys. La clave de Kunavo se muestra una sola vez; guárdala en una variable de entorno.
  3. Configura el SDK de OpenAI para usar https://api.kunavo.com/v1 y 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 en platform.claude.com/settings/keys. Solo permite llamar a Claude y Anthropic la factura por token.
  • Clave de Kunavo (sk-kn-...): se crea en kunavo.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"}]
  }'
El formato de solicitud nativo de Anthropic funciona con la misma clave de Kunavo: envía una solicitud POST a /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íntomaCausa probableSolución
401 unauthorizedLa clave es incorrecta, se revocó o se envió con un encabezado que no corresponde al endpointVuelve a crear la clave en /app/keys y envía Authorization: Bearer sk-kn-…
402 insufficient_quotaEl saldo está vacío o se alcanzó el límite de gasto por claveRecarga el saldo o aumenta el límite de esa clave
model not foundIdentificador incorrectoUsa un identificador exacto como claude-sonnet-5; explora /models
429 rate limitDemasiadas solicitudes en poco tiempoEspera 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.

Ninguna de las dos opciones es gratuita. Anthropic concede a los nuevos usuarios una pequeña cantidad de créditos gratuitos y, después, factura por token. Kunavo no ofrece crédito gratuito a las cuentas nuevas y empieza con una recarga mínima de $10. Quienes busquen acceso gratuito permanente a la API de Claude no lo encontrarán en ninguna de las dos opciones.

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.
Para consultar las tarifas de cada modelo y ejemplos de costes detallados, consulta la guía de precios de la API de Claude.

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.

Próximos pasos