Руководство по быстрому старту нефильтрованного API

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

Начните с указания вашего SDK на наш базовый URL и передачи вашего ключа в заголовке авторизации. Мы предоставляем прямой сервис с одной моделью без комиссий за маршрутизацию прокси. Используйте стандартный Authorization: Bearer схему для аутентификации запросов. Ваш ключ генерируется сразу после регистрации через Google или email. Убедитесь, что вы заменили ключ-заполнитель в конфигурации клиента на тот, который отображается в панели управления. Базовый URL — https://api.uncensoredmodelsollama.com/v1. Этот эндпоинт поддерживает стандартных клиентов, совместимых с OpenAI, позволяя вам менять провайдеров без переписывания логики приложения. Храните свой ключ в безопасности, так как он предоставляет доступ к балансу вашей предоплаченной кредитной суммы.

Эндпоинт Chat Completions

Отправляйте текстовые запросы в /v1/chat/completions эндпоинт для генерации ответов. Этот эндпоинт обрабатывает стандартные истории разговоров и системные подсказки. Вы должны указать идентификатор модели как uncensored в теле запроса. API возвращает JSON ответы, содержащие сгенерированный текст и статистику использования токенов. Ошибки, такие как недостаточный кредит или недействительные ключи, возвращаются с соответствующими HTTP кодами состояния. Используйте этот эндпоинт для всех стандартных задач генерации текста. Он не поддерживает эмбеддинги, изображения или дообучение. Держите полезную нагрузку менее 8 МБ для надежной обработки. Модель обрабатывает входные и выходные токены в общем контекстном окне.

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

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

Function Calling и режим JSON

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

Параметры и лимиты частоты

Настройте поведение генерации с помощью параметров, таких как temperature, top_p, и seed. Установите max_tokens для ограничения длины вывода, по умолчанию 2 048, если не указано. API устанавливает ограничение частоты запросов: 300 запросов в минуту на ключ. Одновременные запросы ограничены 8 на ключ. Если вы превысите эти лимиты, API вернет статус 429. Запросы оплачиваются на основе фактического использования токенов, ошибки и отказы бесплатны. Кредит не истекает, предоплаченные средства прозрачны. Храните свои ключи в безопасности, так как на один аккаунт поддерживается только один активный ключ.

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

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

cURL

Copycurl https://api.uncensoredmodelsollama.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the ollama library."}]
  }'

Python

Copyfrom openai import OpenAI

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