API MiniMax: первый запрос за пять минут

Установка SDK OpenAI

Начните с установки официального SDK OpenAI для выбранного языка. Библиотека автоматически форматирует запросы и обрабатывает потоковую передачу. Убедитесь, что у вас установлены Python 3.8+ или Node.js 18+. Выполните pip install openai для Python или npm install openai для Node. SDK упрощает взаимодействие с эндпоинтом /v1/chat/completions. Он управляет заголовками, повторными попытками и разбором SSE, чтобы вы могли сосредоточиться на промпте. Это работает, потому что наш API соответствует стандарту завершения чата OpenAI. Вам не нужна пользовательская библиотека клиентов. Стандартные методы SDK напрямую сопоставляются с нашими эндпоинтами. Это сокращает время интеграции и использует существующие знания разработчиков.

Настройка базового URL и ключа

Установите API-ключ и базовый URL в переменных среды. Наш базовый URL — https://api.minimaxapikey.com/v1. Это позволяет использовать стандартные клиенты OpenAI без изменений. Создайте аккаунт, чтобы сгенерировать ключ. Ключ отображается сразу после регистрации. Карта не требуется для пробного периода. Храните ключ в безопасности. Передавайте его в виде заголовка или переменной среды. SDK по умолчанию использует OPENAI_API_KEY. Вы можете переопределить базовый URL, чтобы указать на наши серверы. Это гарантирует, что все запросы отправляются в модель без цензуры. Проверьте работоспособность ключа с помощью простого пинга. Этот шаг предотвратит ошибки аутентификации в будущем.

Отправка базового запроса на завершение чата

Отправьте первый запрос для генерации текста. Используйте метод POST на эндпоинте /v1/chat/completions. Укажите модель как uncensored. Передайте массив сообщений с промптом пользователя. API возвращает токен завершения. Это основная функция генерации текста. Она поддерживает контекстное окно на 100 000 токенов. Вы можете отправлять длинные промпты или историю разговора. Ответ включает сгенерированный текст и использование токенов. Это идеально подходит для творческого письма или неограниченного диалога. Убедитесь, что контент законен. Модель не отказывается от взрослых тем. Она блокирует только сексуальный контент с участием несовершеннолетних. Начните с простого, чтобы проверить подключение.

Включение потоковой передачи (SSE)

Для вывода в реальном времени включите потоковую передачу. Установите параметр stream в значение true. API возвращает события, отправляемые сервером (SSE). Каждый фрагмент содержит часть ответа. Это снижает воспринимаемую задержку. Пользователи видят текст по мере его генерации. SDK автоматически обрабатывает разбор фрагментов. Вы можете отображать текст инкрементально в интерфейсе. Это критически важно для интерфейсов чата. Потоковая передача работает со всеми ответами модели. Она не влияет на подсчет токенов. Каждый фрагмент включает данные об использовании в конце. Используйте это для улучшения пользовательского опыта. Это ощущается более отзывчивым, чем ожидание полного ответа. Настройте клиент для правильной буферизации фрагментов.

Использование вызова инструментов/функций

Поддержка структурированных выходов с помощью вызова функций. Определите инструменты в теле запроса. Модель может вызывать функции на основе промпта. Это позволяет интегрировать внешние системы. Передайте определения инструментов и сообщения пользователя. Ответ включает объект вызова инструмента. Выполните функцию и верните результаты. Это работает со стандартными SDK OpenAI. Это позволяет создавать сложные рабочие процессы. Вы можете создавать агентов или помощников. Модель сохраняет контекст между вызовами. Это мощно для автоматизации. Убедитесь, что определения ваших инструментов точны. API обрабатывает маршрутизацию выходов инструментов. Он сохраняет связность разговора. Используйте это для генерации динамического контента.

Проверка доступных моделей

Проверьте список моделей через GET /v1/models. Этот эндпоинт возвращает доступные модели. Наш API обслуживает одну модель: uncensored. Это модель с открытыми весами. Это не GPT, Claude или Gemini. Ответ подтверждает идентификатор модели. Используйте это для отладки конфигураций клиентов. Убедитесь, что ваш код нацелен на правильную модель. Эндпоинт быстрый и надежный. Он возвращает данные JSON. Вы можете распарсить это для отображения в интерфейсе. Это подтверждает, что ваш API-ключ действителен. Используйте это для автоматических проверок работоспособности. Это часть стандартной спецификации OpenAI. Дополнительная конфигурация не требуется. Это обеспечивает совместимость с существующими инструментами.

cURL

Copycurl https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.minimaxapikey.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Потоковая передача

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)