Ключевые моменты
- Наш базовый URL — https://api.uncensoredgptapi.com/v1, а идентификатор модели —
uncensored. - SDK для Python и Node принимают base_url или baseURL; обе также считывают переменные окружения.
- Большинство сбоев возникает из-за отсутствия /v1, удвоенного пути или устаревшего имени модели.
- Запрос GET /v1/models — самый быстрый способ подтвердить правильность URL и ключа.
Что делает базовый URL
gpt api base_url — это адрес, который OpenAI SDK добавляет к каждому пути эндпоинта. По умолчанию официальные SDK отправляют запросы на серверы OpenAI. Если вы укажете другой базовый URL, тот же клиентский код будет отправлять запросы в том же формате на другой сервер, поддерживающий этот протокол.
На этом, по сути, и ограничивается значение «совместимый с OpenAI». Наш API принимает POST /v1/chat/completions и GET /v1/models с теми же структурами JSON, тем же заголовком Authorization: Bearer и тем же форматом потоковой передачи. Поэтому вам нужно изменить три значения:
- Базовый URL:
https://api.uncensoredgptapi.com/v1 - API-ключ: ключ из вашей панели управления
- Модель:
uncensored
Наш сервис — независимый, он запускает единственную модель с открытыми весами. Это не API OpenAI и не роутер к другим вендорам, поэтому такие имена моделей, как gpt-4o, здесь отсутствуют. Везде используйте uncensored.
Python с SDK OpenAI
В текущем SDK Python передавайте base_url при создании клиента.
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredgptapi.com/v1",
api_key="YOUR_API_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Explain what a base URL is in two sentences."},
],
)
print(resp.choices[0].message.content)Если ваш код старый и использует openai.api_base, значит, вы используете SDK версии до 1.0, где глобальная настройка называется иначе. Обновить пакет обычно проще, чем адаптировать код. Проверьте версию с помощью pip show openai.
Понимание того, как SDK формирует запрос, помогает. Он берёт ваш базовый URL, добавляет к нему путь эндпоинта, например /chat/completions, и добавляет заголовок Authorization: Bearer со значением из вашего ключа. Это весь механизм. Если что-то не работает, выведите или запишите в лог итоговый URL и сравните его с командой curl из следующего раздела.
Тот же клиент принимает настройки timeout и max_retries. Значения по умолчанию пытаются повторить запрос несколько раз при проблемах с соединением, что подходит для большинства скриптов. При лимитах запросов перехватывайте исключение SDK о лимите и делайте паузу. Потоковый запрос удерживает слот параллельных запросов до завершения, поэтому всплеск длинных потоков может превысить лимит параллельных запросов, даже если количество запросов в минуту низкое.
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY", max_retries=0)
def ask(text, tries=4):
for attempt in range(tries):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": text}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (attempt + 1))
raise RuntimeError("still rate limited")Ожидание пять секунд перед первой повторной попыткой соответствует значению Retry-After: 5, которое API отправляет при временной перегрузке. Увеличение времени ожидания при последующих попытках предотвращает чрезмерную нагрузку на эндпоинт.
Node и curl
SDK Node использует baseURL с заглавной буквой U в URL.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredgptapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);Без использования SDK curl показывает ровно то, что делает SDK. Полный URL — это базовый URL плюс /chat/completions.
curl https://api.uncensoredgptapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'Анализ этой команды — самый ясный способ понять базовый URL: всё до и включая /v1 — это база, а SDK добавляет остальное.
Переменные окружения
Если вы не можете редактировать код или хотите одну настройку для нескольких скриптов, SDK OpenAI считывают OPENAI_BASE_URL и OPENAI_API_KEY из окружения, если явное значение не передано.
export OPENAI_BASE_URL="https://api.uncensoredgptapi.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
python my_script.pyЭто удобно для инструментов, которые вы не писали. Любой инструмент, построенный на SDK OpenAI, может использовать эти переменные без изменений, хотя вам всё равно нужно установить имя модели на uncensored внутри инструмента. Если инструмент жестко задает модель, вам нужна собственная настройка или изменение кода.
Разделение двух эндпоинтов
Многие проекты тестируются на одном эндпоинте и работают на другом, или переключаются между ними через окружение. Держите три значения вне кода и считывайте их из конфигурации, чтобы переключение было изменением файла, а не редактированием кода.
import os
from openai import OpenAI
client = OpenAI(
base_url=os.environ.get("LLM_BASE_URL", "https://api.uncensoredgptapi.com/v1"),
api_key=os.environ["LLM_API_KEY"],
)
MODEL = os.environ.get("LLM_MODEL", "uncensored")Использование собственных имён переменных вместо значений по умолчанию SDK помогает избежать скрытой ловушки: инструмент, который читает OPENAI_API_KEY из оболочки, отправит тот ключ, который указан там, на любой базовый URL, указанный рядом. Если в вашем профиле есть старый ключ OpenAI, а в проекте — новый базовый URL, вы можете случайно отправить ключ одного сервиса другому. Разные имена переменных исключают такую ошибку, и вы сразу видите, какой эндпоинт будет использовать скрипт.
Относитесь к имени модели как к конфигурации. Это значение чаще всего забывают поменять при переключении, и оно вызывает самые запутанные сбои, так как всё остальное выглядит правильно.
Потоковая передача и инструменты используют тот же базовый URL
Изменение базового URL не ограничивает функции. Потоковая передача, вызов функций и JSON-режим проходят через тот же путь /chat/completions, поэтому код, работавший с оригинальным API, продолжает работать. Потоковая передача возвращает Server-Sent Events, с отчетом об использовании в конце потока.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY")
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Count from one to five."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
print()Проверка chunk.choices важна. Последний чанк, содержащий информацию об использовании, может не содержать вариантов ответа, и код, обращающийся к пустому списку, выдаст ошибку. Вызовы инструментов потоково передаются так же, как частичные дельта-значения tool_calls, которые вы собираете перед выполнением функции, а результаты возвращаются как сообщения с role: "tool". JSON-режим принимает response_format={"type": "json_object"}.
Приложения и фреймворки с полем базового URL
Многие приложения предлагают одну и ту же настройку под разными названиями: API base, endpoint, custom OpenAI URL или host. Правило не меняется. Вставьте базовый URL, включая /v1, вставьте ключ и укажите uncensored в качестве имени модели.
SillyTavern, например, позволяет добавить совместимый с OpenAI эндпоинт. Класс LangChain ChatOpenAI принимает аргумент base_url. Другие интерфейсы называют это поле URL прокси или обратным прокси. Имена полей различаются в зависимости от версии, поэтому ищите то, которое принимает URL, заканчивающийся на /v1.
Некоторые приложения запрашивают модель из выпадающего списка, который заполняется путем вызова GET /v1/models. Этот эндпоинт работает здесь и возвращает список моделей, поэтому выпадающий список должен показывать uncensored, когда URL и ключ правильные. Если он остается пустым, URL или ключ неверны.
Когда приложение предлагает как поле базового URL, так и поле «организация» или «проект», оставьте дополнительные поля пустыми. Они существуют для оригинального сервиса и ничего не значат здесь. Если приложение настаивает на ключе, начинающемся с определенного префикса, попробуйте другой тип подключения, например, общий или пользовательский вариант, совместимый с OpenAI, вместо предустановленного для оригинального сервиса.
Некоторые настольные инструменты проверяют соединение, запрашивая конкретное имя модели у оригинального провайдера, и сообщают об ошибке, даже если эндпоинт в порядке. В этом случае пропустите кнопку проверки и отправьте реальное сообщение. Если ответ пришел, URL, ключ и модель правильные, и инструмент просто строго проверяет соединение.
Инструменты на основе браузера также могут столкнуться с правилами кросс-доменных запросов, так как запрос покидает страницу для другого хоста. Если веб-инструмент не работает в браузере, но тот же запрос работает в curl, запустите запрос с небольшого собственного сервера, чтобы ключ оставался вне клиентского кода, что является более безопасным дизайном в любом случае.
Типичные ошибки и способы их исправления
Почти каждый сбой настройки происходит из короткого списка.
- Отсутствует /v1. Базовый URL — это
https://api.uncensoredgptapi.com/v1, весь адрес до/v1включительно, а не только имя хоста. Без/v1SDK формирует пути, которых не существует. - Дублирование пути. Если вы вставите
.../v1/chat/completionsв качестве базового URL, SDK добавит путь ещё раз. Указывайте только базовую часть. - Слеш в конце. Большинство SDK обрабатывают это, но некоторые инструменты — нет. Попробуйте без него.
- Устаревшее имя модели. Имя модели вроде
gpt-4o, оставшееся от исходного кода, не совпадёт. Установитеuncensored. - Неверный ключ. Используйте ключ от этого сервиса. Ключ OpenAI здесь не работает, а наш ключ не работает в OpenAI.
- Ошибки лимита запросов. HTTP 429 с кодом
rate_limitedозначает слишком много запросов в минуту; кодconcurrencyозначает слишком много одновременно. 429 с заголовкомRetry-After: 5указывает на временную перегрузку, поэтому подождите пять секунд и повторите запрос.
Наше руководство по устранению неполадок более подробно рассматривает ошибки интеграции.
Проверьте настройку одним вызовом
Прежде чем запускать всё приложение, вызовите эндпоинт моделей. Это дёшево и подтверждает URL и ключ вместе.
curl https://api.uncensoredgptapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"Если в ответе вы получите список, содержащий uncensored, отправьте реальный запрос на чат. Для полного ключа доступно до 8 параллельных запросов и 300 запросов в минуту; пробный ключ позволяет 2 параллельных и 60 в минуту. Каждый ответ включает X-Request-Id, X-Balance-USD и заголовки лимитов запросов, что полезно при отладке.
Чтобы получить ключ, зарегистрируйтесь и используйте страницу API-ключей, где новые пользователи могут получить пробный баланс $0,50 одним кликом. Документация описывает потоковую передачу, вызов инструментов и JSON-режим после установления соединения.
