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

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

Використовуйте свій API-ключ із кожним запитом. Базовий URL — https://api.nsfwroleplayapi.com/v1. Встановіть Authorization header для Bearer YOUR_API_KEY. Ваш ключ надає доступ до кінцевого пункту chat-completions.

Ендпоінт Chat Completions

Надішліть свій промпт до POST /v1/chat/completions. Вкажіть модель "uncensored" у тілі запиту. API повертає згенерований текст на основі вашого входу.

context_window дозволяє до 100,000 токенів загалом. Це включає як промпт, так і завершення. Ви можете встановити max_tokens щоб обмежити вивід.

Copycurl https://api.nsfwroleplayapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Confirm monthly credit balance is active"}]
  }'

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

Увімкніть потокову передачу, встановивши stream: true. API надсилає події, що надсилаються сервером (SSE), по мірі генерації токенів. Отримуйте оновлення тексту в реальному часі у вашій програмі. Це покращує користувацький досвід для довгих відповідей.

Останній фрагмент містить загальне використання токенів. Точно відстежуйте споживання вашого передоплаченого кредиту. Помилки не споживають кредит.

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)

Параметри: Temperature, Top P та Режим JSON

Керуйте генерацією з temperature та top_p. Налаштуйте їх, щоб змінити креативність або детермінованість. Використовуйте response_format з {"type": "json_object"} для структурованих даних. Це гарантує послідовні формати виводу.

Ви також можете встановити seed для відтворюваних результатів. Встановіть stop послідовності для дострокової зупинки генерації. Ці параметри дають вам точний контроль.

Copyfrom openai import OpenAI

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

Ліміти частоти та конкурентність

Кожний API-ключ підтримує 300 запитів на хвилину. Ви можете мати 8 паралельних запитів одночасно. Ліміт розміру тіла запиту становить 8 МБ. Перевищення цих лімітів повертає помилку 429.

Ви можете створити новий ключ, щоб замінити старий. На обліковий запис дозволено лише один активний ключ. Керуйте своїми ключами, щоб підтримувати доступ. Це забезпечує стабільну продуктивність.

Copyimport OpenAI from "openai";

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

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

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

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