ru ▾
Начать сейчас

Руководство по быстрому старту API Uncensored AI

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

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

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

Отправка вашего первого завершения чата

Отправьте POST-запрос на конечную точку chat completions для генерации текстовых ответов от uncensored модели. Вы можете отправлять простые промпты или структурированные сообщения в стандартном формате OpenAI. API возвращает прямой текстовый ответ без дополнительных отказов в ответе на законный контент для взрослых. Убедитесь, что вы указали поле model со значением "uncensored" в теле запроса. Эта конечная точка поддерживает только чат-завершения, но не эмбеддинги или генерацию изображений. Вы можете начать тестирование немедленно с помощью пробного кредита или оплаченного баланса.

Использование Python SDK

Инициализируйте клиент OpenAI с вашим базовым URL и API-ключом для отправки запросов программно. Этот подход позволяет вам интегрировать LLM uncensored в ваши существующие приложения Python с минимальными изменениями кода. Установите базовый URL на наш размещенный конечный пункт и передайте API-ключ для аутентификации. Клиент будет обрабатывать HTTP-запросы и возвращать объект ответа для дальнейшей обработки. Вы можете настроить параметры, такие как temperature и top_p, чтобы контролировать стиль вывода. Этот метод идеален для создания пользовательских интерфейсов или автоматизации рабочих процессов.

Использование Node SDK

Настройте OpenAI Node-клиент с конкретным базовым 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. Вот и всё.

Начать сейчас