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

Базова URL-адреса та аутентифікація

Підключіться, використовуючи стандартну базову URL-адресу, сумісну з OpenAI. Замініть існуючий API-ключ на той, який згенеровано з вашої панелі керування. Ми підтримуємо будь-яку бібліотеку клієнтів, яка приймає перевизначення базової URL-адреси.

• Базовий URL: https://api.dolphinnsfw.com/v1
• Автентифікація: Bearer-токен у Authorization header.

Автентифікація миттєва. Ваш ключ працює відразу після генерації. Номер телефону не потрібен. Зареєструйтеся через Google або email. Панель керування показує ваш ключ один раз. Помилки безкоштовні. Відмови нічого не коштують. Це гарантує, що ви платите лише за фактичні токени.

Перший запит

Надішліть запит на завершення до кінцевого пункту чату. Ідентифікатор моделі — uncensored. Він обробляє дорослі теми без відмов. Використовуйте стандартні структури JSON. Тіло запиту включає повідомлення та параметри.

Ось проста команда curl для перевірки з'єднання. Вона надсилає короткий запит. У відповіді повертається згенерований текст. Перевірте код стану для підтвердження успіху.

Copycurl https://api.dolphinnsfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a 500 word scene of two dolphins mating at sunset"}]
  }'

Це працює для будь-яких простих задач генерації тексту. Ви можете налаштувати temperature та top_p. Модель відповідає швидко. Не потрібне складне налаштування.

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

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

Встановіть бібліотеку. Налаштуйте клієнт. Надішліть повідомлення. Об'єкт відповіді містить згенерований текст. Ви можете отримати використання токенів з відповіді. Це допомагає відстежувати витрати.

Copyfrom openai import OpenAI

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

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

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

Copyimport OpenAI from "openai";

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

SDK обробляє потокове передавання всередині. Ви також можете отримувати дані вручну. Це дає вам гнучкість. Оберіть метод, який найкраще підходить для вашої архітектури.

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

Увімкніть потокове передавання для виведення в реальному часі. Встановіть параметр stream у значення true. API надсилає фрагменти через Server-Sent Events. Це зменшує сприйняту затримку. Користувачі бачать текст по мірі його генерації.

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

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 застосовуються до кожного чанка. Це дозволяє тонкий контроль. Ви можете зупинити генерацію достроково. Останній чанк містить загальне використання токенів.

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

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

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

Ціноутворення прозоре. Вхідні токени коштують $0.15 за мільйон. Вихідні токени коштують $0.50 за мільйон. Помилки не споживають кредит. Це захищає ваш бюджет. Попередньо оплачений кредит не має терміну дії. Скористайтеся пробним кредитом, щоб спочатку протестувати.