Швидкий старт: API завершення чату

Передумови та базовий URL

Наш API повністю сумісний зі стандартним інтерфейсом завершення чату OpenAI. Вам потрібен лише базовий URL та ключ API, щоб почати надсилати запити. Базовий URL — HTTPS://api.howmuchisanapikey.com/v1. Ця єдина кінцева точка обробляє всю генерацію тексту без необхідності керувати кількома URL-адресами служб або конфігурацією проксі.

Аутентифікація проста. Ви повинні включити заголовок Authorization із схемою Bearer, за яким слідує ваш унікальний ключ. Кожен запит до кінцевої точки chat completions вимагає цього заголовка для перевірки вашого акаунта та відстеження використання токенів проти вашого попередньо оплаченого кредитного балансу.

Автентифікація та заголовки

Включіть заголовок Authorization у кожен запит, щоб підтвердити вашу особу. Формат заголовка — Authorization: Bearer YOUR_API_KEY. Якщо ключ недійсний або прострочений, API негайно повертає помилку 401. Це гарантує, що лише авторизовані облікові записи можуть споживати ваш передоплачений кредит.

Вам не потрібно передавати додаткові заголовки для базової генерації тексту. Однак, якщо ви використовуєте такі функції, як режим JSON або виклик функцій, ви повинні встановити заголовок Content-Type на application/json. Це повідомляє серверу, як правильно розпарсити тіло запиту.

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

Надішліть POST-запит до /v1/chat/completions із історією ваших повідомлень та ідентифікатором моделі. Ідентифікатор моделі — "uncensored". Ця модель доопрацьована для відповідей без відмов для законного дорослого контенту, художніх творів або дискусійних тем. Вона не фільтрує на основі стандартних політичних чи соціальних норм.

Ось базовий приклад curl для початку роботи:

Copycurl https://api.howmuchisanapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple hello world function in python"}]
  }'

Відповідь міститиме згенерований текст у масиві choices. Ви можете безпосередньо розпарсити його в логіку вашого додатку. Кожен запит споживає вхідні токени для вашого промпта та вихідні токени для відповіді моделі.

Потокова передача відповідей та використання токенів

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

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

Виклик функцій та режим JSON

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

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

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

Вам доступно до 300 запитів на хвилину на ключ та 8 одночасних запитів. Якщо ви перевищите ці ліміти, отримаєте помилку 429 Too Many Requests. Тіло відповіді міститиме деталі retry-after. Налаштуйте обмеження швидкості на стороні клієнта, щоб уникнути непотрібних повторних спроб.

Якщо ваш попередньо оплачений кредит вичерпано, API повертає помилку 402 Payment Required. Ви можете поповнити баланс через криптовалюту в будь-який час. Помилки та відмови безкоштовні, тому ви платите лише за успішну генерацію токенів. Вікно контексту становить 100,000 токенів для запиту та відповіді разом.

Python

Copyfrom openai import OpenAI

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