Швидкий старт: Інтегруйте API без цензури

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

Встановіть офіційний SDK для вашої мови. Ми підтримуємо будь-яку openai сумісний клієнт. Наш сервіс діє як пряма заміна стандартних інтеграцій OpenAI.

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

Використовуйте версію стандартної бібліотеки. Більшість розробників вже мають їх встановленими. Якщо ні, додайте пакет до своїх залежностей.

Аутентифікація: Встановлення API-ключа

Передавайте свій ключ через Authorization header. Ми вимагаємо Bearer токен для кожного запиту. Цей метод є стандартним для всіх кінцевих точок, сумісних з OpenAI.

Згенеруйте свій ключ на панелі керування. Ви отримуєте один активний ключ на акаунт. Заміна його миттєво робить попередній недійсним.

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

Точка доступу: POST /v1/chat/completions

Надішліть свій промпт до кінцевої точки chat. Використовуйте model field встановлено на uncensored. Це забезпечує, що запит маршрутизується до нашої конкретної моделі.

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

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

Парсуйте формат Server-Sent Events. Кожен чанк містить частковий текст. Агрегуйте ці чанки, щоб відновити повну відповідь.

Моніторьте використання токенів у останньому чанку. Останній захід містить повну статистику використання. Це допомагає точно відстежувати витрати.

Function Calling та використання інструментів

Визначте інструменти в тілі запиту. Модель повертає структуровані аргументи. Спарсіть ці аргументи в логіці вашого додатка.

Підтримує стандартні визначення інструментів. Використовуйте tool_choice щоб примусово забезпечити конкретну поведінку. Це працює з будь-яким SDK, сумісним з OpenAI.

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

Режим JSON та структуровані виводи

Встановити response_format до json_object. Модель повертає суто відформатований JSON. Це усуває помилки парсингу для структурованих даних.

Чітко визначте вашу схему. Модель точно дотримується ваших інструкцій. Використовуйте це для видобування даних або генерації конфігурацій.

Обробка помилок парсингу JSON. Іноді все ще трапляються недійсні структури. Реалізуйте логіку резервного варіанту для надійних додатків.

Обробка помилок та ліміти частоти запитів

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

Дотримуйтесь ліміту 300 запитів на хвилину. Ви можете надіслати 8 паралельних запитів. Перевищення цих лімітів повертає помилку 429. Зачекайте перед повторною спробою.

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

cURL

Copycurl https://api.alternativeapiopenai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the primary functions in this module"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Потокова передача

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)