Skip to content

(3) Crear una clave de API

Una clave de API (tiene el aspecto de sk-xxxxxx) es el "secreto" que ingresas en tu cliente. Equivale a las credenciales de tu cuenta, así que guárdala en un lugar seguro y nunca la filtres.

Pasos para crearla

  1. Inicia sesión en la Consola y ve a Gestión de Tokens en la izquierda.
  2. Haz clic en Añadir token en la parte superior de la página.
  3. Completa los detalles del token en el cuadro de diálogo:
    • Nombre del token: para distinguir los usos, por ejemplo Claude Code, Codex, Image.
    • Grupo del token: obligatorio; el grupo determina qué modelos puede usar el token (ver más abajo).
    • Caducidad: el valor predeterminado es "Nunca caduca", o establece un período de validez según lo necesites.
    • Cuota: incluso con "Cuota ilimitada" activada, la cuota realmente utilizable del token sigue estando limitada por el saldo de tu cuenta.
    • Restricciones de acceso: si no estás seguro, mantén los valores predeterminados; no actives a la ligera las restricciones de modelo ni las listas de IP permitidas.
  4. Haz clic en Enviar para crearlo y luego haz clic en el botón Copiar a la derecha del token para obtener la clave.

Debes elegir el grupo correcto

Un paso crítico

El grupo del token determina directamente qué modelos están disponibles. Por ejemplo, para usar Claude Code, elige un grupo Claude; para usar Codex, elige un grupo Codex. Si eliges el grupo equivocado, es fácil que te encuentres con "el modelo no existe" o con llamadas fallidas al configurar tu cliente.

Los grupos de uso común de Tianshu (consulta Grupos de Tokens para más detalles):

EscenarioGrupo recomendadoNotas
Claude Code (solo CLI)claude-cconlyAdmite solo conexiones de Claude Code; excelente relación calidad-precio
Claude (cualquier cliente)claude-max / claude-kiroUtilizable en varios clientes
Programación con Codexcodex / codex-pro / codex-plus / codex-freeDiferentes grupos de cuentas; elige según necesites
Generación de imágenes con IA生图专用Modelo de imagen GPT (gpt-image)

Ver qué modelos hay en un grupo

¿No sabes qué modelos admite un grupo? Ve al Mercado de Modelos:

  1. Abre el Mercado de Modelos y selecciona un grupo en "Grupos de tokens disponibles" a la izquierda.
  2. Las tarjetas de modelos a la derecha mostrarán los modelos disponibles en ese grupo, sus tarifas de descuento y su estado de disponibilidad.

Consulta Cómo usar el Mercado para más información.

Próximo paso

Una vez creado tu token, realiza una verificación del entorno para confirmar que tu equipo puede ejecutar las herramientas de CLI.