Kimi API funciona con prepago: la cuenta necesita saldo para llamar y, cuando el saldo es insuficiente, puede devolver 403 o 429. La recarga en sí no es complicada; lo que realmente se presta a error son tres cosas: a qué sitio recargar, con qué titular pagar y bajo qué criterio emitir la factura.
Este artículo separa la recarga oficial de la recarga por gateway y cubre verificación de identidad, métodos de pago, tiempos de acreditación, facturas, monitoreo de saldo y compras con reembolso. Los precios concretos y los modelos disponibles se rigen por la página de precios de modelos.
Nota: Moonshot y Kimi son marcas de sus respectivos titulares; este artículo solo describe el proceso técnico y de compras. Las reglas de recarga, la política de facturas y las condiciones de reembolso pueden cambiar; antes de operar, consulta el acuerdo de recarga y las indicaciones vigentes de la página oficial.
1. Confirma primero a qué cuenta vas a recargar
| Tipo de cuenta | Entrada | Moneda de liquidación | Escenario adecuado |
|---|---|---|---|
| Plataforma abierta de Kimi, sitio chino | platform.kimi.com | RMB | Titular y operación en China |
| Plataforma abierta de Kimi, sitio internacional | platform.kimi.ai | Según la página de facturación | Titular y operación en el exterior |
| ZSQH AI Gateway | Consola del sitio | RMB | Recarga y factura unificadas para varios modelos |
El saldo del sitio chino y el del internacional no son intercambiables, y las claves tampoco. Si recargas en el sitio chino pero llamas con una clave del sitio internacional, el saldo no surtirá efecto. La cuenta del gateway es otro sistema distinto: lo que se recarga es saldo del gateway, no saldo oficial de Kimi.
Antes de recargar, revisa el nombre de la cuenta y el sitio en la página de facturación, y paga solo cuando todo coincida. En compras empresariales hay que verificar especialmente el titular: el proceso de reembolso por una recarga a la cuenta equivocada suele ser mucho más lento que la recarga misma.
2. Proceso de recarga oficial
- Inicia sesión en platform.kimi.com y entra al centro de usuario.
- Completa la verificación de identidad personal; para llamadas empresariales, completa primero la verificación de empresa.
- Abre la página de recarga y elige el importe.
- Los usuarios individuales pagan con código QR de WeChat o Alipay.
- Las empresas pueden pagar con código QR o usar la cuenta exclusiva de transferencia corporativa que indica la plataforma.
- La transferencia corporativa debe salir de una cuenta bancaria a nombre del mismo titular verificado; de lo contrario, puede no acreditarse.
- Tras la acreditación, confirma el saldo en la página de facturación y configura una alerta de saldo.
- Entra a la consola y envía una solicitud mínima para confirmar que la clave y el saldo funcionan.
La transferencia corporativa suele tardar entre uno y cinco días hábiles; una vez que el banco la registra, la plataforma normalmente la abona en unos diez minutos. En compras de cierre de mes conviene reservar tiempo y no iniciar la transferencia el mismo día en que se agota la cuota.
3. Métodos de pago y tiempos de acreditación
La recarga individual se hace principalmente por código QR y suele acreditarse rápido. La recarga empresarial añade la vía de transferencia corporativa, adecuada para equipos que necesitan contrato, reembolso y factura.
Hay varios detalles que se pasan por alto:
- Titular de la transferencia: debe coincidir con el titular verificado; los pagos de subsidiarias o empresas vinculadas pueden ser rechazados.
- Aviso de acreditación: la transferencia corporativa no es inmediata; tras la confirmación de finanzas alguien debe hacer seguimiento, no basta con esperar el mensaje del sistema.
- Nivel de recarga: la plataforma clasifica a los usuarios por importe acumulado, y el nivel influye en la concurrencia y los límites; los cupones no cuentan para el acumulado.
- Tipo de cambio y comisiones: el sitio internacional liquida en la moneda de la página de facturación y el pago transfronterizo puede generar comisiones de conversión; cuando el gateway cotiza en RMB, la conversión aplicable se rige por la página de pago.
- Importe mínimo: si existe un mínimo de recarga y un máximo por operación depende de lo que indique la página, que es la referencia vigente.
Si tu operación tiene requisitos claros de concurrencia, revisa antes de recargar el nivel y los límites actuales para evitar que «el dinero llegue pero la concurrencia no alcance». Las reglas de límite se rigen por la documentación oficial.
4. Cómo emitir la factura
La plataforma permite solicitarla en línea desde la página de gestión de facturas. Hay dos criterios habituales:
| Criterio de facturación | Escenario adecuado | Observaciones |
|---|---|---|
| Por importe recargado | Recargar primero y consumir después, con reembolso anticipado | Lo no consumido también queda facturado, y un reembolso resulta más complejo |
| Por importe consumido | Liquidación según el uso real | Requiere solicitudes periódicas; útil para conciliación mensual |
Los usuarios con verificación personal pueden emitir factura a nombre personal o a nombre de empresa; los usuarios con verificación empresarial solo pueden emitirla a nombre del titular verificado. El concepto suele ser servicios técnicos; la descripción exacta, la tasa impositiva y las notas se rigen por la página de facturación.
Antes de emitir, confirma tres cosas: que el nombre y el número fiscal coincidan con lo que exige finanzas, si el criterio es recarga o consumo, y si el tipo de factura cumple los requisitos de reembolso. Descubrir un error en el nombre después de emitir obliga a anular y volver a emitir, y ambos trámites llevan tiempo.
La recarga por gateway se rige por las reglas de facturación del gateway. En compras unificadas de varios modelos, una sola factura cubre varios modelos y simplifica la conciliación, pero antes de pagar hay que aclarar la moneda, el titular de la factura y el concepto.
5. Saldo, alertas y conciliación de consumo
La plataforma ofrece una interfaz de consulta de saldo que puede integrarse al monitoreo propio:
curl "https://api.moonshot.cn/v1/users/me/balance" \
-H "Authorization: Bearer $MOONSHOT_API_KEY"
El contenido devuelto depende de la respuesta real; basta con evaluar el campo de saldo disponible. No dependas solo de la página de la consola: el sistema de negocio debe tener una alerta de saldo independiente.
Se recomienda monitorear en cuatro capas:
- Alerta por umbral de saldo: aviso por SMS o mensaje corporativo cuando el saldo baja del importe definido.
- Alerta por aumento brusco del consumo diario: se activa cuando el consumo de un día supera cierto múltiplo del promedio de los últimos siete días.
- Conciliación por proyecto: separar el consumo por clave, proyecto y modelo para identificar las llamadas de crecimiento más rápido.
- Monitoreo de solicitudes fallidas: distinguir falta de saldo, límites y errores del servidor para no tratar todos los 429 como problemas de saldo.
La alerta de saldo solo evita un corte repentino; no sustituye la gestión presupuestaria. Fijar un límite mensual por proyecto es más controlable que recargar cuando la cuenta ya está vacía.
6. Reembolsos, cupones y vigencia
Antes de recargar, lee el acuerdo de recarga. Si se admiten reembolsos, bajo qué condiciones y en qué plazo depende del acuerdo y de la respuesta del servicio de atención; no supongas que «lo que no se usó se puede devolver».
Sobre los cupones hay tres puntos a tener en cuenta:
- Los cupones suelen tener un alcance definido y puede que no cubran ciertos modelos.
- Normalmente no cuentan para la recarga acumulada ni elevan el nivel de límites.
- Su vigencia y posibilidad de acumulación se rigen por las condiciones indicadas en el cupón.
Las compras empresariales no deben incluir cupones en el presupuesto. Presupuesta sobre recarga en efectivo y usa los cupones solo como margen de reserva.
7. Recarga oficial frente a recarga por gateway
El proceso de recarga por gateway suele ser más corto: inicia sesión en la consola del gateway, elige el importe, paga en línea y confirma el saldo en la página correspondiente. Los canales de pago, el importe mínimo y las reglas de facturación se rigen por la página de recarga del gateway.
| Criterio | Recarga oficial | ZSQH AI Gateway |
|---|---|---|
| Moneda | RMB (sitio chino) | RMB |
| Método de pago | WeChat, Alipay, transferencia corporativa | Según la página de recarga del gateway |
| Factura | Solicitud en la página oficial de facturas | Según las reglas del gateway |
| Alcance de modelos | Serie Kimi | Cuenta unificada para varios modelos |
| Consulta de saldo | Interfaz y consola oficiales | Consola del gateway |
| Escenario adecuado | Solo Kimi y titular bien definido | Varios modelos, compra y conciliación unificadas |
Si usas un solo modelo y el proceso financiero es simple, la recarga oficial es la vía más directa. Si usas modelos de varios proveedores y quieres una factura que cubra a todos, el gateway simplifica la gestión. Las dos vías pueden convivir: conexión directa para el negocio crítico y gateway para pruebas y experimentos con varios modelos.
8. Lista de compras y reembolso
- Confirma el titular de uso, el sitio y el nombre de la cuenta.
- Confirma el importe de recarga, la moneda y la vía de pago.
- Confirma el nombre de la factura, el número fiscal, el concepto y el criterio de emisión.
- Confirma el tiempo de acreditación y reserva días hábiles en compras de cierre de mes.
- Confirma si el nivel de límites cubre los requisitos de concurrencia.
- Confirma que la alerta de saldo y el presupuesto mensual estén configurados.
- Guarda registros de recarga, facturas y estados de cuenta para auditorías trimestrales.
Preguntas frecuentes
¿Por qué no se acreditó el saldo después de recargar?
El pago por código QR suele ser rápido; la transferencia corporativa depende del tiempo de procesamiento bancario y normalmente requiere de uno a cinco días hábiles, tras lo cual la plataforma abona el importe. Revisa primero si el titular de la transferencia coincide con el titular verificado y luego contacta a finanzas y al servicio de atención.
¿Qué hago si recargué en el sitio equivocado?
El saldo del sitio chino y el del internacional no son intercambiables. Confirma primero la cuenta pagadora y el titular receptor, y sigue las indicaciones del servicio de atención. No sigas recargando en la cuenta equivocada para evitar que el importe siga creciendo.
¿La factura se emite por recarga o por consumo?
Ambos criterios son posibles y dependen del ritmo de reembolso. Facturar por recarga facilita el reembolso anticipado, pero lo no consumido también queda facturado; facturar por consumo refleja mejor el costo real, aunque exige solicitudes periódicas. Confirma el criterio con finanzas antes de emitir.
¿Se puede reembolsar una recarga de Kimi API?
Se rige por el acuerdo de recarga y la respuesta del servicio de atención. Las condiciones pueden variar según el titular y el método de pago; confírmalas antes de recargar, sobre todo en transferencias corporativas de importe alto.
¿Por qué un cupón no descontó?
Revisa primero el alcance y la vigencia del cupón; puede que no cubra ciertos modelos. Los cupones tampoco suelen contar para la recarga acumulada ni elevar el nivel de usuario y el límite de solicitudes.
Siguiente paso
Regístrate en ZSQH AI Gateway y revisa la página de recarga para confirmar la moneda, la factura y los modelos disponibles; después decide entre conexión directa oficial y recarga unificada por gateway. Los precios y criterios de facturación se rigen por los precios de modelos.
Lecturas relacionadas:
