Ir al contenido principal
Español— Elegir un idioma
Menú

Créditos por adelantado

Lección 8 de 14 Actualizado el 29 de julio de 2026 Desarrollador
En esta página
  1. Modelo de prepago de xAI
  2. Consultar tu saldo
  3. Comprar créditos (recarga)
  4. Estrategias de uso de créditos
  5. Supervisión del saldo
  6. Puntos clave

Modelo de prepago de xAI

Los créditos por adelantado te permiten comprar un saldo inicial que se consume a medida que realizas llamadas a la API. Este modelo es ideal para controlar el gasto: solo gastas lo que has comprado, sin sorpresas a final de mes. Los créditos se utilizan antes que la facturación mensual.

Consultar tu saldo

El prepago invierte la relación de riesgo en comparación con la facturación mensual. Con el pospago, descubres el importe al final; con el prepago, el límite se establece por adelantado y el peor escenario posible es una interrupción del servicio: desagradable, pero acotada. Para un equipo que está explorando la API o un proyecto con un presupuesto fijo, esta es la compensación adecuada.

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

La respuesta contiene:

  • El saldo actual en dólares
  • El historial de recargas con fechas e importes
  • El historial de uso por periodo

Comprar créditos (recarga)

Para recargar tu saldo de créditos:

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/top-up" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00
  }'

Puntos importantes sobre los créditos

Los cuatro puntos siguientes tienen consecuencias concretas en cómo automatizas los procesos. El segundo es especialmente relevante: los créditos no son reembolsables. Esto descarta por sí solo la estrategia de realizar una única compra grande «por si acaso»; es mejor hacer recargas modestas y frecuentes, incluso si las automatizas, que tener capital inmovilizado en un proyecto que podría cambiar de rumbo.

  • Los créditos se cargan inmediatamente en el momento de la compra a tu método de pago predeterminado
  • Los créditos por adelantado no son reembolsables (salvo que la legislación de tu jurisdicción lo exija)
  • Los créditos se consumen con prioridad antes que la facturación mensual pospaga
  • No hay fecha de caducidad indicada para los créditos; permanecen disponibles hasta que se consuman

Flujo de facturación con créditos

Vale la pena conocer el orden de consumo antes de configurar nada, ya que determina qué muestra cada uno de tus paneles de control. Los créditos van primero; la facturación mensual entra en juego después. En otras palabras, un saldo de prepago estancado en cero mientras todo funciona significa que ya has pasado al pospago sin darte cuenta.

  1. Créditos por adelantado disponibles: los tokens se deducen del saldo de prepago
  2. Créditos agotados: el consumo cambia a facturación mensual (pospago)
  3. Límite de gasto alcanzado: las solicitudes se rechazan

Estrategias de uso de créditos

Presupuesto mensual fijo

Esta es la estrategia de presupuesto rígido: sin la facturación mensual activada, agotar los créditos detiene las llamadas en lugar de generar deuda. Acepta la compensación: el servicio se interrumpe, y es preferible que esto sea una elección explícita a un descubrimiento un viernes por la tarde. Combínala con la alerta de saldo bajo que se describe más adelante.

import requests
from datetime import datetime

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."

# Consultar saldo
balance_resp = requests.get(
    f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
balance = balance_resp.json().get("balance", 0)

# Recargar si el saldo es bajo
MONTHLY_BUDGET = 200.00
RECHARGE_THRESHOLD = 50.00

if balance < RECHARGE_THRESHOLD:
    top_up_amount = MONTHLY_BUDGET - balance
    requests.post(
        f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/top-up",
        headers={
            "Authorization": f"Bearer {MGMT_KEY}",
            "Content-Type": "application/json"
        },
        json={"amount": top_up_amount}
    )
    print(f"Recargados ${top_up_amount:.2f}")

Aprovisionamiento de proyectos

El aprovisionamiento de proyectos tiene una ventaja más allá de la contabilidad: el saldo se convierte en una medida del progreso. Si se consume la mitad de los créditos mientras solo se ha completado una cuarta parte del trabajo, obtienes esa información antes del final, cuando aún hay tiempo para decidir si reducir el alcance o cambiar de modelo.

# Presupuesto del proyecto: 500 $ durante 3 meses
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/top-up" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 500.00}'

A continuación, supervisa el uso mediante analíticas (siguiente lección) para asegurarte de que se respeta el presupuesto.

Supervisión del saldo

Alerta de saldo bajo

#!/bin/bash
BALANCE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -c "import sys,json; print(json.load(sys.stdin).get('balance', 0))")

THRESHOLD=20.00
if (( $(echo "$BALANCE < $THRESHOLD" | bc -l) )); then
    echo "ALERTA: saldo de prepago bajo ($BALANCE $)"
    # Enviar una notificación
fi

Panel de uso

Combina el saldo de prepago con la vista previa de cargos pospagos para tener una visión completa de tus costes:

# Saldo de prepago
echo "=== Créditos de prepago ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

# Cargos pospagos actuales
echo "=== Cargos pospagos ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

Puntos clave

  • GET /v1/billing/teams/{teamId}/prepaid/balance devuelve el saldo y el historial
  • POST /v1/billing/teams/{teamId}/prepaid/top-up compra créditos (se cargan inmediatamente)
  • Los créditos por adelantado no son reembolsables
  • Los créditos se consumen antes que la facturación mensual
  • Automatiza las recargas con un umbral mínimo para evitar interrupciones
  • Combina créditos por adelantado y límites de gasto para un control total de costes