Créditos y cobros
La API usa los mismos créditos que la app: una sola bolsa por organización, sin sobreprecio por integrarte.
Consultar el saldo
Con el scope credits:read, consulta el saldo vigente de tu organización en cualquier momento:
GET /v1/credits
Authorization: Bearer bxk_…
{ "balance": 1234 }Qué cobra y qué no
Solo la generación cuesta créditos. Todo lo demás — leer, empujar catálogo, exportar — es gratis.
| Operación | Cobro |
|---|---|
POST /v1/generations | Cobra al éxito, por idioma generado. Los idiomas que fallan no cobran. |
POST /v1/batches | Reserva los créditos al enviar; al ingerir el resultado cobra los éxitos y reembolsa el resto. |
POST /v1/batches/{id}/cancel | Reembolsa la reserva completa del lote. |
GET · PATCH · DELETE … | Lecturas, upsert, ediciones y borrados no cobran. |
GET /v1/export/catalog.csv | El export no cobra: ya se cobró al generar. |
Si el saldo no alcanza, la generación responde 402 ANTES de generar — nunca quedas a medias ni con cobros parciales inesperados.
Mismos precios que la app
Generar por API cuesta exactamente lo mismo que desde la app (los lotes asíncronos son más baratos que la generación síncrona, igual que en la app). El saldo es compartido: lo que gastes por API lo verás reflejado en Créditos dentro de la app, y viceversa.
El tope de gasto diario de IA también es compartido con la app. Al alcanzarlo, la generación responde 429 sin header Retry-After — no se cura reintentando; se restablece al día siguiente (UTC).
Comprar créditos
Los créditos se compran desde la app, en la sección Créditos (la API no vende créditos). Cualquier miembro de la organización puede comprar; las llaves de API solo los consumen.