Быстрый старт API

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

Начните с указания клиента на наш базовый URL и передачи вашего ключа в заголовке. Мы используем стандартный механизм Authorization, поэтому любой SDK OpenAI или совместимый клиент заработает сразу. Вам не нужно управлять сложными потоками OAuth или ждать одобрения. Просто зарегистрируйтесь через Google или email, скопируйте ключ, и вы готовы. Конечная точка находится по адресу https://api.aiohnezensur.com/v1 и принимает Authorization: Bearer YOUR_API_KEY header на каждом запросе.

Отправка первого запроса

Отправьте простой запрос на завершение чата для тестирования uncensored модели. Этот запрос отправляет промпт и получает текстовый ответ без обычных корпоративных защитных механизмов. Вы можете использовать любой инструмент, поддерживающий протокол OpenAI, но прямой вызов curl показывает, что происходит «под капотом». Замените YOUR_API_KEY с вашим фактическим ключом из панели управления.

Copycurl https://api.aiohnezensur.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list 5 free open source image generators"}]
  }'

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

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

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

Copyfrom openai import OpenAI

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

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

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

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

Copyimport OpenAI from "openai";

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

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

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

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

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)

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

Лимиты запросов и ограничения

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