Autenticación

La API de CheaperGen usa claves secretas. Envía tu clave como token Bearer en el encabezado Authorization de cada solicitud a un endpoint autenticado:

Authorization: Bearer cg_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Crear una clave#

Abre Panel → Claves de API y haz clic en Crear clave. Ponle un nombre que indique dónde se usa (por ejemplo, production-backend). Las claves empiezan por cg_live_ y van seguidas de 32 caracteres aleatorios.

La clave completa se muestra una sola vez. Solo almacenamos su hash SHA-256, así que no podemos volver a mostrarla; si la pierdes, revócala y crea otra. El panel muestra cada clave por su prefijo, fecha de creación y último uso.

Hacer una solicitud autenticada#

const resp = await fetch("https://cheapergen.com/api/v1/account", {
  headers: { Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}` },
});
console.log(await resp.json());

import os, requests

resp = requests.get(
    "https://cheapergen.com/api/v1/account",
    headers={"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"},
)
print(resp.json())

curl https://cheapergen.com/api/v1/account \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY"

Endpoints públicos#

Los endpoints de catálogo y precios no requieren una clave, así que puedes llamarlos desde el navegador o durante la compilación: GET /api/v1/models, GET /api/v1/models/{vendor}/{model} y POST /api/v1/quote/{endpoint}. El resto —enviar, consultar y cancelar generaciones, cargar archivos y gestionar tu cuenta— requiere una clave. Consulta referencia de la API para ver la lista completa.

Mantén tus claves seguras#

• Solo en el servidor. No incluyas claves en una aplicación móvil, un paquete del navegador ni un repositorio público. Cualquier persona que tenga la clave puede gastar tu saldo.
• Usa variables de entorno o un gestor de secretos; nunca guardes la clave en el código fuente. Los ejemplos de esta documentación la leen desde CHEAPERGEN_API_KEY.
• Una clave por entorno o servicio, para poder revocar una sin afectar a las demás.
• Rota las claves: crea una clave nueva, impleméntala y después revoca la anterior. La revocación surte efecto de inmediato.

¿Estás creando una aplicación para el cliente?#

Reenvía las solicitudes a través de tu propio backend: tu servidor guarda la clave, autentica a tus usuarios y reenvía las solicitudes de generación. Usa webhooks para saber cuándo termina una tarea y enviar el resultado a tus usuarios.

Errores de autenticación#

Una clave ausente, mal formada o revocada devuelve 401 unauthorized:

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or revoked API key"
  }
}

Las solicitudes de nuestro sitio web (Studio y el entorno de prueba en las páginas de modelos) se autentican mediante tu sesión iniciada, no con una clave; aparecen en tu panel con el origen playground.