Быстрый старт для пользователей OpenRouter NSFW

Базовый URL и аутентификация

Замените базовый URL вашего текущего провайдера на https://api.openrouternsfw.com/v1. Аутентификация использует стандартный заголовок Authorization: Bearer <key>. Вы получаете ключ сразу после входа через Google или email на странице Получить API-ключ. Номер телефона не требуется, а ключ отображается только один раз, поэтому скопируйте его, прежде чем покинуть страницу.

Наш сервис — это независимое API, а не перепродавец моделей других вендоров. Идентификатор модели, который вы указываете в запросах, — uncensored, и он работает на наших собственных серверах. Он настроен на ответы без отказов по контенту для законного использования взрослыми, но это не GPT, Claude или какая-либо другая модель конкретного вендора.

Убедитесь, что ваша библиотека клиентских запросов настроена на использование этого нового базового URL. Все запросы должны содержать действительный API-ключ в заголовке. Если ключ отсутствует или недействителен, сервер возвращает ошибку 401. Если у вас нет предоплаченного баланса, вы получите ошибку 402. Это стандартные коды состояния HTTP, указывающие на проблемы аутентификации или оплаты, а не ошибки сервера.

Эндпоинт завершения чата

Основная функциональность предоставляется через эндпоинт POST /v1/chat/completions. Этот эндпоинт принимает тело в формате JSON, содержащее имя модели, массив сообщений и необязательные параметры. Он возвращает объект JSON с сгенерированным текстом, статистикой использования токенов и причиной завершения. Эта структура совместима с официальными SDK OpenAI и большинством клиентских библиотек, совместимых с OpenAI.

Вам не нужно писать собственные HTTP-клиенты, если вы предпочитаете использовать SDK. Однако вы должны обновить конфигурацию, указав наш базовый URL. Следующий пример демонстрирует стандартный запрос завершения с помощью cURL. Этот запрос отправляет промпт модели без цензуры и ожидает текстовый ответ.

Копироватьcurl https://api.openrouternsfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Помните, что это API обслуживает только текст. Нет эндпоинтов для эмбеддингов, изображений, аудио или видео. Если вашему приложению требуются мультимодальные входные или выходные данные, вам нужно обрабатывать их отдельно. Наш сервис сосредоточен исключительно на генерации высококачественного текста с использованием модели без цензуры.

Интеграция Python SDK

Использование Python SDK упрощает процесс интеграции. Инициализируйте клиент, указав правильный базовый URL и ваш API-ключ. Библиотека обрабатывает HTTP-запросы и парсинг JSON за вас. Вы можете указать идентификатор модели как uncensored, чтобы убедиться, что используете именно нашу модель.

Копироватьfrom openai import OpenAI

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

Этот фрагмент кода показывает, как отправить сообщение и получить ответ. Клиент автоматически обрабатывает подключение и отчеты об ошибках. Если сервер возвращает ошибку, SDK вызывает исключение. Вам следует обрабатывать эти исключения в логике вашего приложения, чтобы улучшить пользовательский опыт.

Python SDK — это лишь один из вариантов. Вы можете использовать любой язык, поддерживающий HTTP-запросы. Структура эндпоинта остается неизменной независимо от выбранного клиента. Эта гибкость позволяет интегрировать модель без цензуры в любой существующий рабочий процесс без значительных изменений в коде.

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

Node SDK работает аналогично версии для Python. Настройте клиент, указав базовый URL и API-ключ, затем вызовите метод завершения чата. Этот подход идеален для серверных приложений или бэкенд-сервисов, которым требуется асинхронная генерация текста.

Копироватьimport OpenAI from "openai";

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

Разработчики Node.js могут легко интегрировать это API в свои существующие проекты. SDK обрабатывает сериализацию и десериализацию данных JSON. Вы также можете указать дополнительные параметры, такие как temperature или top_p, чтобы контролировать случайность вывода.

Убедитесь, что правильно обрабатываете асинхронную природу запросов. Используйте async/await или цепочки промисов для обработки данных ответа. Это позволяет вашему приложению оставаться отзывчивым во время ожидания генерации текста моделью. Node SDK — надёжный выбор для создания масштабируемых сервисов генерации текста.

Потоковые ответы

Включите потоковую передачу, установив параметр stream в значение true в вашем запросе. Сервер будет отправлять серию событий Server-Sent Events (SSE) вместо одного JSON-ответа. Каждое событие содержит частичный фрагмент сгенерированного текста.

Копировать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)

Потоковая передача полезна для приложений реального времени, где вы хотите отображать вывод по мере его генерации. Последний фрагмент потока содержит общее использование токенов для запроса. Это позволяет точно отслеживать расходы, не дожидаясь завершения всего ответа.

Внимательно обрабатывайте события потока, чтобы убедиться, что текст собран правильно. Соединяйте фрагменты в порядке их получения. Сервер гарантирует, что фрагменты отправляются последовательно. Если соединение прервано, вам может потребоваться повторить запрос. Потоковая передача — это мощная функция, которая улучшает пользовательский опыт при задачах генерации текста.

Лимиты запросов и контекстное окно

Каждый API-ключ ограничен 300 запросами в минуту и 8 параллельными запросами. Размер тела запроса ограничен 8 МБ. Если вы превысите эти лимиты, сервер вернёт статус 429. Это стандартный код HTTP, означающий, что вы отправили слишком много запросов за определённый промежуток времени. В клиенте следует реализовать экспоненциальный backoff для корректной обработки таких ошибок.

Контекстное окно поддерживает до 100,000 токенов для объединённых промпта и завершения. Отдельного ограничения на длину вывода нет. Если вы не укажете параметр max_tokens, ответ может занять весь доступный контекст. Вы можете ограничить длину вывода, установив max_tokens на меньшее значение.

Отслеживайте использование токенов, чтобы эффективно управлять предоплаченным балансом. Ошибки и отказы не потребляют токены, поэтому вы не платите за неудачные запросы. Это гарантирует, что вы платите только за успешную генерацию текста. Следите за лимитами запросов, чтобы избежать прерывания сервиса.