Créditos por adelantado
En esta página
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.
- Créditos por adelantado disponibles: los tokens se deducen del saldo de prepago
- Créditos agotados: el consumo cambia a facturación mensual (pospago)
- 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/balancedevuelve el saldo y el historialPOST /v1/billing/teams/{teamId}/prepaid/top-upcompra 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