Начните с нашего uncensored API

Настройка аутентификации базового URL

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

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

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

Эндпоинт Chat Completions (POST /v1/chat_completions)

Передавайте свои промпты в конечную точку chat completions для получения текстовых ответов. Это основной метод взаимодействия с нашим API. Вы структурируете свой запрос с системным сообщением для установки поведения и сообщениями пользователя для вашего фактивного запроса. Модель обрабатывает ввод и возвращает текстовый ответ.

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

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

Пример интеграции Python SDK

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

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

Мы рекомендуем использовать последнюю версию SDK для наилучшего опыта. Библиотека обрабатывает повторные попытки и парсинг JSON за вас. Вам нужно сосредоточиться только на логике промптов и параметрах модели.

Пример интеграции Node SDK

Интегрируйтесь с Node.js, используя стандартный пакет npm. Структура зеркалит пример на Python. Вы устанавливаете базовый URL для нашей конечной точки и предоставляете ваш ключ API. Это обеспечивает совместимость с существующими приложениями Node.js.

SDK Node автоматически обрабатывает HTTP-запросы. Вы передаете массив сообщений и получаете объект ответа. Он включает сгенерированный текст. Затем вы можете обработать этот текст в логике вашего приложения.

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

Потоковая передача ответов и использование токенов

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

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

Наш API поддерживает события, отправляемые сервером (SSE), для потоковой передачи. SDK обрабатывает парсинг событий. Вам нужно просто установить параметр stream в true. Это работает как с клиентами Python, так и Node. Это рекомендуемый способ создания интерактивных приложений.

Лимиты, ошибки и детали модели

Понимание ваших лимитов частоты запросов и возможных ошибок для создания надежного приложения. Вам ограничено 300 запросов в минуту и 8 параллельных запросов на ключ. Размер тела запроса ограничен 8 МБ. Если вы превысите эти лимиты, вы получите ошибку 429. Вы можете реализовать экспоненциальное замедление с откатом, чтобы gracefully обрабатывать это.

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

Вы можете проверить доступные модели через конечную точку GET /v1/models. Это вернёт единственный идентификатор uncensored модели. Мы не предлагаем несколько моделей или маршрутизацию. Эта простота снижает сложность и обеспечивает согласованное поведение. Ваш предоплаченный кредит никогда не истекает, поэтому вы можете приостановить использование без потери средств.

cURL

Copycurl https://api.keyapiunlimited.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the python libraries for web scraping"}]
  }'

Python

Copyfrom openai import OpenAI

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