ES ▾
URL base https://api.uncensoredaiapis.com/v1Modelo uncensored
Obtener clave de API
Uncensored AIGuía de migración

Rastreador de costos de API de IA: monitorea el gasto con encabezados

Puedes construir un rastreador de costos de API de IA en unas cincuenta líneas, porque cada respuesta ya indica tu saldo restante. Esta guía muestra cómo registrar el gasto por petición, leer los endpoints de saldo y activar una alerta antes de que se agoten los créditos.

Actualizado

Paneles flotantes del panel de control con un gráfico en caída y una campana de alerta ámbar, ilustrando el monitoreo del gasto de API
Cinco piedras de toque brillantes que llevan a un cubo de servidor, ilustrando los pasos para comenzar con una API estilo OpenAI

Puntos clave

  • Cada respuesta incluye un encabezado X-Balance-USD con tu crédito restante.
  • GET /v1/balance y el endpoint credit_grants devuelven el saldo bajo demanda.
  • El costo por llamada es (entrada x 0,15 + salida x 0,50) / 1.000.000 dólares.
  • Registra en CSV y alerta cuando el saldo baje de un umbral.

De dónde vienen los números

El crédito prepago facilita el seguimiento de costos porque el proveedor ya lleva un total acumulado. Lo obtienes en tres lugares:

  • El encabezado de respuesta X-Balance-USD en las llamadas a la API, que muestra lo que queda después de la petición.
  • GET /v1/balance, una consulta de saldo simple.
  • GET /v1/dashboard/billing/credit_grants, la ruta estilo OpenAI que las herramientas como los dashboards y los wrappers ya saben cómo llamar.

Junto a eso, cada respuesta devuelve un objeto usage con los recuentos de tokens del prompt y la respuesta. Combina los tokens con los precios ($0,15 por 1M de entrada, $0,50 por 1M de salida) y puedes calcular el costo de cualquier petición tú mismo, luego compáralo con la caída del saldo. Deberían coincidir. Si no lo hacen, has encontrado algo que investigar. Los detalles completos de los parámetros están en la documentación.

Lee el encabezado en una petición

Con curl, añade -i y mira los encabezados:

curl -si https://api.uncensoredaiapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hi."}]}' \
  | grep -i "x-balance-usd"

En Python, el SDK de OpenAI expone las respuestas crudas a través de with_raw_response, lo que te da los encabezados y el objeto analizado juntos:

from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredaiapis.com/v1", api_key="sk-your-key")

raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Say hi."}],
)
resp = raw.parse()
print(raw.headers.get("x-balance-usd"), resp.usage.total_tokens)

Un pequeño registrador que registra cada llamada

Envuelve tus llamadas en una función y escribe una fila de CSV cada vez. La fila tiene la hora, ID de petición, recuentos de tokens, costo calculado y saldo.

import csv, time
from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredaiapis.com/v1", api_key="sk-your-key")
PRICE_IN, PRICE_OUT = 0.15, 0.50   # dollars per 1M tokens
LOG = "api_spend.csv"

def cost(usage):
    return (usage.prompt_tokens * PRICE_IN + usage.completion_tokens * PRICE_OUT) / 1_000_000

def tracked_chat(messages, tag="default"):
    raw = client.chat.completions.with_raw_response.create(
        model="uncensored", messages=messages)
    r = raw.parse()
    row = [
        time.strftime("%Y-%m-%d %H:%M:%S"),
        raw.headers.get("x-request-id"),
        tag,
        r.usage.prompt_tokens,
        r.usage.completion_tokens,
        round(cost(r.usage), 6),
        raw.headers.get("x-balance-usd"),
    ]
    with open(LOG, "a", newline="") as f:
        csv.writer(f).writerow(row)
    return r, row

El argumento tag es el truco que hace útil el registro. Pasa un nombre de función como "resumen" o "chat", y luego puedes sumar el costo por etiqueta para ver qué parte del producto gasta el dinero. El ID de petición ayuda si alguna vez necesitas preguntar sobre un cargo o reportar un problema, ya que identifica la llamada exacta.

Verificación básica de los cálculos

Toma una llamada con 2400 tokens de entrada y 600 tokens de salida:

  • Entrada: 2.400 x 0,15 / 1.000.000 = $0,00036
  • Salida: 600 x 0,50 / 1.000.000 = $0,00030
  • Total: $0.00066

Mil de eso cuestan $0,66. Si tu CSV muestra un saldo que cae mucho más rápido que la suma de los costos calculados, busca reintentos que no registraste, trabajos en segundo plano usando la misma clave, o flujos que dejaste abiertos. Las peticiones fallidas o rechazadas no se cobran, por lo que los errores no deberían afectar el saldo en absoluto. Compara los totales en muchas llamadas, no en una sola, para que las pequeñas diferencias de redondeo se promedien.

Llamadas en streaming y uso

Con stream: true, los números de uso llegan al final del stream. Recógelos del último fragmento, luego registra la fila después de que el stream se cierre.

def tracked_stream(messages, tag="chat"):
    usage = None
    for chunk in client.chat.completions.create(
            model="uncensored", messages=messages, stream=True):
        if chunk.choices and chunk.choices[0].delta.content:
            yield chunk.choices[0].delta.content
        usage = getattr(chunk, "usage", None) or usage
    if usage:
        with open(LOG, "a", newline="") as f:
            csv.writer(f).writerow([time.strftime("%F %T"), "", tag,
                usage.prompt_tokens, usage.completion_tokens, round(cost(usage), 6), ""])

Si solo necesitas el saldo, llama a GET /v1/balance después de que termine el stream. Es una petición barata y también funciona como una verificación periódica desde un trabajo cron.

Suma de gastos por función

El CSV solo es útil si lo lees. Este script corto suma el costo por etiqueta y muestra el último saldo, sin paquetes adicionales.

import csv
from collections import defaultdict

totals, last_balance = defaultdict(float), None
with open("api_spend.csv") as f:
    for row in csv.reader(f):
        ts, req_id, tag, pin, pout, cost_usd, balance = row
        totals[tag] += float(cost_usd)
        last_balance = balance or last_balance

for tag, usd in sorted(totals.items(), key=lambda kv: -kv[1]):
    print(f"{tag:15s} ${usd:.4f}")
print("latest balance:", last_balance)

Ejecútalo diariamente y pega la salida en tu canal de equipo. El gasto que era invisible se convierte en un número que la gente puede discutir, y una función que cuesta diez veces las demás destaca de inmediato. Para un presupuesto aproximado, multiplica el total diario por 30 y añade un 20% de margen.

Agrega una alerta de saldo bajo

Quedarse sin crédito a mitad del día deja un producto fuera de línea, así que alerta temprano. Un trabajo cron que se ejecute cada 15 minutos es suficiente.

import requests

BASE = "https://api.uncensoredaiapis.com/v1"
THRESHOLD = 5.00   # dollars

r = requests.get(BASE + "/balance", headers={"Authorization": "Bearer sk-your-key"}, timeout=10)
print(r.status_code, r.text)   # inspect the JSON once to see the field name
# After you know the field name, parse it and compare with THRESHOLD,
# then post to your chat webhook or send an email.

Imprime el JSON sin procesar una vez y revísalo antes de escribir el código de análisis. El nombre real del campo se verifica en diez segundos, y adivinarlo a partir de un artículo puede romper la alerta en silencio. Elige un umbral que cubra al menos un día de gasto normal, que el CSV te indica: suma el costo de ayer y úsalo como mínimo.

Cuando la alerta se active, recarga. Cualquier cantidad entera desde $20 hasta $500 funciona, con +5% de crédito desde $50, +10% desde $100 y +15% desde $200, y el crédito no caduca. Para obtener una clave para el rastreador primero, usa la página de claves de API.

Hábitos para mantener el gasto predecible

  • Usa una clave por entorno para que el tráfico de prueba nunca se oculte en los números de producción.
  • Limita max_tokens en endpoints donde no se necesitan respuestas largas. Es opcional por defecto, así que las respuestas sin límite son posibles.
  • Recorta el historial de chat. Los tokens de entrada son más baratos que los de salida, pero un historial largo repetido en cada turno se acumula.
  • Revisa el total semanal por etiqueta y busca la etiqueta que representa más de la mitad de la factura.

Un hábito más: guarda el ID de petición con cada fila registrada. Si un número parece incorrecto un mes después, puedes relacionarlo con una llamada específica en lugar de discutir basándote en promedios. Debido a que las peticiones fallidas no se cobran, los reintentos por errores no añaden costo, pero los reintentos después de una respuesta exitosa sí, así que asegúrate de que tu lógica de reintento solo se active en fallos reales. Un error que reenvía una petición exitosa en un bucle es la causa más común de una factura sorpresa con cualquier API de pago por token.

Preguntas y respuestas

¿Aparece el encabezado de saldo en cada respuesta?

El encabezado X-Balance-USD forma parte de los encabezados de respuesta listados para esta API. Léelo desde la respuesta cruda y trata un valor ausente como desconocido.

¿Puedo obtener el costo sin registrar cada petición?

Sí. Consulta GET /v1/balance en un horario programado y calcula la diferencia entre las lecturas.

¿Las peticiones fallidas cambian el saldo?

No. Las peticiones fallidas o rechazadas no se cobran.

¿Qué endpoint debería usar una herramienta existente del panel de OpenAI?

Usa la ruta GET /v1/dashboard/billing/credit_grants al estilo de OpenAI, que ya admiten muchas herramientas.

Tu clave está a un formulario de distancia

Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.