uk ▾
Почати зараз

Посібник зі швидкого старту API Uncensored AI

Цей посібник зі швидким стартом допоможе інтегрувати uncensored API Dolphin за допомогою стандартних SDK OpenAI, обходячи ліміти сторонніх сервісів та шари цензури.

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

Налаштуйте клієнта з наданим базовим URL та ключем API для прямого підключення до нашого хостованого ендпоінту. Ви отримуєте один активний ключ негайно після реєстрації через Google або електронну пошту, без необхідності вказувати номер телефону. Базовий URL: HTTPS://api.uncensoreddolphinopenrouter.com/v1, а ідентифікатор моделі — "uncensored". Ця настройка працює з будь-яким OpenAI-сумісним клієнтом шляхом простої зміни base_url та надання вашого ключа API в заголовку Authorization. Немає щомісячних підписок або складної маршрутизації, просто прямий доступ до моделі.

Надсилання вашого першого запиту на завершення чату

Надішліть POST-запит на кінцеву точку завершення чату для генерації текстових відповідей від моделі uncensored. Ви можете надсилати прості промпти або структуровані повідомлення у стандартному форматі OpenAI. API повертає пряму текстову відповідь без додаткових відмов у вмісті для законного дорослого контенту. Переконайтеся, що ви включили поле model із значенням "uncensored" у тіло запиту. Ця кінцева точка підтримує лише завершення чату, а не вбудовування або генерацію зображень. Ви можете почати тестування негайно з пробним кредитом або платним балансом.

Використання Python SDK

Ініціалізуйте клієнт OpenAI з вашим базовим URL та API-ключем для надсилання запитів програмно. Цей підхід дозволяє інтегрувати LLM без цензури в існуючі Python-додатки з мінімальними змінами в коді. Встановіть базовий URL на наш хостований ендпоінт та передайте свій API-ключ для автентифікації. Клієнт оброблятиме HTTP-запити та повертатиме об'єкт відповіді для подальшої обробки. Ви можете регулювати параметри, такі як temperature та top_p, щоб керувати стилем виведення. Цей метод ідеально підходить для створення користувацьких інтерфейсів або автоматизації робочих процесів.

Використання Node SDK

Налаштуйте клієнт OpenAI Node.js з конкретним базовим URL та вашим API-ключем для взаємодії з API. Це забезпечує бездоганну інтеграцію в Node.js-додатки, використовуючи знайомі шаблони SDK. Вкажіть клієнт на HTTPS://api.uncensoreddolphinopenrouter.com/v1 та надайте ваш ключ для автентифікації. Потім ви можете викликати метод chat completions з бажаними параметрами. Відповідь містить згенерований текст та статистику використання токенів. Ця конфігурація ідеально підходить для серверних додатків або бекенд-сервісів, що потребують генерації тексту без цензури.

Обробка потокових відповідей

Увімкніть потокову передачу, встановивши параметр stream у true у своєму запиті, щоб отримувати оновлення токенів у реальному часі. API повертає події, надіслані сервером (SSE), для миттєвого зворотного зв'язку під час генерації токенів. Кожен чанк містить частковий текст, а дані про використання — у фінальному чанку. Цей підхід зменшує сприйняту затримку для користувачів, поступово відображаючи вивід. Ви можете парсити потік SSE для оновлення інтерфейсу користувача в реальному часі. Потокова передача підтримується для всіх запитів на завершення чату, включаючи ті, що використовують виклик функцій або режим JSON.

Розуміння лімітів та вартості токенів

Вікно контексту підтримує до 100 000 токенів для сумарного запиту та відповіді. Максимальний об’єм відповіді за один запит становить 16 000 токенів. Ціна становить $0.15 за 1M вхідних токенів та $0.50 за 1M вихідних токенів, сплачується лише за фактичне використання. Помилки та відмови не нараховуються, тому ви платите лише за успішні завершення. Попередньо оплачений кредит не має терміну дії, і ви можете поповнити рахунок криптовалютою від $20. Ця прозора модель ціноутворення допомагає ефективно керувати витратами без прихованих комісій.

Ліміти швидкості та паралельність

Кожний API-ключ обмежений 300 запитами на хвилину та 8 паралельними запитами для забезпечення стабільної продуктивності. Максимальний розмір тіла запиту становить 8 МБ, що відповідає великим контекстним вікнам. Якщо ви перевищите ці ліміти, отримаєте помилку 429, що вказує на перевищення ліміту швидкості. Ви можете згенерувати новий ключ для заміни існуючого, оскільки в одному обліковому записі активний лише один ключ. Ці обмеження запобігають зловживанням, зберігаючи високу доступність. Слідкуйте за використанням, щоб залишатися в межах цих лімітів для оптимальної продуктивності.

cURL

curl https://api.uncensoreddolphinopenrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List five key differences between python and rust"}]
  }'

Python

from openai import OpenAI

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

import OpenAI from "openai";

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

Потокова передача

stream = 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)

Поширені запитання

Чи сумісна uncensored Dolphin API з моделями OpenRouter?

Так, наш API повністю сумісний з OpenAI, тобто працює зі стандартними SDK, які використовуються для моделей OpenRouter. Однак ми є незалежним сервісом і не надаємо ту саму модель чи інфраструктуру, що й OpenRouter. Ви можете використовувати той самий код клієнта, але спрямувати його на наш базовий URL для прямого доступу без лімітів швидкості сторонніх постачальників.

Що станеться, якщо я отримую помилку 402?

Помилка 402 вказує на те, що на вашому акаунті недостатньо коштів для обробки запиту. Ви можете поповнити баланс за допомогою USDT на мережі TRC20 або USDC на мережі Base, сумами від $20 до $500. За великі поповнення нараховується бонусний кредит, і ваш кредит не має строку дії. Помилки типу 401 (недійсний ключ) вимагають перевірки вашого API-ключа, тоді як 429 (перевищення ліміту) означає, що ви перевищили ліміт у 300 запитів на хвилину.

Чи можу я використовувати це API для виклику функцій та режиму JSON?

Так, API підтримує виклик функцій (інструменти) та режим JSON через параметр response_format. Ви можете визначити інструменти в запиті та отримувати структуровані відповіді у форматі JSON. Це дозволяє просунуту інтеграцію з додатками, які потребують структурованих даних або динамічного використання інструментів. uncensored модель надійно обробляє ці формати, що робить її придатною для складних робочих процесів.

Отримайте свій ключ зараз

Зареєструйтеся, візьміть ключ, оновіть базовий URL. Ось і все.

Почати зараз