RU ▾
https://api.uncensoredaiapis.com/v1Модель uncensored
Получить API-ключ
Uncensored AIРуководство по миграции

Как использовать API, совместимый с OpenAI, за 5 шагов

Использование API в стиле OpenAI занимает пять шагов: получить ключ, установить SDK, указать правильный базовый URL, выбрать модель и отправить сообщения. Ниже приведены все шаги с кодом, который можно скопировать.

Обновлено

Пять светящихся ступенек, ведущих к серверному кубу, иллюстрирующих шаги для начала работы с API в стиле OpenAI

Ключевые моменты

  • Любой SDK OpenAI работает здесь, как только вы измените базовый URL на https://api.uncensoredaiapis.com/v1 и используете свой ключ.
  • Идентификатор модели — uncensored; основные маршруты — POST /v1/chat/completions и GET /v1/models.
  • Потоковая передача, JSON-режим и вызов функций используют те же параметры, что и официальный API.
  • Тарификация: $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов. Вы можете начать с пробного баланса $0,50.

Краткая версия

Если вы хотите узнать, как работать в стиле API OpenAI с сервисом, который не принадлежит OpenAI, ответ заключается в том, что формат запроса является общим соглашением. Клиенту, который его поддерживает, нужны три значения: куда отправлять запросы (базовый URL), кто вы (ключ) и какую модель запустить. Измените эти три значения, и тот же код будет работать. Этот сайт следует этому соглашению, поэтому стандартные пакеты OpenAI для Python и Node.js, а также обычный curl, работают с ним.

Важно понимать, что это означает и чего не означает. Совместимость означает, что интерфейс совпадает. Это не означает, что это официальный сервис OpenAI или что он запускает модели OpenAI. Бэкенд — это одна модель с открытыми весами, запускаемая независимым провайдером и настроенная на ответы без отказов по контенту для законного использования взрослыми, и вы выбираете её с помощью идентификатора модели uncensored. Она обрабатывает только текст: без изображений, аудио, эмбеддингов или дообучения.

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

Шаг 1: получите ключ

Зарегистрируйтесь через Google или с помощью электронной почты и пароля и откройте страницу API-ключ. Новые пользователи могут получить $0,50 пробного баланса в один клик. Он действителен в течение 7 дней, ограничен одним на человека и не требует карты. Скопируйте ключ и сохраните его как переменную окружения, а не вставляйте в код:

# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"

Пробный ключ ограничен 2 параллельными запросами и 60 запросами в минуту. Платный ключ позволяет 8 параллельных и 300 в минуту. Подробности того, что включает пробный период, см. в FAQ по бесплатному пробному периоду.

Шаг 2: установите SDK и отправьте первый запрос

Установите официальный пакет для вашего языка. Оба этих пакета — те же библиотеки, которые вы использовали бы для любого сервиса в стиле OpenAI:

# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openai

Теперь первый вызов на Python. Единственное отличие от стандартной настройки — аргумент base_url:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredaiapis.com/v1",
    api_key=os.environ["API_KEY"],
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise writing assistant."},
        {"role": "user", "content": "Give me three titles for a noir short story."},
    ],
)
print(resp.choices[0].message.content)

И тот же вызов в Node:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.uncensoredaiapis.com/v1",
  apiKey: process.env.API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);

Шаг 3: разберитесь в массиве сообщений

Модели чата ничего не запоминают между вызовами. Каждый запрос содержит весь разговор в виде списка сообщений, и каждое сообщение имеет роль.

  • system задает поведение и стиль. Укажите здесь персону, правила формата и ограничения.
  • user содержит то, что спросил пользователь.
  • assistant содержит предыдущие ответы модели. Вы добавляете их самостоятельно, когда продолжаете разговор.
  • tool содержит результат вызова функции, который рассматривается ниже.

Чтобы продолжить чат, добавьте ответ ассистента и следующее сообщение пользователя в тот же список и отправьте его снова. Именно поэтому длинные диалоги обходятся дороже: за каждый запрос вы платите за всю историю как за входные токены. Контекстное окно вмещает 100 000 токенов в сумме (промпт и ответ модели), поэтому обрезка старых сообщений — обычная часть разработки чат-приложения.

Полезные поля сэмплинга передаются напрямую: temperature, top_p, stop, seed, а также штрафы за частоту и наличие. max_tokens — необязательный параметр. Установите его, если хотите ограничить длину ответа и расходы.

Шаг 4: потоковая передача, JSON-режим и инструменты

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

Добавьте stream: true, чтобы получать токены как события, отправляемые сервером. Это делает интерфейсы быстрыми, так как текст появляется, пока модель все еще пишет, а использование сообщается в конце потока.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoredaiapis.com/v1", apiKey: process.env.API_KEY });

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

JSON-режим

Используйте response_format: {"type": "json_object"}, когда ваш код анализирует ответ. Также опишите желаемые ключи в промпте.

curl https://api.uncensoredaiapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "response_format": {"type": "json_object"},
    "messages": [
      {"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
      {"role": "user", "content": "Rate this line: the rain finally stopped."}
    ]
  }'

Вызов инструментов

Передайте список tools со схемами функций и, опционально, tool_choice. Когда модель хочет запустить функцию, ответ содержит tool_calls. Вы запускаете функцию в своем коде и отправляете вывод обратно как сообщение с ролью tool. Вызовы инструментов также потоковые. Это строительный блок для агентов; страница варианты использования показывает, где это окупается.

Шаг 5: узнайте о лимитах, стоимости и ошибках

При превышении лимита API возвращает HTTP 429. Код ошибки rate_limited означает слишком много запросов в минуту, а concurrency — слишком много одновременно. Временная перегрузка также возвращает 429 с заголовком Retry-After: 5. Потоковый запрос удерживает слот параллельности до завершения потока, поэтому закрывайте потоки, которые вы больше не читаете. Лимит тела — 8 МБ. Каждый ответ содержит заголовки X-Request-Id и X-Balance-USD, и первый из них вы указываете в обращениях в службу поддержки.

Стоимость проста. Вызов чата с 3 000 входными токенами и 700 выходными токенами стоит 3 000 * $0,15 за миллион, что составляет $0,00045, плюс 700 * $0,50 за миллион, что составляет $0,00035, всего $0,0008. Тысяча таких вызовов стоит $0,80. Неудачные или отклоненные запросы не оплачиваются, а баланс никогда не сгорает. На странице тарифов указаны пополнения от $20 до $500 с +5% от $50, +10% от $100 и +15% от $200. Вы можете оплатить криптовалютой (USDT на TRC20, USDC на Base).

Чем это отличается от официального API

Три различия стоит учесть. Во-первых, имя модели: используйте uncensored, а не имя модели OpenAI. Во-вторых, объем: вы получаете только chat completions и список моделей, поэтому такие функции, как генерация изображений, речь, эмбеддинги и дообучение, здесь отсутствуют. В-третьих, поведение: модель настроена не отказывать в законных запросах от совершеннолетних пользователей, поэтому вывод может отличаться от сильно отфильтрованного ассистента. Одно правило никогда не меняется: нет сексуального контента с участием несовершеннолетних.

Несколько привычек помогут с первого дня. Храните ключ в переменной окружения, логируйте X-Request-Id каждого запроса и устанавливайте max_tokens во время экспериментов, чтобы ответ не превысил запланированные расходы. При создании чат-интерфейса используйте потоковую передачу и обрезайте старые реплики по мере роста истории. При создании конвейера обработки вывода используйте JSON-режим и всё равно защищайте парсинг, так как ответ, обрезанный по лимиту токенов, не является валидным JSON. И когда две части вашей программы одновременно обращаются к API, учитывайте их в рамках 8 одновременных запросов, которые позволяет полный ключ.

Не забывайте о стоимости тестирования. Несколько десятков экспериментов с короткими промптами стоят гораздо меньше одного цента в целом, поэтому пробного баланса $0,50 хватит надолго, пока вы изучаете формат запроса.

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

Вопросы и ответы

Нужен ли вам официальный SDK OpenAI?

Вы можете его использовать, это самый простой вариант. Также подойдет любой клиент, совместимый с OpenAI, или обычный HTTP, если он поддерживает пользовательский базовый URL.

Какое имя модели мне передать?

Отправляйте uncensored. Базовый URL — https://api.uncensoredaiapis.com/v1.

Это официальный API OpenAI?

Нет. Формат запроса тот же, но модель — это модель с открытыми весами, запущенная независимым провайдером, а сервис отделен от OpenAI.

Сколько стоит запрос?

Входные токены стоят $0,15 за 1 млн, выходные — $0,50 за 1 млн. Запрос с 3 000 входными и 700 выходными токенами стоит около $0,0008.

Могу ли я попробовать перед оплатой?

Да. После регистрации вы можете получить $0,50 пробного баланса в один клик. Он действителен в течение 7 дней и не требует привязки карты.

Ваш ключ — всего в одном шаге

Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.