(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
- Inicia sesión en la Consola y ve a Gestión de Tokens en la izquierda.
- Haz clic en Añadir token en la parte superior de la página.
- 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.
- Nombre del token: para distinguir los usos, por ejemplo
- 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):
| Escenario | Grupo recomendado | Notas |
|---|---|---|
| Claude Code (solo CLI) | claude-cconly | Admite solo conexiones de Claude Code; excelente relación calidad-precio |
| Claude (cualquier cliente) | claude-max / claude-kiro | Utilizable en varios clientes |
| Programación con Codex | codex / codex-pro / codex-plus / codex-free | Diferentes 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:
- Abre el Mercado de Modelos y selecciona un grupo en "Grupos de tokens disponibles" a la izquierda.
- 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.
