Документація API

Автентифікація та базовий URL

Почніть із генерації вашого ключа на панелі керування. Наша базова URL-адреса — HTTPS://api.aivenice.cc/v1. Передавайте свій ключ у заголовку Authorization. Один активний ключ на обліковий заміняє старий автоматично.

Приклад першого запиту

Надішліть простий запит на отримання відповіді чату, щоб протестувати з’єднання. Ідентифікатор моделі — "uncensored". Він ефективно обробляє вхідний та вихідний текст. Ви можете налаштовувати такі параметри, як temperature для креативності.

Copyfrom openai import OpenAI

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

Використовуйте офіційний Node SDK для легкої інтеграції. Встановіть базовий URL на нашу кінцеву точку. Передайте свій API-ключ у об'єкті конфігурації. Цей підхід працює з більшістю стандартних OpenAI-сумісних бібліотек.

Copyimport OpenAI from "openai";

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

Обробляйте відповіді напряму у середовищі JavaScript. Структура відповідає стандартним форматам OpenAI для знайомості.

Потокові відповіді

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

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 для оновлення вашого інтерфейсу в реальному часі. Це ідеально підходить для інтерфейсів чату, які вимагають миттєвого зворотного зв’язку.

Parameters and limits

Налаштуйте temperature, top_p та seed для контролю. Максимальний обсяг виводу — 16,000 токенів. Розмір контекстного вікна — 100,000 токенів. Ліміт швидкості — 300 запитів на хвилину. Максимальний розмір тіла запиту — 8 МБ.

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

Помилки та контекстне вікно

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

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

cURL

Copycurl https://api.aivenice.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the latest error logs from server logs"}]
  }'