Документация API: uncensored Model

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

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

Включите ключ в Authorization header. Формат требует Bearer prefix. Invalid keys return a 401 status code immediately. Do not guess the token format. Use the key shown after signup.

Эндпоинт Chat Completions

Отправляйте сообщения для генерации текстовых ответов. Эндпоинт принимает стандартные JSON-пэйлоады. Четко определите роли system и user.

Структурируйте запрос с model field установлен в uncensored. API обрабатывает ввод и возвращает сгенерированный текст. Ошибки возвращают статус 402, если недостаточно кредитов. Ограничения частоты запросов вызывают ответ 429.

Поддерживаемые параметры

Управляйте поведением генерации с помощью стандартных параметров. Настройте temperature для творчества или детерминизма. Используйте top_p чтобы отфильтровать токены с низкой вероятностью. Установите max_tokens для ограничения длины вывода. Максимальное значение по умолчанию — 2 048 токена, если не указано иное.

Вы также можете установить seed для воспроизводимых результатов. Используйте stop последовательности для досрочной остановки генерации. API поддерживает presence_penalty и frequency_penalty для контроля стиля.

Потоковая передача и SSE

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

Анализируйте каждый чанк для инкрементального обновления пользовательского интерфейса. Последний чанк содержит статистику общего использования токенов. Этот метод надежно работает со стандартными HTTP-клиентами, поддерживающими SSE.

Function Calling и режим JSON

Определите инструменты в запросе, чтобы включить вызов функций. Модель решает, когда вызывать инструмент на основе контекста. Передайте определения инструментов с name, description, и parameters.

Для строгого вывода JSON установите response_format для {"type": "json_object"}. Это обеспечивает, что ответ является допустимым JSON. Используйте это для надежного парсинга структурированных данных. Вызовы инструментов возвращают контент с идентификаторами инструментов для выполнения.

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

Окно контекста поддерживает до 100 000 токенов суммарно. Это включает токены промпта и завершения. Запросы, превышающие этот лимит, завершаются ошибкой. Максимальный размер тела запроса составляет 8 МБ.

Лимиты позволяют 300 запросов в минуту на ключ. Параллельные запросы ограничены 8 на ключ. Ошибка 401 означает, что ваш ключ недействителен. Ошибка 402 указывает на недостаток предоплаченных средств. Ошибка 429 сигнализирует о превышении лимита запросов. Подождите перед повторной попыткой.

cURL

Copycurl https://api.toolcallingllms.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate 200 tokens of safe text"}]
  }'

Python

Copyfrom openai import OpenAI

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