Claves de API

Con una sola clave de Half Off Dev tu código accede a Claude, GPT y Gemini a mitad del precio oficial. Todas tus claves descuentan del mismo saldo prepago, pero cada una puede tener sus propios límites: si un script se descontrola, solo gasta lo que su clave le permite y el resto de tu infraestructura sigue funcionando. Puedes crear todas las que necesites.

Crear una clave#

1. 1

   Abre la página de claves

   En el panel, entra en API keys y pulsa Nueva clave.

2. 2

   Ponle nombre y elige grupo

   Usa un nombre que indique dónde vive la clave, como support-bot-prod o nightly-evals. En Grupo de canales lo normal es dejar Auto — el mejor disponible; elige Claude · Value, GPT · Value o Gemini · Value solo si todas las peticiones de esa clave deben ir a ese grupo. Más detalles en Grupos de canales.

3. 3

   Añade límites si los necesitas

   En Limits & restrictions puedes acotar el gasto, el ritmo de peticiones, la concurrencia, los modelos permitidos y la vigencia. La tabla de abajo explica cada opción. Todo, salvo el grupo, se puede cambiar después.

4. 4

   Cópiala ahora

   Pulsa Crear. Un aviso en la parte superior muestra la clave completa una única vez. Cópiala ya, o pulsa Usar en herramientas… para configurar Claude Code, Codex CLI y otros clientes con ella directamente. Tras pulsar Listo, la lista solo muestra el comienzo, por ejemplo ho-a1b2c3….

Opciones de cada clave#

En la lista ves el grupo y los límites de cada clave, cuánto lleva gastado (Gastado) y cuándo se usó por última vez (Último uso).

Qué pasa al alcanzar un límite#

Half Off Dev rechaza la petición antes de que llegue al modelo. No se cobra, no se registra en Logs y el error llega en el formato del endpoint al que llamaste.

Las peticiones a los endpoints de Gemini reciben los mismos códigos de estado, con el formato de error de Gemini. Un 429 provocado por un límite de la clave incluye la cabecera Retry-After con los segundos que debes esperar.

Así recibe cada SDK el rechazo por límite de gasto:

{
  "type": "error",
  "error": {
    "type": "billing_error",
    "message": "This API key has reached its spend limit."
  }
}

El límite de gasto se comprueba al iniciar cada petición. Una petición que ya está en marcha termina siempre, de modo que el gasto de la clave puede quedar un poco por encima del tope. El resto de cuerpos de error, y cuándo reintentar, están en Errores.

Modificar una clave#

Pulsa Editar en una clave para cambiar su nombre, límite de gasto, fecha de caducidad, límites de ritmo y concurrencia o lista de modelos. El cambio se aplica desde la siguiente petición. Si vacías un campo, ese límite desaparece.

Lo único que no se puede editar es el grupo de canales. Para mover tráfico a otro grupo, crea una clave en ese grupo y rota hacia ella.

Rotar sin cortes#

1. Crea la nueva clave con el mismo grupo y los mismos límites.
2. Despliégala en tu aplicación o gestor de secretos.
3. Vigila el Último uso de la clave antigua hasta que deje de cambiar.
4. Revoca la clave antigua.

Hazlo de forma periódica, cuando alguien con acceso deje el equipo y de inmediato si sospechas que una clave se ha filtrado.

Revocar una clave#

Pulsa Revocar y después Confirmar revocación. Desde la siguiente petición la clave queda rechazada, y no hay vuelta atrás. Sigue en la lista, en gris, con su historial de gasto, y sus peticiones anteriores permanecen en Logs.

Conectar un cliente de programación#

Cada clave tiene un botón Usar en herramientas con la configuración lista para Claude Code, Codex CLI, Gemini CLI, Cherry Studio, DeepChat y AionUI, con importación en un clic en las aplicaciones que lo admiten. Cada cliente tiene su propia guía en Integraciones.

Hábitos para controlar el gasto#

• Una clave por aplicación y por entorno. Producción, staging, CI y tu portátil, cada uno con la suya: ves el gasto por clave y puedes revocar una sin tocar las demás.
• Pon tope a todo lo que corre sin supervisión. Trabajos por lotes, pipelines de CI y bucles de reintento pueden desbocarse. El límite de gasto acota el coste y el de peticiones por minuto frena el bucle.
• Permite solo lo que el trabajo necesita. Una clave que clasifica tickets con un modelo pequeño no tiene por qué llegar al más grande.
• Pon fecha de fin a las claves temporales. Demos, colaboradores externos y pruebas reciben una clave que caduca sola.
• Nunca envíes una clave al navegador o al móvil. Llama a Half Off Dev desde tu servidor. Consulta Autenticación.