La API de Rerank suele aparecer en la factura de RAG junto con embeddings y modelos generativos. Pocos equipos la recargan por separado, pero los problemas son frecuentes: recargar una clave de prueba, pagar en yuanes en el sitio internacional, emitir la factura con un nombre incorrecto o descubrir que el saldo se agotó cuando ya es tarde.
Este artículo separa la recarga directa con el proveedor de la recarga a través de un gateway y cubre tipos de cuenta, moneda y tipo de cambio, facturas, alertas de saldo, reembolsos y el proceso de compra. Los precios y modelos disponibles se rigen por los precios de modelos del sitio.
Nota: Cohere, Jina AI y Voyage AI son marcas de sus respectivos titulares; este artículo solo describe aspectos técnicos y el proceso de compra. Las reglas de recarga, la política de facturación, las condiciones de reembolso y la forma de cobro pueden cambiar; antes de operar, consulta el acuerdo oficial y los avisos de la página de facturación.
1. Confirma primero en qué cuenta se deposita el dinero
| Tipo de cuenta | Forma habitual | Moneda de liquidación | Escenario adecuado |
|---|---|---|---|
| Cuenta del proveedor (sitio internacional) | Saldo prepago o pospago por uso | Dólares y otras monedas | Integración directa con un solo proveedor |
| Cuenta del proveedor (sitio local) | Prepago en yuanes, transferencia empresarial | Yuanes | Entidad local que necesita factura nacional |
| Cuenta de gateway de IA | Saldo prepago en yuanes | Yuanes | Saldo y facturación unificados para varios modelos |
| Cuenta de mercado cloud | Se integra en la factura cloud | Yuanes o dólares | Equipos que ya usan esa nube y quieren consolidar |
Los saldos de distintos sitios y regiones normalmente no son intercambiables, y las claves tampoco. Rerank suele compartir saldo con embeddings; antes de recargar, revisa los conceptos de cobro en la página de facturación.
El saldo del gateway es un anticipo de la cuenta del gateway, no el saldo oficial del proveedor; una clave oficial conectada a la dirección del gateway fallará. En compras corporativas, verifica primero la entidad del contrato, la del cobro y la de facturación.
2. Recarga y pago directos con el proveedor
- Crea la cuenta y verifica el correo; para uso empresarial, completa antes la verificación de la empresa.
- Confirma si usas una clave de prueba o una de producción; las claves de prueba tienen límites de velocidad y no sirven para producción.
- En la página de facturación, elige el método de pago: saldo prepago, paquete de tokens o un método de pago vinculado con liquidación por uso.
- Confirma la moneda de liquidación, la dirección de facturación y los datos fiscales; en pagos transfronterizos, confirma también la entidad receptora.
- Haz primero un pago pequeño y verifica que el abono y el cobro funcionen correctamente.
- Configura alertas de umbral de saldo; si la plataforma admite recarga automática, define el monto que la activa.
- Envía una solicitud mínima de rerank con la clave de producción para confirmar que funciona.
- Guarda los registros de recarga, las facturas y los comprobantes de pago.
Las diferencias entre proveedores están sobre todo en el ritmo de facturación:
- Cohere cobra por search unit; las claves de prueba y de producción tienen límites de velocidad distintos, así que confirma el método de pago antes de actualizar.
- Voyage cobra por tokens y puede incluir una cuota gratuita; al superarla, liquida según el uso.
- Jina cobra por tokens de entrada, vende paquetes de tokens y permite recarga automática al alcanzar un umbral de saldo.
El pospago se factura mensualmente y requiere un método de pago estable; el prepago se compra antes de usar y conviene a equipos con presupuesto máximo fijo. El monto mínimo y la revisión de crédito se rigen por la página correspondiente.
3. Proceso de recarga en el gateway
La recarga en el gateway suele tener menos pasos:
- Regístrate en ZSQH AI Gateway e inicia sesión en la consola.
- Abre la página de recarga, elige el monto y paga en línea en yuanes.
- Cuando se acredite, confirma el monto y la moneda en la página de saldo.
- Crea una clave de API y apunta
base_urla la dirección del gateway. - Envía una solicitud mínima de rerank para validar.
Antes de recargar, confirma si el modelo de rerank está disponible, si el saldo se comparte entre modelos y cómo se emite la factura. La lista de modelos y los precios se rigen por los precios de modelos.
Para equipos que usan embeddings, Rerank y modelos generativos a la vez, el gateway ofrece un solo saldo, un solo conjunto de claves y una sola factura, lo que simplifica la conciliación. Antes de integrar, confirma los límites de velocidad, los tiempos de espera y las condiciones de datos.
4. Moneda, tipo de cambio y comisiones
| Concepto | Cuenta internacional del proveedor | Gateway en yuanes | Qué confirmar |
|---|---|---|---|
| Moneda de facturación | Dólares y otras | Yuanes | La moneda que muestra la página de pago |
| Tipo de cambio | El de la tarjeta o el banco | Precio en yuanes de la plataforma | Si ya incluye el costo de conversión |
| Comisión transfronteriza | Puede existir | Normalmente no hay transferencia internacional | El detalle de la factura |
| Reembolso | Devolución por la misma vía | Según las reglas del gateway | Quién asume la pérdida cambiaria y las comisiones |
Pagar una factura en dólares con una tarjeta en yuanes puede generar una comisión por conversión; cuando el reembolso vuelve por la misma vía, la pérdida cambiaria suele asumirla quien paga. Las recargas grandes pueden dividirse en varias operaciones, pero no retrases el servicio solo por esperar un mejor tipo de cambio. Deja un margen en el presupuesto, con una proporción definida por la política financiera.
5. Cómo emitir la factura
| Criterio de facturación | Escenario adecuado | Consideración |
|---|---|---|
| Sobre el monto recargado | Recargar primero y reembolsar después | La parte no consumida también se factura; un reembolso puede requerir una nota de crédito |
| Sobre el monto consumido | Conciliación mensual y registro del costo real | Requiere solicitudes periódicas y un proceso más largo |
Antes de emitir, confirma el nombre del receptor, el número fiscal, el concepto, la tasa y el tipo de factura; el concepto se rige por la página de facturación. La entidad del contrato, la del pago y la del receptor de la factura deben coincidir; de lo contrario, el reembolso y la auditoría suelen trabarse.
Que un proveedor extranjero pueda emitir una factura de IVA china depende de la entidad contratante y de sus reglas de facturación; pide a finanzas que lo confirme antes de pagar. El gateway aplica sus propias reglas y la factura consolidada simplifica el proceso, pero hay que confirmar que el concepto cubra el contenido real de la compra.
6. Alertas de saldo y monitoreo del uso
No dependas solo de la página de la consola. Conviene implementar cuatro niveles de monitoreo:
- Alerta por umbral de saldo: aviso por SMS o mensajería corporativa cuando el saldo baje del monto definido.
- Alerta por aumento brusco del consumo diario: se activa cuando el gasto de un día supera cierto múltiplo del promedio de los últimos siete días.
- Conciliación por proyecto: separa por clave, proyecto y modelo para identificar las llamadas que más crecen.
- Monitoreo de solicitudes fallidas: distingue falta de saldo, límite de velocidad y errores del servidor para no atribuir todos los 429 a un problema de saldo.
En el reordenamiento también hay que vigilar los aumentos repentinos del número de documentos candidatos y las tareas de reindexación en segundo plano, ya que ambos elevan notablemente el consumo diario.
Con el uso diario exportado puedes calcular cuánto durará el saldo:
import csv
# Ajusta los nombres de columna al archivo exportado; cost_cny es el gasto diario
daily_cost = []
with open("rerank_usage.csv", newline="", encoding="utf-8") as f:
for row in csv.DictReader(f):
daily_cost.append(float(row["cost_cny"]))
avg = sum(daily_cost[-7:]) / min(7, len(daily_cost))
balance = float(input("Saldo actual (yuanes): "))
print(f"Consumo medio de los últimos 7 días: {avg:.2f} yuanes/día")
print(f"Días estimados disponibles: {balance / avg:.1f}" if avg else "Uso insuficiente para estimar")
El script solo hace aritmética; el cobro real también depende de impuestos, descuentos por cuotas de regalo y reembolsos.
7. Reembolsos, vigencia y cupones
Antes de recargar, lee el acuerdo de recarga. Si se admite reembolso, las condiciones y el plazo de acreditación se rigen por el acuerdo y por la respuesta escrita del servicio de atención; no des por hecho que «lo que no se usó se devuelve».
Sobre los cupones y las cuotas de regalo, hay tres puntos a tener en cuenta:
- Tienen un alcance de aplicación; puede que algunos modelos no sean compatibles.
- Tienen fecha de vencimiento y caducan.
- No cuentan como saldo pagado ni participan en reembolsos.
El presupuesto corporativo debe basarse en recargas en efectivo; los cupones son solo un margen. Antes de una recarga grande, deja por escrito las condiciones de reembolso.
8. Recarga directa frente a recarga en el gateway
| Criterio | Cuenta del proveedor | ZSQH AI Gateway |
|---|---|---|
| Moneda | Dólares o yuanes, según el sitio | Yuanes |
| Método de pago | Prepago, paquete de tokens o pago vinculado | Página de recarga del sitio |
| Factura | Según las reglas del proveedor; las entidades extranjeras requieren confirmación de finanzas | Según las reglas de facturación del gateway |
| Alcance de modelos | Un solo proveedor | Saldo unificado para varios modelos |
| Saldo | No es intercambiable entre sitios | Un solo saldo de cuenta |
| Escenario adecuado | Un proveedor, volumen alto, conexión directa | Varios modelos, compra y conciliación unificadas |
Si usas un solo proveedor, con volumen alto y finanzas simples, la cuenta directa es la opción más clara. Si usas modelos de varias empresas y prefieres pagar en yuanes con factura consolidada, el gateway simplifica el trabajo. Ambas rutas pueden coexistir.
9. Lista de compras corporativas
- Confirma que coincidan la entidad usuaria, la contratante, la pagadora y la receptora de la factura.
- Confirma el sitio de la cuenta, la región y la moneda de liquidación.
- Confirma el monto de recarga, la vía de pago y el tiempo de acreditación.
- Confirma el tipo de factura, el nombre, el número fiscal, el concepto y el criterio de facturación.
- Confirma las condiciones de reembolso, la vigencia del saldo y las reglas de cupones.
- Confirma que el modelo de rerank esté disponible y que los límites de velocidad cubran la concurrencia.
- Confirma las alertas de saldo, el presupuesto diario y el responsable.
- Confirma los permisos de la clave, la retención de registros y las condiciones de datos.
- Reserva días hábiles para compras que cruzan de mes.
- Guarda registros de recarga, facturas, comprobantes y contratos para la auditoría trimestral.
Preguntas frecuentes
¿La API de Rerank necesita una recarga aparte?
En la mayoría de los casos, no. Rerank y embeddings suelen compartir el saldo de la cuenta y la factura se calcula por llamada; en un gateway, un solo saldo puede cubrir varios modelos. Se rige por la página de facturación.
¿Se puede reembolsar el dinero recargado en el gateway?
Se rige por el acuerdo de recarga del gateway y la respuesta escrita del servicio de atención. El tratamiento puede variar según el método de pago y el monto; antes de una recarga grande, confirma las condiciones y no asumas que el reembolso es inmediato.
¿Por qué sigue apareciendo saldo insuficiente después de recargar?
Revisa primero si la clave pertenece a la cuenta recargada, si el sitio es correcto y si el saldo se acreditó; luego confirma si el modelo está cubierto por ese saldo y si el error corresponde a falta de saldo o a un límite de velocidad.
¿Un proveedor extranjero puede emitir una factura de IVA china?
Depende de la entidad contratante y de las reglas de facturación del proveedor. Pide a finanzas que confirme el tipo de factura, el concepto y la tasa antes de pagar; si necesitas una factura de IVA deducible, prioriza una entidad local o un gateway que pueda emitirla.
¿Cómo presupuestar la volatilidad del tipo de cambio?
Deja un margen según la política financiera y revisa trimestralmente los cargos reales. Los equipos que necesitan un costo fijo en yuanes pueden preferir un gateway en yuanes, pero su precio puede incluir el costo del servicio; compáralo igualmente con la cuenta directa.
Siguientes pasos
Regístrate en ZSQH AI Gateway, revisa en la página de recarga la moneda, las reglas de facturación y los modelos disponibles, y haz una recarga pequeña para ejecutar una solicitud de rerank. Los precios, las unidades de facturación y la lista de modelos se rigen por los precios de modelos.
Lecturas relacionadas:
