Документация API & Быстрый старт

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

Начните с генерации вашего API-ключа на панели управления. Мы используем стандартные заголовки, совместимые с OpenAI, поэтому вам нужно только обновить ваш base_url и API_KEY переменные. Это гарантирует, что ваши существующие интеграции SDK будут работать без изменений. Мы поддерживаем вход через Google или регистрацию по электронной почте и паролю, и ваш ключ появляется сразу после создания.

• Базовый URL: https://api.routeropen.cc/v1
• Заголовок Auth: Authorization: Bearer YOUR_API_KEY

Храните ваш ключ в безопасности, так как он контролирует ваш предоплаченный кредит. Каждый аккаунт позволяет один активный ключ в момент времени; генерация нового ключа немедленно заменяет старый.

Первый запрос

Отправьте первый запрос, используя стандартный chat/completions эндпоинт. Идентификатор модели просто uncensored. Это отправляет текст на вход и возвращает текст на выход, без фильтров контента для законного использования взрослыми.

Copycurl https://api.routeropen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all files in current directory"}]
  }'

Этот запрос демонстрирует базовую структуру. Вы можете настроить параметры, такие как temperature или top_p для управления креативностью. Ответ включает статистику использования токенов для прозрачной биллинговой системы.

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

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

Copyfrom openai import OpenAI

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

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

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

Для разработчиков JavaScript SDK Node работает с минимальными изменениями. Установите baseURL к конечной точке и укажите ваш ключ. Это позволяет вам сохранить текущий рабочий процесс разработки, получая доступ к uncensored моделям.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.routeropen.cc/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 могут использовать паттерны async/await для чистого кода. Структура ответа соответствует стандартам OpenAI, обеспечивая совместимость с существующими парсерами. Вы можете переключать модели или провайдеров, изменив всего две переменные.

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

Включите потоковую передачу, установив stream: true в вашем запросе. Мы возвращаем Server-Sent Events (SSE) для доставки токенов в реальном времени. Это снижает воспринимаемую задержку для конечных пользователей.

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)

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

Лимиты, Ошибки & Контекст

Наш API ограничивает контекстное окно до 100 000 токенов и размер тела запроса до 8 МБ. Вы можете выполнять до 300 запросов в минуту на ключ. При превышении этого лимита вы получите ошибку ограничения скорости 429. Ошибки аутентификации возвращают 401, а недостаточный баланс — 402.

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