Cómo obtener una clave de API de Claude: rutas oficiales y de gateway

Hay dos formas de obtener una clave de API de Claude. La vía oficial, directamente desde la consola de Anthropic, y la vía de una puerta de enlace que ofrece un endpoint compatible con Anthropic. Ambas llaman a los mismos modelos Claude; en el código solo cambian la base URL y la cadena de la clave.

A continuación resumimos ambas vías y también tratamos los problemas de pago que aparecen especialmente a menudo en Corea del Sur.

Vía 1 — obtenerla directamente desde la consola de Anthropic

Crea una cuenta de Anthropic, registra un método de pago y genera una clave de API en la consola. Las claves de esta vía se facturan al precio oficial de Anthropic; su ventaja es que recibes directamente la documentación y el soporte oficiales.

En Corea del Sur, la mayoría de los bloqueos se producen durante el pago. Las tarjetas con los pagos internacionales bloqueados no se pueden registrar; permitir los pagos internacionales en la aplicación de la entidad emisora y volver a intentarlo suele resolverlo.

Vía 2 — clave de una puerta de enlace

Es una forma de llamar a modelos Claude sin una cuenta de Anthropic. Kunavo ofrece tanto la Messages API de Anthropic como una API compatible con OpenAI, por lo que basta con cambiar la base URL y la clave en el código existente.

Esta ruta también presenta menos bloqueos durante el pago. La recarga prepago de Kunavo ofrece KakaoPay, Naver Pay, PAYCO, Samsung Pay y tarjetas nacionales sin pagos internacionales habilitados como métodos de pago cuando la pantalla muestra wones (TOSS Pay no está disponible). El saldo recargado se utiliza para llamadas a la API de Claude y no sirve para pagar una suscripción de Anthropic.

# OpenAI SDK를 그대로 쓰면서 base_url만 바꾸는 방식.
# 코드에서 바뀌는 줄은 base_url 한 줄뿐입니다.
from openai import OpenAI

client = OpenAI(
    base_url="https://api.kunavo.com/v1",
    api_key="sk-kn-...",
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "안녕하세요"}],
)
print(resp.choices[0].message.content)

Si tu código usa el formato nativo de Anthropic, establece la URL base en https://api.kunavo.com; en este caso no añadas /v1. Las diferencias entre ambos formatos se explican en la documentación de ANTHROPIC_BASE_URL.

Tarifas

Las tarifas se leen del catálogo cuando se renderiza la página, por lo que este documento no puede desviarse de los importes reales facturados. Los métodos de pago y la información sobre tarjetas nacionales se detallan en Precios y pagos de la API de Claude.

Comprobación durante los 30 segundos posteriores a la emisión

Cuando recibas la clave, haz una llamada inmediatamente. Si realizas primero esta comprobación, podrás determinar al instante si cualquier error posterior se debe a la clave.

# 발급받은 키가 실제로 동작하는지 확인하는 최소 요청.
# 200이 오면 키는 정상입니다.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,
       "messages":[{"role":"user","content":"안녕하세요"}]}'

Si recibes 200, la clave es válida. 401 suele indicar un tipo de encabezado de autenticación incorrecto; 429 indica limitación de velocidad y 529 indica sobrecarga del servicio ascendente. Estos dos últimos errores no están relacionados con la clave. Las acciones para cada error se encuentran en Resumen de errores de Claude Code.

Separar las claves por uso

Es más seguro separar las claves por finalidad. Si revocas una, las demás no se ven afectadas, y también puedes establecer un límite de uso mensual para cada clave. El límite se comprueba antes de ejecutar la solicitud y se restablece al comienzo de cada mes, por lo que resulta especialmente útil al entregar claves a agentes que funcionan sin supervisión humana.

Preguntas frecuentes