RU ▾
Получить API-ключ

Эндпоинты API, совместимого с OpenAI: что поддерживается

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

Обновлено

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

  1. Пять путей: chat completions, responses, модели и два пути для баланса.
  2. Идентификатор модели — uncensored, и один ключ работает с любым SDK OpenAI.
  3. Нет изображений, аудио, видео, эмбеддингов или дообучения.
  4. Лимиты возвращают HTTP 429 с четким кодом ошибки.
Центральный хаб с пятью кабелями, по одному на каждый поддерживаемый эндпоинт API

Эндпоинты вкратце

Какие пути в стиле OpenAI действительно реализует провайдер? Вот краткий список для этого API. Базовый URL: https://api.uncensoredendpoint.com/v1. Аутентификация — ключ Bearer при каждом вызове.

Метод и путьНазначение
POST /v1/chat/completionsЗапросы чата, потоковая передача, инструменты, JSON-режим
POST /v1/responsesБолее новый формат запроса в стиле Responses
GET /v1/modelsВыводит список моделей; ID — uncensored
GET /v1/dashboard/billing/credit_grantsБаланс в формате, совместимом с OpenAI
GET /v1/balanceБаланс в простом формате

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

Завершение диалога

Это эндпоинт, который используют большинство клиентов. Направьте любой SDK OpenAI на base URL и используйте имя модели uncensored.

from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are a concise assistant."},
        {"role": "user", "content": "List three uses of a webhook."},
    ],
    temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)

Поддерживаемые параметры включают stream, tools, tool_choice, response_format со значением json_object, а также параметры сэмплирования: temperature, top_p, stop, seed и штрафы. max_tokens необязателен, так как генерация может использовать все оставшиеся токены в контекстном окне на 100 000 токенов.

При включенном stream: true ответ приходит в виде server-sent событий, а использование указывается в конце, поэтому вы все равно можете логировать количество токенов.

Многотуровые чаты

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

Responses, модели и баланс

Responses

Новые примеры от OpenAI используют /v1/responses. Он также доступен здесь, поэтому код, написанный для этого формата, не нужно переписывать.

curl https://api.uncensoredendpoint.com/v1/responses \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "uncensored", "input": "Write a haiku about caching."}'

Используйте то, что ожидает ваш клиент. Если вы начинаете с нуля, chat completions имеет самую широкую поддержку инструментов.

Модели и баланс

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

curl https://api.uncensoredendpoint.com/v1/models -H "Authorization: Bearer YOUR_KEY"

# remaining credit, OpenAI-style
curl https://api.uncensoredendpoint.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_KEY"

# remaining credit, short form
curl https://api.uncensoredendpoint.com/v1/balance -H "Authorization: Bearer YOUR_KEY"

Вы также получаете баланс в каждом ответе в заголовке X-Balance-USD, что удобно для предупреждения о низком балансе в вашем приложении без дополнительного запроса. Другие заголовки включают X-Request-Id для вопросов поддержки, а также X-RateLimit-Limit-Requests и X-RateLimit-Limit-Concurrency.

Инструменты и JSON-режим на практике

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

Вызов инструмента выглядит так. Модель возвращает запись tool_calls, вы выполняете функцию и отправляете результат обратно как сообщение с role: "tool".

import json
from openai import OpenAI

client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Current weather for a city",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"],
        },
    },
}]

msgs = [{"role": "user", "content": "Weather in Oslo?"}]
r = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
call = r.choices[0].message.tool_calls[0]
args = json.loads(call.function.arguments)

msgs.append(r.choices[0].message)
msgs.append({"role": "tool", "tool_call_id": call.id, "content": '{"temp_c": 4}'})
final = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
print(final.choices[0].message.content)

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

Перенос существующего проекта OpenAI

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

export OPENAI_BASE_URL=https://api.uncensoredendpoint.com/v1
export OPENAI_API_KEY=YOUR_KEY
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.uncensoredendpoint.com/v1", apiKey: process.env.KEY });
const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Ping" }],
});
console.log(r.choices[0].message.content);

Затем найдите в коде имена моделей, такие как ID модели GPT, и замените их на uncensored, так как сервис использует одну модель. Удалите вызовы эмбеддингов, изображений или аудио и направьте их к другому провайдеру. Ведите короткий чек-лист: изменен base URL, изменено имя модели, ключ сохранен в переменной окружения, а не в репозитории, логика повтора для 429 и предупреждение о низком балансе на основе заголовка баланса. Для настройки ключа см. как получить API-ключ для ИИ без цензуры. Затем выполните один тестовый запрос и убедитесь, что возвращается X-Balance-USD, прежде чем переключать реальный трафик.

Что не предлагается

Знание ограничений экономит день отладки. Этот API поддерживает только текст. Эти эндпоинты OpenAI недоступны:

  • Генерация изображений. Генерация или редактирование изображений отсутствуют.
  • Аудио. Нет распознавания речи или синтеза речи.
  • Видео. Не предлагается.
  • Эмбеддинги. Если вы создаете систему поиска, вам нужен отдельный сервис эмбеддингов.
  • Дообучение. Вы не можете обучать модель на сервисе.

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

Лимиты, ошибки и повторные попытки

Полный ключ позволяет 8 параллельных запросов и 300 запросов в минуту. Пробный ключ позволяет 2 параллельных и 60 в минуту. Максимальный размер тела — 8 МБ. При превышении лимита вы получаете HTTP 429 с кодом ошибки, указывающим, какой лимит превышен: rate_limited для запросов в минуту, concurrency для одновременных запросов. При временной перегрузке вы также получаете 429 с заголовком Retry-After: 5.

Один нюанс сбивает с толку: потоковый запрос удерживает слот параллельности до конца потока, поэтому медленные потребители учитываются в лимите. Простая обертка для повторов обрабатывает все это:

import time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")

def ask(prompt, tries=4):
    for i in range(tries):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 * (i + 1))
    raise RuntimeError("still rate limited")

Неудачные или отклонённые запросы не оплачиваются, поэтому повторы при ошибках не стоят дополнительных денег. Для пакетных задач ограничьте пул воркеров 8 для полного ключа или 2 для пробного ключа, вместо того чтобы полагаться на повторы. Фиксированный пул проще контролировать, и он не дает одному медленному потоку заблокировать остальные.

Стоимость и доступ

Тарифы: $0,15 за 1M входных токенов и $0,50 за 1M выходных токенов, списываются с предоплаченного баланса без подписки и не сгорают. Пополняйте на любую целую сумму от $20 до $500 криптовалютой (USDT на TRC20, USDC на Base). Большие пополнения дают бонус: +5% от $50, +10% от $100, +15% от $200. См. страницу с ценами.

Чтобы попробовать, зарегистрируйтесь через Google или электронную почту, затем получите бесплатный пробный баланс на $0,50 в один клик на странице API-ключа. Документация описывает каждый параметр, а обзор эндпоинтов объясняет, что представляет собой сервис: одна модель с открытыми весами для законного использования взрослыми, без отказов по контенту и строгим запретом на сексуальный контент с участием несовершеннолетних.

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

Поддерживает ли он потоковую передачу и вызов функций?

Да. Используйте stream: true для server-sent событий со статистикой использования (usage) в конце и tools с tool_choice для вызова функций.

Есть ли эндпоинт для эмбеддингов?

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

Как проверить свой баланс?

Вызовите GET /v1/balance или путь credit_grants в стиле OpenAI, либо прочитайте заголовок X-Balance-USD в любом ответе.

Что происходит, когда я достигаю лимита запросов?

Вы получите HTTP 429 с кодом rate_limited или concurrency. Подождите и повторите попытку; при временной перегрузке заголовок Retry-After указывает 5 секунд.

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

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

Получить API-ключЧитать документацию