RU ▾

Настройка API MiniMax: ключ, базовый URL и первый запрос

Пошаговая настройка API, совместимого с OpenAI, на minimaxapikey.com: аккаунт, ключ, базовый URL, первый запрос. Это независимый сервис, а не официальный API какого-либо вендора моделей.

Обновлено

Шесть светящихся шагов от ключа до серверной стойки, символизирующие путь настройки API

Ключевые моменты

  • Зарегистрируйтесь через Google или email, затем получите $0,50 пробного баланса на странице ключа. Карта не нужна.
  • Базовый URL — https://api.minimaxapikey.com/v1, идентификатор модели — uncensored, авторизация — Bearer-ключ.
  • Существует два метода: POST /v1/chat/completions и GET /v1/models.
  • 401 означает неверный ключ, а 429 — достижение лимита, поэтому проверьте код ошибки в теле ответа.

Что вы настраиваете

Пользователи ищут настройку API minimax, ожидая увидеть либо официальную платформу разработчиков MiniMax, либо готовую замену в стиле OpenAI. Эта страница о втором варианте. Сервис за minimaxapikey.com — это размещённый текстовый API, совместимый с OpenAI, работающий на одной модели с открытыми весами, управляемый независимым провайдером. Это не официальный API MiniMax или любого другого вендора моделей, и он не маршрутизирует запросы между вендорами. Если вам нужна платформа самого вендора, используйте их сайт.

Что вы получаете — простоту. Любой SDK или клиент OpenAI работает после того, как вы измените базовый URL и ключ. Есть два метода, POST /v1/chat/completions и GET /v1/models, один идентификатор модели, uncensored и контекстное окно на 100 000 токенов, общее для промпта и завершения. Поддерживается только текст, поэтому генерации изображений, аудио или видео, эмбеддингов и дообучения нет. Поддерживаются потоковая передача, вызов функций и JSON-режим.

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

Шаги 1 и 2: создание аккаунта и получение пробного баланса

  1. Откройте страницу ключа. Перейдите на страницу API-ключа и войдите. Можно использовать Google или email с паролем.
  2. Получите пробный баланс. После входа на странице ключа есть кнопка для получения $0,50 пробного баланса. Это один клик, карта не нужна, баланс действителен 7 дней и предоставляется один раз на человека.

Пробный баланс мал намеренно. При цене $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов, $0,50 покрывают значительное количество тестовых запросов. Промпт на 1 000 токенов с ответом в 500 токенов стоит $0,00015 за входные данные плюс $0,00025 за выходные, что составляет $0,0004. Разделив $0,50 на эту сумму, вы получите 1 250 таких запросов, так что у вас достаточно места для экспериментов.

Обратите внимание на ограничения пробного ключа: 2 параллельных запроса и 60 запросов в минуту. Полный ключ, который вы получаете после пополнения, позволяет 8 параллельных запросов и 300 в минуту. Если ваш тестовый цикл работает параллельно и вы видите ошибки 429, это первое, что нужно проверить.

Шаг 3: создание ключа и его безопасное хранение

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

# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"

# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"

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

Шаг 4: список моделей для подтверждения ключа

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

curl -s https://api.minimaxapikey.com/v1/models \
  -H "Authorization: Bearer $UNCENSORED_KEY"

Вы должны получить JSON-список, содержащий uncensored. При 401 ключ неверен или содержит лишние пробелы/кавычки. Если соединение не устанавливается, проверьте, что URL заканчивается на /v1 и что вы используете https.

Шаг 5: отправка первого запроса чата

Теперь настоящий запрос. Тело запроса имеет стандартную структуру chat completions.

curl -s https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $UNCENSORED_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Explain what an API key is in two sentences."}
    ],
    "temperature": 0.7
  }'

Ответ содержит choices[0].message.content и блок usage с подсчётом токенов промпта и завершения. Посмотрите также на заголовки ответа с помощью curl -i. Вы увидите X-Request-Id, который поддержка может использовать для поиска вашего запроса, X-Balance-USD, ваш оставшийся баланс, и заголовки лимита запросов X-RateLimit-Limit-Requests и X-RateLimit-Limit-Concurrency.

Параметры, такие как temperature, top_p, stop, seed и штрафы, передаются напрямую. max_tokens необязателен. Если вы его не укажете, завершение может использовать всё, что осталось от окна.

Шаг 6: тот же вызов из SDK

Когда curl работает, переходите к языку, который вы будете использовать. Из стандартной настройки OpenAI меняется только два аргумента.

from openai import OpenAI
import os

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

reply = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";

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

const reply = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);

Для потоковой передачи добавьте stream: true и читайте server-sent events. Данные об использовании приходят в конце потока. Страница документации описывает потоковую передачу, вызов функций и JSON-режим с response_format: {"type":"json_object"}.

Перенос существующего проекта OpenAI

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

export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"

Оставшееся изменение — имя модели. Строка, такая как идентификатор модели OpenAI, здесь не существует, поэтому замените её на uncensored, желательно через значение конфигурации, чтобы вы могли вернуться назад. Затем прочитайте код на предмет функций, которые сервис не предлагает. Генерация изображений, аудио, эмбеддинги и дообучение недоступны, так как это API только для чата с текстом. Если ваше приложение вызывает эмбеддинги для поиска, вам понадобится другой провайдер для этой части, а для чата можно оставить этот.

Также полезно знать, какая это модель. Это одна модель с открытыми весами, настроенная на ответы без отказов по контенту для законного использования взрослыми, и одно жёсткое ограничение применяется независимо от настроек: нет сексуального контента с участием несовершеннолетних. Промпты, написанные для другой модели, могут потребовать небольших корректировок, так как каждая модель по-разному реагирует на один и тот же системный промпт. Запустите свои тестовые промпты бок о бок перед переключением реального трафика.

Настройки, которые стоит выбрать с первого дня

Несколько решений проще принять на этапе настройки, чем после запуска. Ни одно из них не сложное, но каждое предотвращает неприятный сюрприз позже.

  • Системный промпт. Поместите свои инструкции о тоне, формате и роли в сообщение system. Держите его коротким и конкретным, потому что каждый запрос повторяет его в виде входных токенов.
  • Лимит токенов. max_tokens необязателен, но лимит — это дешёвая страховка. Без него один ответ может использовать остаток окна в 100 000 токенов.
  • Потоковая передача для интерактивного использования. Установите stream: true, если человек ждёт ответа. Для пакетных задач обычные запросы проще.
  • Правило повтора при 429. Считайте 429 сигналом к ожиданию. При заголовке Retry-After: 5 подождите и повторите запрос.
  • Размер запроса. Лимит тела — 8 МБ. Это больше обычного промпта, но вставленные логи или документы могут достичь этого предела.

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

Пополнение после пробного периода

Пробный период нужен для проверки работоспособности. Когда вы готовы к разработке, добавьте предоплаченный баланс. Подписки нет: вы платите за использованные токены по цене $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов, а баланс не сгорает, поэтому неиспользованный остаток не исчезает в конце месяца.

Подходит любая целая сумма от $20 до $500. Пополнение на $50 добавляет бонус 5%, $100 — 10%, а $200 — 15%. В качестве быстрого примера: пополнение на $100 с бонусом 10% даёт $110 баланса. При промпте в 1 000 токенов и ответе в 500 токенов из шага два каждый запрос стоит $0,0004, поэтому $110 покрывают 275 000 запросов. Реальные промпты обычно длиннее, поэтому масштабируйте эту цифру под своё среднее значение.

Исправление распространённых ошибок настройки

СимптомВероятная причинаИсправление
401 при каждом вызовеОтсутствующий, неправильно введённый или отозванный ключОтправляйте Authorization: Bearer <key> без лишних кавычек
404 или HTML-ответНеверный путь, обычно пропущен /v1Используйте полный базовый URL, заканчивающийся на /v1
Модель не найденаИмя модели, скопированное у другого провайдераИспользуйте uncensored
429 с rate_limitedПревышение лимита запросов в минутуЗамедлите темп или пополните баланс, чтобы перейти с ограничений пробного периода на полные лимиты
429 с concurrencyСлишком много запросов одновременноОграничьте параллельные вызовы до 8 (2 для пробного ключа)
429 с Retry-After: 5Временная перегрузкаПодождите 5 секунд и повторите попытку
413 или тело запроса отклоненоЗапрос превышает 8 МБУменьшите промпт или разбейте задачу

Когда вы будете готовы к чему-то большему, чем пробный период, на странице тарифов указаны варианты пополнения: любая целая сумма от $20 до $500, оплачиваемая криптовалютой (USDT в сети TRC20, USDC в сети Base), с бонусом 5% от $50, 10% от $100 и 15% от $200. Неудачные или отклонённые запросы не оплачиваются, а промпты не используются для обучения.

Вопросы и ответы

Это официальный API MiniMax?

Нет. Это независимый размещённый API, совместимый с OpenAI, который обслуживает одну модель с открытыми весами, настроенную на ответы без отказов по контенту для законного использования взрослыми. Это не официальный API какого-либо вендора моделей и не роутер между вендорами.

Нужна ли кредитная карта для пробного использования?

Нет. После регистрации вы можете получить $0,50 пробного баланса одним нажатием на странице API-ключа. Он действителен в течение 7 дней и доступен один раз на человека.

Какое имя модели использовать в запросах?

Используйте uncensored. Сервис предоставляет этот единственный идентификатор модели, и GET /v1/models отобразит его.

Как пополнить баланс позже?

Пополните любую целую сумму от $20 до $500. Бонусы начисляются от $50 (+5%), $100 (+10%) и $200 (+15%), предоплаченный баланс не сгорает.

Можно ли использовать SDK OpenAI?

Да. Установите base_url в https://api.minimaxapikey.com/v1, используйте свой ключ и укажите модель uncensored. Ничего другого в вашем коде менять не нужно.

До вашего ключа — всего одна форма

Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.

Получить API-ключ