¿Cómo compruebo el saldo de mi API de Kimi (Moonshot AI)?
Última actualización: 26 de septiembre de 2026
Inicia sesión en platform.kimi.ai y abre la página fee-detail de la consola. O llama a GET https://api.moonshot.ai/v1/users/me/balance con tu clave de API. El campo available_balance es lo que aún puedes gastar.
A continuación: qué significan los tres campos del saldo, qué pasa en cero, por qué no hay un punto de acceso de uso y por qué debes elegir la plataforma correcta entre dos. Moonshot ya ha cambiado antes el nombre de su plataforma; esta página refleja sus propios documentos en la fecha indicada arriba.
Moonshot, Kimi y dos plataformas
Moonshot AI gestiona la API de Kimi. Su sitio para desarrolladores se ha mudado: platform.moonshot.ai redirige ahora a platform.kimi.ai, y platform.moonshot.cn redirige a platform.kimi.com. Los hosts de la API conservan los nombres antiguos: api.moonshot.ai y api.moonshot.cn.
Son dos plataformas separadas, no dos puertas a una misma cuenta. Kimi indica a los usuarios de fuera de China continental que usen platform.kimi.ai. Las cuentas, los saldos y las claves de cada lado son independientes. Un saldo que recargas en una plataforma no aparece en la otra.
La Open Platform está también aparte de los demás productos de Kimi. Las páginas de ayuda de Kimi dicen claramente que la Open Platform, Kimi Code y la membresía de Kimi no comparten claves ni saldos. Una membresía no se convierte en saldo de API, y el saldo de API no puede comprar una membresía ni un plan de Kimi Code.
En la consola
Inicia sesión en platform.kimi.ai y abre la página fee-detail (detalles de facturación) de la consola. Según las páginas de ayuda de Kimi, muestra:
- tu saldo actual,
- el uso por día,
- el uso y el coste por modelo,
- el gasto pasado a lo largo del tiempo.
Las cifras de facturación van con retraso, y Kimi no indica un retraso fijo. Así que el gasto de hoy en esta página es una cifra preliminar, no la definitiva.
Con la API
El punto de acceso del saldo es un GET simple con tu clave de API como token bearer:
GET https://api.moonshot.ai/v1/users/me/balance
Authorization: Bearer <your API key>
En la plataforma de China, la ruta es la misma y el host es api.moonshot.cn. La respuesta contiene tres números:
available_balance: lo que aún puedes gastar, efectivo y vales sumados. Es la cifra que decide si tus llamadas pasan.voucher_balance: crédito de vales. No puede bajar de cero.cash_balance: el dinero que ingresaste. Puede bajar de cero; una cifra negativa significa que debes dinero a Moonshot.
La divisa depende de la plataforma. La documentación internacional da los tres campos en dólares estadounidenses; la de China, en yuanes. La respuesta no lleva un campo de divisa, así que tu código tiene que saber de qué plataforma procede la clave.
Los vales de campañas de recarga también llegan a voucher_balance. Las páginas de ayuda de Kimi te remiten a este punto de acceso para comprobar si ha llegado alguno.
Qué pasa en cero
Cuando available_balance es cero o menos, Kimi rechaza las llamadas a sus modelos con el error exceeded_current_quota_error. Entonces tienes que recargar o comprobar si tu vale sigue vigente.
El mismo error aparece también cuando la cuenta está en mora o se ha agotado un vale. Kimi lo enumera entre las causas de una respuesta 429, junto a los límites de tasa y la sobrecarga. Recargar resuelve este caso. Para la sobrecarga, dice Kimi, añadir dinero no ayuda.
Kimi ofrece dos frenos antes de llegar a cero:
- Alertas de saldo. Kimi aconseja activarlas; la plataforma te avisa entonces cuando el saldo cae por debajo de una cantidad que fijas.
- Un presupuesto diario por proyecto, fijado en los ajustes del proyecto de la consola. Cuando un proyecto lo alcanza, Kimi rechaza todas las llamadas a la API de ese proyecto. Como la facturación va con retraso, el tope puede tardar un tiempo en surtir efecto.
Sin punto de acceso de uso
La API informa del saldo y nada más. El uso diario, el coste por modelo y el gasto pasado solo están en la página fee-detail de la consola.
Si quieres un registro propio, una forma es leer el saldo a horas fijas y anotar cuánto baja. Funciona mientras no recargues entre medias, y no distingue modelos ni proyectos. Cómo gestionan los costes las demás API de IA, y dónde se sitúa Kimi entre ellas, se explica en Los costes de las API de IA de un vistazo.
Cuando la clave devuelve 401
Lo más probable es que la clave pertenezca a la otra plataforma. Las claves de platform.kimi.ai solo funcionan con api.moonshot.ai, y las de platform.kimi.com solo con api.moonshot.cn. Enviada al host equivocado, una clave válida devuelve 401.
La propia lista de comprobación de Kimi añade dos causas más: una clave de Kimi Code en lugar de la Open Platform, y ajustes antiguos en herramientas locales que aún apuntan a otra clave u otro host. Revisa eso antes de crear una clave nueva.
En AI Cockpit
La tarjeta de Kimi K3 está en la barra de menús del Mac, en la app del iPhone y del iPad, y en el área de notificación de Windows. En el Apple Watch (a través de la app del iPhone), Kimi aparece como una fila con el saldo disponible. Introduces tu clave de API en Ajustes y eliges la plataforma, internacional o China; la tarjeta llama entonces al punto de acceso del saldo descrito arriba.
- El saldo disponible, con las partes de vales y de efectivo debajo.
- Una insignia «activa» o «vacía», y un aviso en la cabecera de la tarjeta cuando el saldo disponible es cero o menos.
- Una nota en la tarjeta de que Kimi no da el uso por la API.
- Solo en el Mac: si introduces además un token de acceso del plan Kimi Code, la tarjeta muestra la cuota de sesión de ese plan, con la parte usada y su hora de restablecimiento. Por defecto pasa a color de aviso al 75 % y al 90 %. También puedes ponerla en la barra de menús.
Lo que no hace: recargar, mostrar el gasto diario o mensual, ni fijar alertas y presupuestos del lado de Kimi. La tarjeta rotula siempre los importes en dólares estadounidenses. En la plataforma de China Moonshot cuenta en yuanes, así que allí lee la cifra como yuanes.
Cómo lee AI Cockpit los costes de las demás API se explica en Los costes de las API de IA de un vistazo. Respuestas breves a otras preguntas en la página de FAQ.