Посібник з інтеграції для розробників

Налаштування автентифікації та базового URL

Почніть із генерації вашого API-ключа на панелі керування. Базова URL-адреса — HTTPS://api.apiaicheap.com/v1. Надсилайте свій ключ у заголовку Authorization як токен bearer.

• Натисніть "Отримати API-ключ" та увійдіть через Google або електронну пошту.
• Скопіюйте ключ одразу; він показується лише один раз.

Цей ключ автентифікує всі запити до ендпоінту завершення чату.

Приклад заголовка

Авторизація: Bearer YOUR_API_KEY

Перший запит через cURL

Відправте базове завершення чату для тестування налаштувань. Використовуйте кінцеву точку POST /v1/chat/completions із моделлю "uncensored".

Це підтверджує баланс ваших кредитів та затримку.

• Встановіть роль у "user".
• Зробіть повідомлення простим для першого тесту.

Перевірте відповідь на наявність поля згенерованого тексту.

• Шукайте значення "content".

Якщо ви отримали 200 OK, ваша інтеграція працює.

Copycurl https://api.apiaicheap.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the login handler"}]
  }'

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

Використовуйте офіційну Python-бібліотеку OpenAI для легкої інтеграції. Вкажіть базовий URL на наш сервіс та встановіть свій API-ключ.

Цей підхід автоматично обробляє повторні спроби та парсинг JSON.

• Встановіть бібліотеку через pip.
• Вкажіть параметр base_url на нашу кінцеву точку.

Викличте метод chat.completions.create.

Передавайте свій список повідомлень як аргумент.

• Включіть назву моделі "uncensored".

Отримайте текст відповіді через атрибути об’єкта.

Цей метод чистий і читабельний для production-скриптів.

Copyfrom openai import OpenAI

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

Налаштування SDK Node.js

SDK для Node.js працює подібно до версії для Python. Ініціалізуйте клієнт із вашим ключем та нашим базовим URL.

Це дозволяє вам використовувати знайомі шаблони async/await.

• Імпортуйте пакет OpenAI.
• Налаштуйте базовий URL у конструкторі.

Створіть запит на генерацію з вашими повідомленнями.

Обробляйте обіцянку, щоб отримати результат.

• Витягуйте вміст повідомлення з відповіді.

Логуйте вивід, щоб переконатися, що модель відповідає коректно.

Ця конфігурація ідеально підходить для веб-серверів та бекенд-сервісів.

Copyimport OpenAI from "openai";

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

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

Увімкніть потокову передачу, встановивши stream у true у своєму запиті. API повертає чанки по мірі їх генерації через події, надані сервером (SSE).

Це зменшує сприйняту затримку для користувачів у чат-додатках.

• Встановіть stream: true у корисному навантаженні.
• Обробляйте кожен фрагмент по мірі надходження.

Поєднайте фрагменти, щоб сформувати фінальну відповідь.

Деталі використання токенів з'являються у останньому чанку.

• Перевірте поле "usage" у останньому фрагменті.

Цей підхід зберігає інтерфейс користувача чуйним під час довгих генерацій.

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)

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

Ваш акаунт має ліміт 300 запитів на хвилину на ключ. Контекстне вікно підтримує 100,000 токенів загальною кількістю для промпту та завершення.

Помилки обробляються через стандартні коди стану HTTP.

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

Відмови не коштують кредиту. Помилки також безкоштовні.

Максимальний вихід становить 16,000 токенів на запит. Встановіть max_tokens, якщо вам потрібно менше.

Ця структура забезпечує передбачуване билінгування та продуктивність.