Швидкий старт: Інтеграція за хвилини

1. Встановіть свій SDK

Почніть із встановлення офіційної бібліотеки для вашої мови. Більшість розробників віддають перевагу стандартному пакету, оскільки він відповідає інтерфейсу, який їм уже знайомий. Виконайте pip install openai для Python або npm install openai для Node.js. Вам потрібен лише один SDK для обробки всіх запитів.

2. Встановіть свій базовий URL

Налаштуйте клієнта, щоб вказувати на наш конкретний ендпоінт. Вам потрібно перевизначити типовий базовий URL для правильної маршрутизації трафіку. Використовуйте https://api.unsencoredai.com/v1 як вашу базову URL-адресу. Передайте свій API-ключ у Authorization header. Ця конфігурація працює з будь-яким стандартним клієнтом, сумісним з OpenAI.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

3. Надішліть свій перший запит

Надішліть стандартний запит chat completion для генерації тексту. Ідентифікатор моделі — uncensored. Ви можете надсилати системні промпти для керування поведінкою. API повертає пряму текстову відповідь. Використовуйте наведену нижче команду curl для миттєвого тестування з’єднання. Перевірте свою відповідь на наявність choices масив.

Copycurl https://api.unsencoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the version number"}]
  }'

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

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

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)

5. Налаштування параметрів

Налаштувати temperature, top_p, а також stop послідовності. Ці керування впливають на креативність та довжину виводу. Ви також можете використовувати response_format для режиму JSON. Вікно контексту підтримує 100,000 токенів загалом. Максимальний вихід — 16,000 токенів за запит. Тонко налаштуйте ці налаштування для вашого конкретного випадку використання.

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

Гарно обробляйте помилки, використовуючи стандартні коди HTTP-стану. Помилка 401 означає, що ваш API-ключ недійсний. Помилка 402 вказує на недостатність передоплачених кредитів. Помилка 429 сигналізує про те, що ви досягли ліміту в 300 запитів на хвилину. Ваше контекстне вікно становить 100,000 токенів. Запити понад 8 МБ можуть завершитися невдачею. Повернення коштів за кредити не здійснюється, але помилки є безкоштовними.