Dolphin без цензури API Документація

Передумови та налаштування середовища

Почніть із переконання, що у вашому середовищі встановлено необхідні залежності перед надсиланням будь-яких запитів. Вам знадобиться активний API-ключ з нашої панелі керування та підтримуваний час виконання, такий як Python або Node.js. Наш API вимагає надсилати запити до конкретної базової URL-адреси, а не до типового кінцевого пункту OpenAI.

Зберігайте ваш API-ключ у безпеці та зберігайте його у змінній середовища. Це запобігає випадковому розголошенню у вашому репозиторії коду. Ви можете миттєво згенерувати новий ключ після реєстрації через Google або електронну пошту.

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

Встановлення офіційного SDK OpenAI

Встановіть офіційний пакет SDK для автоматичної обробки автентифікації та форматування запитів. Ця бібліотека підтримує середовища Python та Node.js зі сталими інтерфейсами.

Для користувачів Python виконайте стандартну команду pip install, щоб додати бібліотеку до вашого віртуального середовища. Розробники Node.js повинні використати npm для встановлення еквівалентного пакета.

SDK керує структурою JSON-запиту за вас, тому вам потрібно зосередитися лише на змісті промпта та параметрах, таких як temperature або top_p.

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

Налаштування базового URL та API-ключа

Направте клієнт SDK на нашу конкретну базову URL-адресу, щоб маршрутизувати запити до нашої необмеженої інфраструктури. Використовуйте https://api.dolphinuncensored.com/v1 як вашу кінцеву точку.

Встановіть свій API-ключ у заголовку авторизації або об'єкті конфігурації клієнта. Клієнт автоматично додаватиме цей ключ до кожного запиту.

Переконайтеся, що ви вказуєте ID моделі як "uncensored" у своїй конфігурації. Це повідомляє сервер, яку версію моделі використовувати для вашої генерації.

Зроблення першого запиту на створення діалогу

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

Використовуйте ендпоінт chat-completions із системним промптом і повідомленням користувача. У відповіді буде міститися згенерований текст у полі content.

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

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

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

Встановіть параметр stream у true в тілі запиту. Перебирайте фрагменти, щоб зібрати кінцевий текст або обробляти його в реальному часі.

Вирішення помилок та відмов

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

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

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

cURL

Copycurl https://api.dolphinuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the list of installed python packages"}]
  }'

Python

Copyfrom openai import OpenAI

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