Швидкий старт: Підключіть ваш клієнт

Передумови та встановлення SDK

Встановіть офіційний SDK для вашої мови, щоб автоматично обробляти автентифікацію та серіалізацію запитів. Вам потрібен дійсний API-ключ та базовий URL, налаштовані в середовищі вашого клієнта. Наш сервіс приймає стандартні параметри, такі як temperature та top_p, без необхідності додавати спеціальні заголовки.

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

Налаштування базового URL та ключа

Направте клієнта на наш специфічний базовий URL для маршрутизації запитів через нашу інфраструктуру без цензури. Використовуйте заголовок Authorization: Bearer YOUR_KEY для автентифікації кожного виклику. Ця конфігурація працює ідентично як для локального тестування, так і для скриптів розгортання в продакшні.

Замініть стандартний ендпоінт OpenAI на наш хост, щоб уникнути плутанини з іншими постачальниками. Зберігайте свій ключ у таємниці і не викладайте його в публічних репозиторіях. Конфігурація залишається статичною, доки ви не оновите свій ключ.

Надсилання першого запиту

Виконайте стандартний виклик chat completions для перевірки з’єднання та формату відповіді. Надішліть простий промпт, щоб підтвердити, що модель повертає текст без відмов. Цей тест гарантує, що ваш ключ має достатньо попередньо оплаченого кредиту для використання.

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

Перевірте відповідь на наявність деталей про контент та використання токенів. Якщо ви отримуєте помилку 401, перевірте формат свого ключа. 402 вказує на те, що вам потрібно поповнити баланс кредитів.

Обробка потокових відповідей

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

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)

Обробляйте часткові відповіді коректно у коді клієнта. Буферизуйте вміст до закриття потоку або виникнення помилки. Потокова передача працює з усіма стандартними параметрами, включаючи налаштування температури.

Інтеграція SDK Python

Використовуйте Python бібліотеку для керування запитами з мінімальним кодом шаблонів. Ініціалізуйте клієнт, вказавши базовий URL та ключ для негайного використання. Цей підхід спрощує обробку помилок та парсинг відповідей.

Copyfrom openai import OpenAI

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

Отримайте згенерований контент безпосередньо з об’єкта відповіді. Перевірте наявність помилок та відповідно обробте ліміти швидкості. SDK підтримує як синхронні, так і асинхронні робочі процеси.

Node SDK та обмеження

Інтегруйте з програмами на Node.js, використовуючи офіційний JavaScript SDK. Встановіть базовий URL, щоб запити надходили на нашу кінцеву точку uncensored. Слідкуйте за своїм використанням, щоб залишатися в межах лімітів швидкості.

Copyimport OpenAI from "openai";

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

Ви можете надсилати 300 запитів на хвилину з паралельністю 8. Тіло кожного запиту має бути меншим за 8 МБ. Контекстне вікно підтримує загальний обсяг у 100,000 токенів. Помилки та відмови не споживають кредит, але успішні результати — так. Зберігайте свій ключ у безпеці та оновлюйте його за потреби.

Розуміння використання токенів

Оплата базується на фактичних токенах, використаних у промпті та завершенні. Вхідні токени коштують $0.15 за мільйон, тоді як вихідні токени коштують $0.50 за мільйон. Передоплачений кредит покриває все використання без щомісячних платежів.

Помилки та відмови безкоштовні, тому ви платите лише за успішні відповіді. Останній фрагмент у потоці містить кількість токенів. Слідкуйте за своєю панеллю керування, щоб відстежувати витрати та уникнути вичерпання кредиту. Поповнюйте баланс за допомогою USDT або USDC для миттєвого доступу.