Многие разработчики ищут «Moonshot API Key», открывают platform.moonshot.cn и видят перенаправление на другой домен, решая, что ошиблись сайтом. На самом деле бренд платформы изменился: Moonshot — бренд компании и открытой платформы, Kimi — бренд моделей, а домен API-запросов по-прежнему содержит moonshot. Статья объясняет фактические входы 2026 года, уровни аккаунта, права ключа, хранение, ротацию и разбор 401.

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

1. Откуда теперь входить на открытую платформу Moonshot

platform.moonshot.cn сейчас перенаправляет на platform.kimi.com, международный platform.moonshot.ai — на platform.kimi.ai. Консоль, аккаунт, баланс и ключи управляются в открытой платформе Kimi API.

Но домены API-запросов не изменились: китайский сайт — api.moonshot.cn, международный — api.moonshot.ai. Некоторые старые руководства заменили только скриншоты консоли и не объяснили это, из-за чего кажется, что платформа исчезла.

Запомните три уровня: Moonshot — бренд платформы, Kimi — бренд моделей, api.moonshot.* — домен интерфейса. Это не три разных аккаунта. Аккаунты, балансы и ключи китайского и международного сайтов изолированы, ключ должен соответствовать сайту.

2. Сначала выберите субъект: без верификации, личный или корпоративный

Статус верификации Максимум проектов Максимум API Key Подходящий сценарий
Без верификации 1 10 Краткосрочное тестирование
Личная верификация 20 50 Личная разработка, малая команда
Корпоративная верификация 50 100 Много проектов и участников

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

На уровне организации есть и IP-белый список, доступный личным и корпоративным верифицированным организациям. Он действует на организацию и ограничивает все её ключи: до 20 публичных IPv4-адресов или CIDR, IPv6 и частные адреса не принимаются. Каждое сохранение перезаписывает весь список, поэтому при нефиксированном выходном IP включать его рискованно.

3. Правильный порядок создания ключа

  1. Войдите на platform.kimi.com и откройте консоль.
  2. Сначала создайте проект и назовите его по бизнес-линии или среде, например crm-prod, crm-test.
  3. Откройте страницу API Keys, создайте ключ; в имени укажите проект, среду и назначение.
  4. Скопируйте ключ; если страница показывает его один раз, сразу сохраните в менеджере секретов.
  5. Проверьте ключ и сайт через GET /v1/models или минимальный запрос.
  6. Запишите ответственного, проект, дату создания и планируемую дату ротации.

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

Каждый участник должен создавать собственный ключ. После исключения участника из проекта созданные им ключи перестают работать — это упрощает разбор инцидентов по сравнению с общим ключом.

4. Где границы прав ключа

API Key — не пароль аккаунта и не обладает «универсальными правами». Он может вызывать интерфейсы и модели, назначенные проекту, но ограничен бюджетом проекта, лимитами организации и IP-белым списком. Если консоль не даёт детализировать ключ по моделям и интерфейсам, не предполагайте, что такая возможность есть; для изоляции используйте разные проекты, разные ключи и квоты на уровне приложения.

Различайте продукты: ключ Kimi Code и ключ открытой платформы несовместимы. Ключ продукта Code при вызове интерфейса открытой платформы обычно даёт 401 или 404. Роли участников, пополнение и права на счета также разделены; выдавайте минимальные права и не считайте, что «может создать ключ» означает «может управлять счетами».

5. Переменные окружения и хранение в коде

# .env хранится только локально, не коммитится в репозиторий
MOONSHOT_API_KEY=ваш ключ

# .gitignore как минимум содержит
.env
.env.*

В продакшене используйте Secret Manager платформы или внедрение переменных окружения. Во фронтенде, мобильных приложениях и браузерных расширениях ключа быть не должно, все запросы идут через сервер. В журналах, отчётах об исключениях и APM фильтруйте заголовок Authorization, оставляя только имя или префикс ключа. В CI/CD используйте отдельные Secret и не выводите их в журнал сборки. Если разработчики пользуются общей машиной, личный ключ каждому упрощает диагностику.

6. Как разбирать 401, 403 и 429

При 401 сначала проверьте три вещи: к какому сайту относится ключ, совпадает ли Base URL, не удалён и не ротирован ли ключ. Затем — полноту копирования, формат заголовка Authorization: Bearer и фактическую загрузку переменной окружения. Повторный тест новым ключом быстро отделяет проблему ключа от проблемы конфигурации.

403 обычно означает, что текущий выходной IP не входит в белый список или у проекта недостаточно прав. Выходной IP NAT, прокси и облачных функций может отличаться от ожидаемого.

При 429 различайте тип ошибки: engine_overloaded_error — перегрузка сервера, нужно подождать Retry-After и снизить параллелизм; rate_limit_reached_error — превышение RPM, TPM, TPD или параллелизма организации; exceeded_current_quota_error — чаще недостаток баланса или задолженность. OpenAI SDK по умолчанию повторяет дважды, поэтому одна ошибка может превратиться в три запроса; аккаунтам с низкой квотой стоит это учитывать.

7. Ротация, отзыв и обработка утечки

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

8. Официальный ключ или ключ шлюза

Аккаунт официального ключа находится в открытой платформе Kimi API; расчёты, счета и охват моделей определяются правилами платформы. Подходит командам, которые используют только Kimi и нуждаются в прямом официальном интерфейсе.

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

Пути не конфликтуют: можно сначала тестировать через шлюз, а затем решить, какой путь использовать в продакшене. Не смешивайте ключи — у них разные Base URL, системы аутентификации и балансовые аккаунты.

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

Moonshot API Key и Kimi API Key — одно и то же?

Это учётные данные одной открытой платформы, различаются только названия. Сейчас платформа называется открытой платформой Kimi API, а домен интерфейса остаётся moonshot.

Почему platform.moonshot.cn перенаправляет?

После изменения бренда китайский сайт перенаправляет на platform.kimi.com, международный — на platform.kimi.ai. Домены API api.moonshot.cn и api.moonshot.ai не затронуты.

Можно ли после создания увидеть полное значение ключа?

Большинство платформ показывает его только при создании, затем доступны имя или префикс. Если не сохранили — создайте новый, не пытайтесь восстановить старое значение.

Можно ли использовать один ключ в нескольких проектах?

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

Что делать, если после включения IP-белого списка вызовы падают?

Сначала проверьте, входит ли текущий выходной IP в список, затем — фактический выход NAT, прокси или облачной функции. Изменение белого списка перезаписывает весь список, поэтому перед сохранением внесите все адреса.

Что дальше

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

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