Moonshot API работает по предоплатной модели: вызовы доступны только при положительном балансе. Ошибки при пополнении обычно связаны с тремя решениями: на какой сайт зачисляются деньги, какое юридическое лицо платит и как выставляется счёт. Статья разбирает официальное пополнение и пополнение через шлюз по закупочному процессу, включая валюту, счета, оповещения о балансе, возвраты и отчётность. Конкретные цены — на странице цены на модели.

Примечание: Moonshot и Kimi — товарные знаки их правообладателей. Статья носит технический и закупочный характер и не подразумевает аффилированности или агентских отношений с правообладателями. Правила пополнения, политика счетов и условия возврата могут меняться; перед операцией сверяйтесь с официальным соглашением и подсказками на странице.

1. Сначала определите, на какой аккаунт зачисляются деньги

По состоянию на октябрь 2026 года старый домен документации открытой платформы Moonshot platform.moonshot.cn перенаправляет на platform.kimi.com, международный сайт — на platform.kimi.ai. Сайты независимы: ключ китайского сайта при вызове на международном вернёт 401, балансы не переносятся. При пополнении не на тот сайт деньги не заработают.

Тип аккаунта Вход Валюта расчётов Подходящий сценарий
Официальный китайский сайт platform.kimi.com Юань Китайское юрлицо, внутренние задачи, счёт в юанях
Официальный международный сайт platform.kimi.ai По странице счетов Зарубежное юрлицо, оплата из-за рубежа
ZSQH AI Gateway Консоль шлюза Юань Единое пополнение и счёт для нескольких моделей

До закупки подтвердите Base URL и источник ключа, затем согласуйте с финансовой службой получателя платежа. Проекты одной организации обычно делят баланс, но могут иметь собственные бюджеты — иначе возможна ситуация «деньги внесены, а у проекта нет квоты».

2. Официальное пополнение: два пути

Частный пользователь сначала проходит верификацию личности, затем платит через WeChat или Alipay по QR-коду. Корпоративный пользователь проходит верификацию компании, обычно указывая название, единый код социального кредита и банковский счёт, совпадающий с юрлицом; платформа может перевести на корпоративный счёт случайную сумму для подтверждения.

У корпоративного пополнения два пути: онлайн-платёж зачисляется сразу; перевод на корпоративный счёт обычно занимает от одного до пяти рабочих дней, после подтверждения зачисление происходит примерно за десять минут. Учитывайте переход через конец месяца.

  1. Войдите на китайский сайт и проверьте название организации и статус верификации.
  2. Физическое лицо проходит верификацию личности; компания — верификацию юрлица и проверку корпоративного счёта.
  3. Откройте страницу пополнения и проверьте получателя платежа и текущий сайт.
  4. Прочитайте соглашение о пополнении, выберите сумму и способ оплаты; крупные корпоративные суммы переводятся со счёта верифицированного юрлица.
  5. Сохраните платёжное поручение, отследите зачисление, сверьте баланс на странице счетов и настройте напоминание о низком балансе.
  6. Отправьте минимальный запрос и убедитесь, что ключ, Base URL и баланс работают.

Плательщик должен совпадать с верифицированным юрлицом. Оплата от дочерней или связанной компании либо от частного лица может быть возвращена и даже вызвать проверку рисков. Если третья сторона заявит, что платёж не был подтверждён владельцем, платформа может заблокировать аккаунт и ключи до предоставления подтверждения в установленный срок. Не пополняйте крупные суммы с личных счетов сотрудников.

3. Валюта, курс и трансграничные платежи

Китайский сайт рассчитывается в юанях; внутренние юрлица платят через WeChat, Alipay или банковский перевод. Международный сайт рассчитывается в валюте страницы счетов; зарубежные карточные системы могут взимать комиссию за конвертацию, курс определяется банком-эмитентом или платёжным каналом. Балансы двух сайтов не переводятся, счета не взаимозачитываются.

Пополнение через шлюз обычно номинировано в юанях; на странице оплаты отображаются сумма к оплате и правила выставления счёта. До оплаты уточните, включён ли налог, есть ли комиссия канала и какое юрлицо выставляет счёт.

При трансграничной закупке сторона договора и плательщик должны совпадать, иначе возрастут затраты на объяснения при аудите. При высокой волатильности курса закладывайте буфер и не фиксируйте годовой бюджет по курсу дня.

4. Как выставляются счета

Официально счёт запрашивается на странице счетов; распространены два подхода: на сумму пополнения или на фактически израсходованную сумму. Счёт на пополнение удобен для раннего возмещения, но неиспользованная часть тоже оказывается оплаченной; счёт на расход ближе к фактическим затратам, но требует регулярных заявок. Возможность переключения и периодичность определяются страницей.

Аккаунт с верификацией личности может выставить счёт на частное лицо или компанию; корпоративный аккаунт — только на верифицированное юрлицо. Финансовая страница указывает, что эмитент — Beijing Moon's Dark Side Technology Co., Ltd., предмет — услуги технического обслуживания, ставка 6%. Фактические предмет, ставка и примечания определяются страницей выставления.

До выставления сверьте название и налоговый номер, подход к расчёту, тип счёта и примечания. Ошибка в реквизитах требует сторнирования и перевыставления, что занимает время и затрудняет отчётность через границу месяца. Счёт шлюза выставляется по правилам шлюза: при закупке нескольких моделей один счёт может покрывать несколько моделей, но юрлицо и предмет нужно подтвердить до оплаты.

5. Баланс, оповещения и лимиты

Официальный API позволяет запрашивать баланс и подключать его к мониторингу. Баланс китайского сайта номинирован в юанях; available_balance обычно включает денежные средства и ваучеры; при нуле или ниже запросы инференса завершаются ошибкой exceeded_current_quota_error. В ответе также есть data.cash_balance и data.voucher_balance; несовпадение ключа и сайта обычно даёт 401.

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

Мониторинг стоит строить на четырёх уровнях:

  • напоминание о балансе: в консоли можно включить SMS-оповещение о низком балансе, порог зависит от скорости расхода;
  • оповещение о резком росте дневного расхода: срабатывает при заметном превышении среднего за последние семь дней;
  • бюджет проекта: дневной или месячный лимит, после которого запросы отклоняются; применение может задерживаться примерно на десять минут;
  • классификация неудачных запросов: отдельно недостаток баланса, лимиты, перегрузка ёмкости и серверные ошибки.

Сумма пополнения влияет на уровень аккаунта. Официально уровень определяется накопленным пополнением и задаёт параллелизм, RPM, TPM, TPD и QPS поиска; ваучеры обычно не учитываются. При закупке смотрите одновременно на баланс и лимиты, иначе денег хватит, а параллелизм не вырастет.

6. Возврат, срок действия баланса и споры

Официальное соглашение о пополнении устанавливает: пополнение обычно не возвращается, кроме случаев прекращения сервиса по вине платформы; неиспользованный баланс нельзя свободно вывести, срок действия баланса не ограничен, но его нельзя передавать или дарить. При нарушениях платформа может удержать предоплату. Перед крупным пополнением юристы и финансисты должны прочитать соглашение и не рассматривать баланс как вклад до востребования.

Оплата третьей стороной, аванс сотрудника или перевод связанной компании могут создать спор о принадлежности средств. Сохраняйте договор, платёжное поручение, подтверждение полномочий и счета — они понадобятся при блокировке или споре о возврате. Сначала проведите небольшой тест, убедитесь, что ключ, баланс, счета и лимиты соответствуют ожиданиям, и лишь затем вносите крупную предоплату.

7. Пополнение через шлюз: когда удобнее

ZSQH AI Gateway — отдельная система аккаунтов: пополнение зачисляется на баланс шлюза, а не на официальный баланс Moonshot. Ценность в закупочной части: оплата в юанях, единый аккаунт для нескольких моделей, общие счета и документы, не нужно пополнять каждую модель отдельно. Ограничение — охват моделей и поддержка параметров определяются документацией шлюза.

Границы выбора:

  • одна модель, простой финансовый процесс, нужны официальные возможности напрямую — выбирайте официальное пополнение;
  • несколько моделей и один счёт на нескольких поставщиков — шлюз удобнее;
  • основной бизнес — напрямую, тесты — через шлюз.

После регистрации в ZSQH AI Gateway можно посмотреть валюту и правила счетов на странице пополнения. Цены и правила биллинга — на странице цены на модели.

8. Чек-лист корпоративной закупки

Следующие пункты согласуйте с финансами, юристами и бизнес-владельцем:

  1. Совпадают ли юрлицо, сайт, название организации и Base URL.
  2. Соответствуют ли статус верификации и корпоративный счёт требованиям пополнения.
  3. Сумма, валюта, платёжный путь и ожидаемое время зачисления.
  4. Название и налоговый номер получателя счёта, предмет, ставка, правила и периодичность.
  5. Достаточны ли уровень аккаунта, параллелизм, RPM, TPM и TPD для пиковой нагрузки.
  6. Настроены ли напоминания о низком балансе и дневные/месячные бюджеты проектов.
  7. Сходятся ли договор, заказ, платёжное поручение, счёт и выписка.
  8. Сообщены ли ответственным условия возврата и запрет на передачу баланса.

Часто задаваемые вопросы

Почему после пополнения баланс не поступил?

Онлайн-платёж обычно зачисляется сразу; перевод на корпоративный счёт занимает от одного до пяти рабочих дней, после подтверждения — около десяти минут. Сначала проверьте совпадение плательщика и верифицированного юрлица, затем поручение и выписку.

Что делать, если пополнили не тот сайт?

Балансы и ключи китайского и международного сайтов несовместимы. Остановите пополнение, сохраните документы и следуйте указаниям поддержки; не повторяйте попытки.

Счёт на пополнение или на расход?

Возможны оба варианта, выбор зависит от ритма отчётности. Счёт на пополнение удобен для раннего возмещения, но неиспользованная часть уже оплачена; счёт на расход ближе к фактическим затратам, но требует регулярных заявок.

Можно ли вернуть пополнение Moonshot API?

Официальное соглашение обычно не предусматривает возврат, кроме прекращения сервиса по вине платформы; неиспользованный баланс нельзя свободно вывести. Перед крупной суммой прочитайте соглашение и уточните у поддержки.

Повышает ли пополнение параллелизм и лимиты?

Уровень аккаунта определяется накопленной суммой пополнения и влияет на параллелизм, RPM, TPM, TPD и другие лимиты; ваучеры обычно не учитываются. Перегрузка ёмкости — серверная проблема, пополнение её не устраняет; ориентируйтесь на официальную документацию по лимитам.

Что дальше

Сначала определите сайт, юрлицо и правила счетов, затем выбирайте официальное пополнение или шлюз. Командам, которым нужен многомодельный аккаунт в юанях, можно зарегистрироваться в ZSQH AI Gateway; цены и доступные модели — на странице цены на модели.

Похожие материалы: