Lección 2 de 4 · 7 minutos

Crea una cuenta y una clave

Regístrate, aprende qué contiene un espacio de trabajo y crea una clave de API que mantengas fuera de tu código.

Regístrate en phaseo.app con Google, GitHub, GitLab o un correo y una contraseña. Cada cuenta empieza con un espacio de trabajo personal, que basta para un proyecto pequeño.

El espacio de trabajo es la unidad a la que pertenece todo. Contiene tus claves de API, los ajustes de enrutamiento, los preajustes, los guardrails y quién tiene acceso de administración. Las solicitudes de pago usan el saldo de créditos del espacio de trabajo. Puedes añadir más espacios de trabajo, por ejemplo uno por producto o por entorno, después de tu primer depósito de créditos. Tener más espacios de trabajo no cambia tus precios.

Crea una clave en Ajustes → Claves de API y selecciona Crear clave. Elige el espacio de trabajo, ponle un nombre a la clave y elige un preajuste:

  • Desarrollo: un límite de gasto diario bajo para aplicaciones locales y prototipos.
  • Producción: sin límites predefinidos. Añade límites más adelante si los necesitas.
  • CI: un límite de solicitudes para pruebas, evaluaciones y tareas de publicación.
  • Entorno de pruebas: un límite estricto para demos, pruebas y experimentos compartidos.

Las claves pueden tener límites diarios, semanales o mensuales de solicitudes y de gasto. Cuando se alcanza un límite, las solicitudes con esa clave devuelven 429 con key_limit_exceeded.

La clave solo se muestra una vez. Cópiala y guárdala como variable de entorno:

export PHASEO_API_KEY="phaseo_v1_sk_..."

Trátala como una contraseña. Léela de PHASEO_API_KEY en código del servidor. Nunca la pongas en tu código, en un repositorio, en un navegador o una aplicación móvil, ni en un chat con una persona o un agente. Usa una clave por aplicación y entorno, para poder sustituir una sin romper las demás, y elimina las claves que ya no uses.

Comprueba lo que has aprendido

¿Dónde debe estar tu clave de API de Phaseo?

Ponlo en práctica

Estás creando un prototipo que llama a un modelo de pago dentro de un bucle. Te preocupa que un fallo genere una factura alta durante la noche. ¿Qué puedes hacer al crear la clave?

Mostrar la respuesta

Elige el preajuste Desarrollo o Entorno de pruebas, que fijan un límite de gasto bajo, o define un límite de gasto diario en la clave. Si el bucle alcanza el límite, las solicitudes devuelven 429 con key_limit_exceeded en lugar de seguir gastando. Usa una clave distinta para producción.

Idea clave

Tu espacio de trabajo es dueño de las claves y los créditos; crea una clave por aplicación y entorno, y guárdala en PHASEO_API_KEY en el servidor.

Enlaces relacionados

El progreso se guarda en este navegador.

Revisado por última vez el 17 de noviembre de 2026