La API de Moonshot funciona con prepago: la cuenta necesita saldo para poder llamar a los modelos. Hay tres decisiones que suelen salir mal en una recarga: a qué sitio se recarga, qué entidad paga y con qué criterio se emite la factura. Este artículo desglosa el proceso de compra tanto en la plataforma oficial como en un gateway, y cubre moneda, facturas, alertas de saldo, reembolsos y reembolso de gastos. Los precios concretos se rigen por los precios de modelos.

Nota: Moonshot y Kimi son marcas de sus respectivos titulares. Este artículo solo describe el proceso técnico y de compra y no implica relación de dependencia ni representación con los titulares. Las reglas de recarga, la política de facturas y las condiciones de reembolso pueden cambiar; antes de operar, toma como referencia el acuerdo de recarga y los avisos de la página oficial.

1. Confirma primero a qué cuenta recargas

A octubre de 2026, el antiguo dominio de documentación de la plataforma Moonshot, platform.moonshot.cn, redirige a platform.kimi.com; el sitio internacional es platform.kimi.ai. Los dos sitios son independientes: una clave del sitio chino que se usa en el sitio internacional devuelve 401, y los saldos tampoco se comunican. Si recargas al sitio equivocado, el saldo no se aplicará.

Tipo de cuenta Entrada Moneda de liquidación Escenario adecuado
Sitio chino oficial platform.kimi.com Yuanes Entidad y operaciones en China, factura en yuanes
Sitio internacional oficial platform.kimi.ai Según la página de facturación Entidad extranjera, pago desde el exterior
ZSQH AI Gateway Consola del sitio Yuanes Recarga y factura unificadas para varios modelos

Antes de comprar, confirma la Base URL y el origen de la clave, y luego pide a finanzas que confirme la entidad receptora. Los proyectos de una misma organización suelen compartir el saldo, pero pueden tener presupuestos propios; así evitas «recargué, pero el proyecto no tiene cuota».

2. Recarga oficial: dos caminos, personal y empresa

Los usuarios individuales completan primero la verificación de identidad y luego pagan con WeChat o Alipay mediante código QR. Las empresas completan primero la verificación empresarial, que suele requerir el nombre de la empresa, el código unificado de crédito social y una cuenta bancaria corporativa a nombre de la misma entidad; la plataforma puede depositar un importe aleatorio en la cuenta corporativa para que finanzas lo confirme.

Una empresa tiene dos vías de recarga: el pago en línea por QR se acredita al instante; la transferencia corporativa suele tardar de uno a cinco días hábiles y, una vez confirmada, se acredita en unos diez minutos. Reserva tiempo si la operación cruza de mes.

  1. Inicia sesión en el sitio chino y confirma el nombre de la organización y su estado de verificación.
  2. Las personas completan la verificación personal; las empresas, la verificación empresarial y la validación de la cuenta corporativa.
  3. Abre la página de recarga y confirma la entidad receptora y el sitio actual.
  4. Lee el acuerdo de recarga, elige el importe y el método de pago; para importes grandes, la empresa transfiere desde la cuenta de la entidad verificada.
  5. Guarda el comprobante, sigue la acreditación, revisa el saldo en la página de facturación y configura una alerta de saldo bajo.
  6. Envía una solicitud mínima para confirmar que la clave, la Base URL y el saldo funcionan.

La entidad que paga debe coincidir con la entidad verificada. Los pagos de filiales, empresas vinculadas o personas en nombre de la empresa pueden devolverse e incluso activar controles de riesgo. Si un tercero afirma que el pago no estaba autorizado, la plataforma puede bloquear la cuenta y las claves, y el usuario deberá presentar pruebas de autorización dentro del plazo indicado. No uses cuentas personales de empleados para recargas grandes.

3. Moneda, tipo de cambio y pagos transfronterizos

El sitio chino factura y liquida en yuanes; las entidades nacionales pagan con WeChat, Alipay o transferencia corporativa. El sitio internacional liquida en la moneda que muestra la página de facturación; las entidades emisoras de tarjetas extranjeras pueden cobrar una comisión por conversión de moneda, y el tipo de cambio depende del banco emisor o del canal de pago. Los saldos de ambos sitios no se pueden transferir entre sí, y las facturas tampoco se pueden reembolsar de un lado al otro.

La recarga por gateway suele estar denominada en yuanes, y la página de pago muestra el importe a pagar y el criterio de facturación. Antes de pagar, confirma si el precio incluye impuestos, si hay una comisión de canal adicional y qué entidad emite la factura.

En compras transfronterizas, la entidad del contrato y la entidad que paga también deben coincidir; de lo contrario, aumentan las explicaciones en una auditoría. Si el tipo de cambio es volátil, deja un margen en el presupuesto y no fijes el presupuesto anual con el tipo de cambio del día.

4. Cómo solicitar la factura

La plataforma permite solicitar la factura en la página correspondiente, con dos criterios habituales: por el importe recargado o por el importe realmente consumido. La factura por recarga sirve para reembolsar por adelantado, pero también factura la parte aún no consumida; la factura por consumo refleja mejor el costo real, aunque exige solicitarla periódicamente. Si se puede cambiar de criterio y con qué frecuencia se emite depende de la página.

Las cuentas con verificación personal pueden emitir factura a nombre de una persona o de una empresa; las cuentas con verificación empresarial solo pueden emitirla a nombre de la entidad verificada. La página financiera oficial indica que la entidad emisora es Beijing Moonshot Technology Co., Ltd., el concepto es servicios técnicos y el tipo de IVA es del 6 %. El concepto, el tipo y las notas reales se rigen por la página de facturación.

Antes de emitir, revisa el nombre y el número fiscal, el criterio de facturación, el tipo de factura y las notas. Si el nombre está mal, la anulación y la nueva emisión llevan tiempo, y el reembolso de gastos puede atascarse al cruzar de mes. Las facturas del gateway siguen sus propias reglas; en compras de varios modelos, una sola factura puede cubrirlos, pero conviene confirmar la entidad y el concepto antes de pagar.

5. Saldo, alertas y límites de tasa

La plataforma ofrece una interfaz para consultar el saldo que se puede integrar en el monitoreo. El saldo del sitio chino se expresa en yuanes; available_balance suele incluir efectivo y vales. Si es menor o igual a cero, las solicitudes de inferencia fallan y devuelven exceeded_current_quota_error. La respuesta también incluye data.cash_balance y data.voucher_balance; si la clave no corresponde al sitio, lo habitual es recibir un 401.

curl "https://api.moonshot.cn/v1/users/me/balance" \
  -H "Authorization: Bearer $MOONSHOT_API_KEY"

El monitoreo debe cubrir cuatro capas:

  • Alerta de saldo: la consola permite activar avisos por SMS cuando el saldo baja; ajusta el umbral según la velocidad de consumo.
  • Alerta de aumento diario: se activa cuando el consumo supera de forma clara el promedio de los últimos siete días.
  • Presupuesto del proyecto: fija presupuestos diarios o mensuales por proyecto; al alcanzar el límite se rechazan las solicitudes, aunque la ejecución puede tardar unos diez minutos.
  • Clasificación de fallos: distingue saldo insuficiente, límites de tasa, sobrecarga de capacidad y errores del servidor.

El importe recargado también influye en el nivel de la cuenta. La plataforma clasifica por recarga acumulada, y el nivel determina límites como concurrencia, RPM, TPM, TPD y QPS de búsqueda; los vales normalmente no cuentan para el acumulado. Al comprar, revisa a la vez el saldo y los límites, porque de lo contrario tendrás dinero pero no podrás subir la concurrencia.

6. Reembolsos, vigencia del saldo y disputas

El acuerdo oficial de recarga establece que, por lo general, las recargas no son reembolsables salvo que la plataforma termine el servicio por causas propias; el saldo no consumido no se puede retirar libremente, no tiene fecha de vencimiento y no se puede transferir ni regalar. En caso de incumplimiento, la plataforma puede retener el prepago. Antes de una recarga grande, pide a legal y finanzas que lean el acuerdo; no lo trates como un depósito disponible en cualquier momento.

Los pagos de terceros, los anticipos de empleados y los pagos de empresas vinculadas pueden generar disputas de titularidad. Conserva el contrato, el comprobante de pago, la autorización y la factura para tener material si la cuenta se bloquea o surge una disputa de reembolso. Haz primero una prueba pequeña y confirma que la clave, el saldo, la factura y los límites de tasa cumplen lo esperado antes de pagar por adelantado un importe alto.

7. Recarga por gateway: cuándo conviene

ZSQH AI Gateway es otro sistema de cuentas: la recarga entra en el saldo del gateway, no en el saldo oficial de Moonshot. Su valor está sobre todo en el lado de la compra: pago en yuanes, una cuenta unificada para varios modelos y una sola factura y facturación, sin recargar por separado al cambiar de modelo. El costo es que el catálogo de modelos y el soporte de parámetros se rigen por la documentación del gateway.

Criterios para elegir:

  • Si usas un solo modelo, tienes un proceso financiero sencillo y necesitas la conexión directa oficial, prioriza la recarga oficial.
  • Si usas varios modelos y quieres una factura que cubra a varios proveedores, el gateway simplifica la gestión.
  • Si la ruta crítica va directa, deja las pruebas en el gateway.

Después de registrarte en ZSQH AI Gateway puedes consultar la moneda y las condiciones de facturación en la página de recarga. Los precios y el criterio de facturación se rigen por los precios de modelos.

8. Lista de compras empresariales

Entrega estos puntos a finanzas, legal y los responsables de negocio para que los confirmen:

  1. Que coincidan la entidad usuaria, el sitio, el nombre de la organización y la Base URL.
  2. Que el estado de verificación y la cuenta corporativa cumplan los requisitos de recarga empresarial.
  3. Importe de la recarga, moneda, vía de pago y plazo estimado de acreditación.
  4. Nombre y número fiscal de la factura, concepto, tipo de IVA, criterio y periodicidad.
  5. Nivel de cuenta y límites de concurrencia, RPM, TPM y TPD suficientes para los picos.
  6. Alertas de saldo bajo y presupuestos diarios o mensuales por proyecto ya configurados.
  7. Que contrato, orden de compra, comprobante, factura y estado de cuenta puedan conciliarse entre sí.
  8. Que las condiciones de reembolso y la cláusula de saldo no transferible se hayan comunicado a las personas implicadas.

Preguntas frecuentes

¿Por qué no se acreditó el saldo después de recargar?

El pago por QR suele acreditarse al instante; la transferencia corporativa tarda normalmente de uno a cinco días hábiles, y la plataforma la registra unos diez minutos después de confirmarla. Revisa primero si la entidad que pagó coincide con la entidad verificada y luego consulta el comprobante y el estado de cuenta.

¿Qué hago si recargué al sitio equivocado?

Los saldos y las claves del sitio chino y del internacional no se comunican. Detén la recarga, conserva los comprobantes y sigue las indicaciones del servicio de atención; no lo intentes repetidamente.

¿La factura se emite por recarga o por consumo?

Ambos criterios son posibles y dependen del ritmo de reembolso. La factura por recarga sirve para reembolsar por adelantado, pero también incluye la parte no consumida; la factura por consumo refleja mejor el costo real, aunque debe solicitarse periódicamente.

¿Se puede reembolsar una recarga de Moonshot API?

El acuerdo oficial suele establecer que las recargas no son reembolsables salvo que la plataforma termine el servicio por causas propias; el saldo no consumido no se puede retirar libremente. Antes de una recarga grande, lee el acuerdo y consulta al servicio de atención.

¿Recargar aumenta la concurrencia y los límites de tasa?

El nivel de la cuenta se asigna por recarga acumulada e influye en límites como concurrencia, RPM, TPM y TPD; los vales normalmente no cuentan. La sobrecarga de capacidad es un problema del servidor y no desaparece por recargar; consulta la documentación oficial de límites.

Próximos pasos

Confirma primero el sitio, la entidad y el criterio de facturación, y después decide entre recarga oficial y recarga por gateway. Los equipos que necesitan una cuenta multimodelo en yuanes pueden registrarse en ZSQH AI Gateway; los precios y modelos disponibles se rigen por los precios de modelos.

Lecturas relacionadas: