Moonshot API — интерфейс серии моделей Kimi с акцентом на длинный контекст, понимание китайского языка и экономичность. Его часто используют для чтения длинных документов, баз знаний, поддержки клиентов и генерации контента.

В этой статье разобрано, как получить Moonshot API, как его вызывать и что учесть при подключении.

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

1. Для каких задач подходит Moonshot API

  • Summarization длинных документов, чтение договоров и отчётов.
  • Вопросы и ответы на китайском, поддержка клиентов.
  • Базы знаний и RAG.
  • Создание и переписывание контента.
  • Объяснение кода.

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

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

2. Получение ключа

Официальный Moonshot

Зарегистрируйтесь на открытой платформе Moonshot, создайте ключ и пополните баланс.

Шлюз ZSQH AI Gateway

  1. Зарегистрируйтесь в ZSQH AI Gateway.
  2. Создайте ключ и задайте лимит.
  3. Пополните баланс.
  4. Вызывайте модель через OpenAI SDK.

3. Base URL

Официальный адрес Moonshot обычно выглядит так:

https://api.moonshot.cn/v1

Шлюз:

https://ai.zhongshangqihang.com/v1

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

4. Вызов из Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-ваш-ключ",
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="moonshot-v1-8k",
    messages=[{"role": "user", "content": "Кратко перескажи этот текст в трёх предложениях: ..."}],
)
print(resp.choices[0].message.content)

Название модели уточняйте на странице цен; модели с длинным контекстом обычно стоят дороже.

5. Как работать с длинными текстами

  1. Сначала разбейте текст или сделайте резюме, не заполняйте контекст целиком.
  2. Сохраняйте ссылки на источник, чтобы можно было проверить ответ.
  3. Запросы с длинным контекстом медленнее и дороже — задавайте тайм-аут.
  4. Для структурированного вывода используйте JSON-режим или вызов инструментов, если они поддерживаются.
  5. Важные фрагменты проверяйте повторно.

Для больших баз знаний разумно хранить исходный текст и ссылку на него рядом с ответом. Это упрощает аудит и помогает заметить, когда модель опирается на устаревший фрагмент.

6. Частые ошибки

Ошибка Причина Что делать
401 Ключ и адрес не совпадают Проверить Key и Base URL
404 Неверное имя модели или путь Сверить страницу цен и /v1
429 Ограничение частоты Снизить параллелизм, повторить
Превышен контекст Слишком длинный ввод Разбить на части или сократить
Недостаточно средств Баланс не пополнен Пополнить баланс

7. Контроль затрат

  • Основная статья расходов — длинный контекст; сначала summarization, потом вопрос.
  • Для простых задач используйте модель с коротким контекстом.
  • Пакетные задачи обрабатывайте асинхронно.
  • Следите за повторами и неуспешными запросами.

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

Если документы повторяются, кэшируйте неизменяемую часть запроса и результаты первичной обработки. Это снижает нагрузку и делает стоимость более предсказуемой при росте числа пользователей.

Частые вопросы

Moonshot API и веб-версия Kimi — это одно и то же?

Нет. Веб-версия — готовый продукт, API — интерфейс для вызова из программ, и тарификация у них различается.

Поддерживается ли OpenAI SDK?

Обычно интерфейс совместим с OpenAI Chat Completions; конкретные параметры уточняйте в официальной документации или документации шлюза.

Стабилен ли доступ из Китая?

Moonshot — китайская платформа, поэтому доступ обычно стабильнее, чем к зарубежным моделям; результат зависит от вашей сети.

Что дальше

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

Читайте также: