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

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

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

Copycurl https://api.modelsaiuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all available endpoint urls"}]
  }'

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

Эндпоинт Chat Completions

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

Copyfrom openai import OpenAI

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

Модель по умолчанию не отказывает в законном контенте для взрослых или спорных темах. Установите параметры, такие как temperature для креативности или top_p для разнообразия. Если вы не укажете max_tokens, вывод по умолчанию составляет 2,048 токенов. Запросите до 16,000 токенов для более длинных ответов. Этот эндпоинт — все, что вам нужно для большинства задач автоматизации.

Потоковые ответы (SSE)

Получайте генерацию токенов в реальном времени с использованием 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)

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

Function Calling и режим JSON

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

Copyimport OpenAI from "openai";

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

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

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

Наш API устанавливает строгие лимиты для обеспечения стабильности для всех пользователей. Вам разрешено 300 запросов в минуту и 8 одновременных запросов на ключ. Тело каждого запроса должно быть меньше 8 МБ, чтобы избежать проблем с избыточным полезным грузом. Эти лимиты применяются к каждому API-ключу, поэтому распределяйте нагрузку между ключами при необходимости.

Ошибки, такие как 401, указывают на неверный или отсутствующий ключ. Ошибка 402 означает, что ваши предоплаченные кредиты исчерпаны. Статус 429 сигнализирует о достижении лимита запросов. Сделайте паузу и повторите попытку через короткую задержку. Эти ограничения прозрачны, скрытого ограничения скорости в пиковые периоды нет.

Контекстное окно и лимиты вывода

Модель поддерживает контекстное окно объёмом 100,000 токенов, включающее как промпт, так и завершение. Это позволяет проводить обширный анализ документов или хранить длинные истории разговоров. Однако максимальный объём вывода за запрос ограничен 16,000 токенами. Если вы не укажете max_tokens, значение по умолчанию составляет 2,048 токенов.

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