MiniMax api: Короткий посібник та посібник SDK

Аутентифікація та базовий URL

Використовуйте наданий API-ключ та вкажіть вашому клієнту на виділений базовий URL. Кінцева точка для генерації відповідей — https://api.minimaxaiapi.com/v1/chat/completions. Ви передаєте ключ у Authorization header як Bearer-токен. Це працює з будь-яким стандартним SDK OpenAI, оскільки ми дотримуємося того ж протоколу.

• Ім’я заголовка: Authorization
• Значення заголовка: Bearer YOUR_API_KEY
• Базовий URL: https://api.minimaxaiapi.com/v1

Не потрібне складне налаштування. Просто оновіть конфігурацію у своєму існуючому проекті.

Copycurl https://api.minimaxaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with keys name and age"}]
  }'

Ендпоінт Chat Completions

Відправте POST-запит до кінцевої точки chat completions, щоб отримати текстову відповідь. Ідентифікатор моделі uncensored. Ви повинні включити масив messages з історією вашої розмови. Система обробляє вхідні дані та повертає згенерований текст на основі вашого запиту.

Цей ендпоінт обробляє всю генерацію тексту. Він не підтримує вбудовування, аудіо або відео. Ви можете потоково передавати відповіді або чекати на повний блок. Модель обробляє контекст загальною довжиною до 100,000 токенів.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.minimaxaiapi.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)

Потокова передача та використання токенів

Увімкніть потокову передачу, встановивши stream: true у вашому запиті. API повертає Server-Sent Events (SSE) для кожного згенерованого токена. Це дозволяє відображати вивід в реальному часі. Статистика використання токенів включається у фінальний чанк потоку. Це допомагає точно відстежувати витрати, не парсячи кожен індивідуальний токен.

Потокова передача зменшує сприйнятну затримку для довгих відповідей. Вона ідеально підходить для чат-інтерфейсів та генерації динамічного контенту. Ви можете зупинити потік достроково, якщо користувач перерве генерацію.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.minimaxaiapi.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);

Function Calling та режим JSON

Використовуйте tools параметр для увімкнення виклику функцій. Визначте свої функції в тілі запиту і дозвольте моделі вибрати, яку викликати. Цей tool_choice параметр дозволяє примусово викликати конкретну функцію або автоматично вибирати. Для суворих виводів JSON встановіть response_format до {"type": "json_object"}. Це забезпечує, що відповідь є дійсним JSON.

Виклик функцій корисний для витягування структурованих даних або запуску дій. Режим JSON ідеально підходить для інтеграцій API, які вимагають передбачуваних форматів. Поєднуйте обидва для надійної логіки додатків.

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)

Параметри моделі та обмеження

Налаштуйте поведінку генерації за допомогою стандартних параметрів, таких як temperature, top_p, а також stop. Максимальне вікно контексту становить 100,000 токенів, включаючи промпт і завершення. Максимальний обсяг виводу на запит становить 16,000 токенів. Якщо ви не встановите max_tokens, ліміт за замовчуванням становить 2048 токенів.

Використовувати seed для відтворюваних результатів. Встановіть presence_penalty та frequency_penalty для контролю повторень. Ці параметри дають вам детальний контроль над креативністю та послідовністю моделі. Завжди тестуйте з вашим конкретним випадком використання, щоб знайти правильний баланс.

Ліміти частоти та помилки

API обмежує 300 запитів на хвилину та 8 одночасних запитів на ключ. Якщо ви перевищите ці ліміти, отримаєте помилку 429. Помилка 401 вказує на недійсний або відсутній API-ключ. Помилка 402 означає, що ваш попередньо оплачений кредит вичерпано.

Помилки не списуються з вашого кредиту. Ви можете повторити невдалі запити без штрафу. Розмір тіла запиту обмежено 8 МБ. Обережно керуйте паралелізмом, щоб уникнути обмеження пропускної здатності. Слідкуйте за використанням через останній фрагмент потокових відповідей.