Швидкий старт API

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

API використовує стандартну сумісну з OpenAI автентифікацію. Ви отримуєте API-ключ одразу після реєстрації через Google або електронну пошту. Використовуйте цей ключ у Authorization header для всіх запитів. Базовий URL фіксований на https://api.mistralabliterated.com/v1. Додаткова конфігурація для шляху кінцевої точки не потрібна.

Copycurl https://api.mistralabliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the first five prime numbers"}]
  }'

Ваш ключ ідентифікує ваш обліковий запис і відстежує використання. Якщо ви втратите ключ, згенеруйте новий; старий стане недійсним.

POST /v1/chat/completions

Надсилайте повідомлення до моделі через стандартний ендпоінт завершення чату. Ідентифікатор моделі завжди uncensored. Цей ендпоінт обробляє взаємодії «текст на вході, текст на виході» без необхідності складних структур запитів. Ви можете надіслати повідомлення system, user та assistant в одному запиті.

Copyfrom openai import OpenAI

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

Запит повертає структуровану відповідь JSON, що містить вивід моделі. Ви можете налаштувати параметри, такі як temperature та top_p, щоб контролювати креативність. Модель не відмовляє від законних дорослих або суперечливих тем, надаючи сирі стиль відповіді. Помилки повертають стандартні коди статусів HTTP для зручного налагодження у вашому коді.

GET /v1/models

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

Copyimport OpenAI from "openai";

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

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

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

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

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)

Статистика використання токенів включена в кінцевий чанк потоку. Це дозволяє відстежувати витрати в реальному часі. Модель підтримує режим JSON для структурованих виводів, коли ви встановлюєте response_format до {"type": "json_object"}. Вибір інструментів гнучкий, дозволяючи конкретний або автоматичний вибір.

Parameters & Limits

Контекстне вікно підтримує 100,000 токенів як для запиту, так і для відповіді. Максимальний обсяг виводу за один запит становить 16,000 токенів, або 2,048, якщо ви не вкажете max_tokens. Ви можете контролювати генерацію за допомогою temperature, top_p, stop, а також seed параметри. Також доступні штрафи за частоту та наявність для тонкої налаштування.

Ліміти дозволяють 300 запитів на хвилину на ключ та 8 паралельних запитів. Максимальний розмір тіла запиту — 8 МБ. Ці ліміти забезпечують стабільну продуктивність для додатків з високою пропускною здатністю. Налаштуйте стратегію пакетної обробки, щоб залишатися в межах цих обмежень.

Помилки та ціни

HTTP 401 вказує на недійсний або відсутній API-ключ. HTTP 402 означає, що ваші передоплачені кредити вичерпано; поповніть баланс криптовалютою, щоб продовжити. HTTP 429 сигналізує про вичерпання ліміту швидкості; зачекайте або зменшіть паралельність. Помилки не споживають кредит, тому ви не платите за невдалі запити.

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