API Mistral AI: Швидкий старт

Базова URL-адреса та аутентифікація

Перший крок — налаштувати ваш клієнт на нашу інфраструктуру. Замініть стандартний базовий URL OpenAI на HTTPS://api.apimistralai.com/v1 і вставте свій унікальний API-ключ у заголовок авторизації. Ця проста заміна перенаправляє всі запити до нашої uncensored моделі, зберігаючи вашу існуючу логіку інтеграції незмінною.

• Базова URL-адреса: HTTPS://api.apimistralai.com/v1
• Аутентифікація: Bearer-токен через Authorization header

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

Перший запит

Надішліть стандартний запит на завершення чату для перевірки з’єднання та відповіді моделі. Наступний curl команда цільовий uncensored модель з базовим промптом.

Це підтверджує, що кінцева точка доступна і повертає текст без стандартних фільтрів контенту.

Copycurl https://api.apimistralai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in python list comprehension"}]
  }'

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

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

Використовуйте офіційну Python-бібліотеку OpenAI для взаємодії з нашим API без зміни основної структури запиту. Ініціалізуйте клієнта з новим базовим URL та вашим API-ключем, а потім викличте chat.completions.create.

Цей підхід дозволяє вам зберегти всю існуючу Python-логіку, отримавши доступ до можливостей uncensored моделі.

Copyfrom openai import OpenAI

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

Об'єкт поведінки відповіді ідентичний стандартним відповідям OpenAI, що робить міграцію безперешкодною для розробників Python.

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

Для середовищ JavaScript або TypeScript ініціалізуйте пакет OpenAI з користувацьким базовим URL. Встановіть apiKey та baseURL властивості перед викликом chat.completions.create.

Це забезпечує маршрутизацію запитів із ваших додатків Node.js до нашого ендпоінту без цензури, зберігаючи сумісність із патернами стандартних SDK.

Copyimport OpenAI from "openai";

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

Структура відповіді залишається узгодженою зі стандартами OpenAI, що дозволяє легко інтегруватися в існуючі робочі процеси Node.js.

Потокові відповіді через SSE

Увімкніть миттєву генерацію токенів, встановивши stream: true у вашому запиті. API повертає потік подій, надісланих сервером (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)

Парсуйте потік даних SSE для відображення токенів поступово. Останній чанк містить загальне використання токенів для запиту.

Ліміти, помилки та контекст

Моніторьте використання, орієнтуючись на суворі ліміти швидкості, та коректно обробляйте поширені HTTP-помилки. Вам дозволено 300 запитів на хвилину та 8 одночасних запитів на ключ.

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

Ваше контекстне вікно підтримує 100 000 токенів загалом, з максимальним виводом 16 000 токенів за запит. Помилки та відмови не споживають кредит, гарантуючи, що ви платите лише за фактично згенерований контент.