Руководство по API Moonshot Kimi

Опубликованные модели Moonshot Kimi

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

Разработчик

Moonshot AI

Доступ для новых клиентов

Доступен

Первый запрос

Отправляйте HTTPS-запросы на указанный ниже базовый URL. Для текстового чата, совместимого с OpenAI, используйте POST /chat/completions, а для Claude Messages — POST /messages. Выберите протокол в рабочей области моделей и используйте соответствующие ему точный URL и формат JSON.

Базовый URL API: https://fusionpointai.com/api/v1

Создайте клиентский API-ключ или управляйте им в настройках API-ключей своей учётной записи. Передавайте ключ как bearer-токен и храните его на доверенном сервере. Не вставляйте его в код браузера, систему контроля версий или общедоступные журналы.

Ключу необходима область действия ai:inference и доступ к соответствующей клиентской подписке. Публичный API-ключ не является паролем от учётной записи, и им нельзя делиться.

В этих примерах используются зарегистрированная JSON-конечная точка chat-completion и совместимые с OpenAI клиенты для Python и Node.js. Сохраните ключ в переменной окружения FUSIONPOINTAI_API_KEY. В поле модели указывайте только точный идентификатор из списка выше.

# Install the client for your application language.
# Python:
python -m pip install openai
# Node.js:
npm install openai

# Bash: enter the key without storing it in shell history.
read -rs -p 'FusionPointAI API key: ' FUSIONPOINTAI_API_KEY
export FUSIONPOINTAI_API_KEY
printf '\n'
# After finishing:
# unset FUSIONPOINTAI_API_KEY

curl 'https://fusionpointai.com/api/v1/chat/completions' \
  -H "Authorization: Bearer $FUSIONPOINTAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "kimi-k3.1-pro",
    "messages": [
        {
            "role": "user",
            "content": "Summarize this in one sentence."
        }
    ],
    "temperature": 0.7,
    "max_tokens": 300
}'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FUSIONPOINTAI_API_KEY"],
    base_url="https://fusionpointai.com/api/v1",
)

response = client.chat.completions.create(
    model="kimi-k3.1-pro",
    messages=[{"role": "user", "content": "Summarize this in one sentence."}],
    temperature=0.7,
    max_tokens=300,
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.FUSIONPOINTAI_API_KEY,
  baseURL: "https://fusionpointai.com/api/v1",
});

const response = await client.chat.completions.create({
  model: "kimi-k3.1-pro",
  messages: [{ role: "user", content: "Summarize this in one sentence." }],
  temperature: 0.7,
  max_tokens: 300,
});
console.log(response.choices[0].message.content);

OpenAI · Формат запросов и ответов

Конечная точка принимает данные в формате JSON. Сообщения передаются по порядку; у каждого сообщения должна быть поддерживаемая роль и строковое содержимое. Необязательные параметры генерации должны укладываться в ограничения проверки ниже. Успешный ответ — это JSON-объект chat.completion с массивом choices и, если провайдер возвращает такие данные, сведениями об использовании токенов.

Структура ответа

Успешный ответ содержит поля id, object (chat.completion), created, model и choices. Каждый элемент choices содержит индекс, сообщение assistant и finish_reason. В поле usage могут быть указаны количества токенов. Даже если запрос прошёл проверку шлюза, на него могут распространяться ограничения конкретного провайдера.

{
    "id": "chatcmpl_example",
    "object": "chat.completion",
    "created": 1700000000,
    "model": "kimi-k3.1-pro",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "A concise summary of the supplied text."
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 12,
        "completion_tokens": 10,
        "total_tokens": 22
    }
}

Доступ, ограничения и безопасная эксплуатация

В рамках действующих клиентских подписок количество запросов и токенов не учитывается по квоте; для sandbox-ключей действует опубликованный месячный лимит. Условия подписки не отменяют технических ограничений модели и вышестоящей системы.

• Окно контекста модели, максимальный объём ответа, поддерживаемые возможности запроса и временные ограничения трафика на стороне провайдера различаются. Перед отправкой производственного трафика ознакомьтесь со сведениями о провайдере и модели.
• На конечной точке действует ограничение приложения: 60 запросов в минуту для соответствующей учётной записи ограничения частоты. HTTP 429 также может указывать на временное ограничение трафика вышестоящей системы. Повторяйте запросы с увеличивающимися интервалами, а не в плотном цикле.
• Используйте HTTPS, храните ключи на сервере, предоставляйте только необходимую область действия для инференса и незамедлительно отзывайте ключ при подозрении на утечку.
• Chat Completions поддерживает синхронный обмен текстом. Claude Messages отдельно поддерживает исходные блоки содержимого, инструменты и SSE, если это разрешено выбранной моделью. Другие конечные точки провайдеров в эти контракты не входят.

Доступ к провайдеру и требования к учётной записи

Для аутентификации используйте клиентский API-ключ с областью действия ai:inference, связанный с учётной записью, которой доступен этот сервис. В каталоге указано, разрешено ли сейчас подключение новых клиентов. Он не предоставляет доступ, не оформляет подписку и не отменяет разрешения учётной записи или ключа.

Ошибки и устранение неполадок

Ошибки проверки и непригодные ответы провайдера возвращаются конечной точкой в виде JSON-объекта ошибки с полями message, type и code. При ошибке проверки также могут содержаться сведения о поле. Не указывайте API-ключи и конфиденциальный текст запросов в обращениях в поддержку.

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

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