Referencia de la API
Facturación y saldo
Liquidación por llamada con cargo a la billetera. Los modelos con precio por token se facturan por cada 1M de tokens de entrada y de salida; los modelos de imagen / video / tareas se facturan por solicitud. Las solicitudes fallidas se reembolsan automáticamente.
#Precio por token
Los tokens de entrada y de salida se miden por separado. El precio completo de cada modelo aparece en su ficha de /models; cada solicitud completada muestra su consumo real final en Registro de solicitudes.
{
"usage": {
"prompt_tokens": 128,
"completion_tokens": 402,
"total_tokens": 530
}
}La cuota se reserva al inicio de la solicitud (estimación del peor caso a partir de max_tokens) y luego se concilia con el uso que informa el proveedor cuando termina la respuesta — solo pagas por el uso real.
#Precio por solicitud
Los modelos de imagen, video, TTS y otros basados en tareas cobran un precio fijo por llamada exitosa. Distintas resoluciones o duraciones pueden tener precios distintos — consulta siempre primero la ficha del modelo.
#Niveles de precio
Los modelos por solicitud pueden tener varios niveles en un mismo modelo: los niveles de imagen dependen del tamaño y la calidad; los de video, de la duración y la resolución. El nivel se determina a partir de los parámetros de tu solicitud al enviarla, y el precio de cada nivel aparece en la ficha del modelo.
Precios por niveles
#Reembolsos
La cuota cobrada por adelantado se devuelve automáticamente cuando una solicitud falla o una tarea asíncrona nunca se resuelve. Registro de solicitudes muestra el consumo real final, así que las llamadas fallidas no aparecen como un cargo y un reembolso separados.
#Saldo y recarga
#La billetera
Todo el uso se liquida desde una única billetera prepago — no hay facturación pospago. Todas las claves gastan del mismo saldo, salvo que la clave tenga su propio tope de cuota.
#Recargar saldo
Recarga desde Consola → Billetera. Los canales de pago disponibles (tarjeta / otros proveedores) y el importe mínimo de recarga se muestran al pagar; ahí también puedes aplicar códigos de canje, que se acreditan al instante.
El saldo no caduca. Si un pago se completa pero el saldo no cambia en unos minutos, abre un ticket de soporte con la referencia del pago.
Abrir Billetera#Saldo bajo
Cuando el saldo no cubre la estimación reservada de una solicitud, la llamada falla de inmediato con 402 insufficient_quota — no se cobra nada. Recarga y reintenta; los streams largos que ya están en curso nunca se cortan a mitad de la respuesta.
#Uso y registros
#Panel de uso
Consola → Uso muestra gráficos de tokens y gasto por modelo y por día, desglosados por clave — la forma más rápida de ver qué proyecto o modelo está generando el costo.
Abrir Uso#Consumo real
Consola → Registro de solicitudes es la fuente de verdad del gasto en API para el cliente. Cada fila contiene su timestamp, el modelo, el uso de tokens o el precio por llamada, el ID de solicitud y el importe final realmente consumido.
Abrir Uso#IDs de solicitud
Cada fila del registro de solicitudes incluye el identificador de la solicitud y el timestamp. Al abrir un ticket de soporte sobre una llamada concreta, cita esa fila (hora, modelo, ID de solicitud) — así soporte puede rastrear el intento upstream exacto.
Los prompts no se almacenan
¿Sigues con el problema?
Envíanos el ID de solicitud o el mensaje de error y lo revisaremos.