RU ▾

Базовый URL GPT API: как настроить для любого клиента OpenAI

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

Обновлено

Указатель, перенаправляющий пакеты данных с одного сервера на другой, иллюстрирующий изменение базового URL

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

  • Наш базовый 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 включительно, а не только имя хоста. Без /v1 SDK формирует пути, которых не существует.
  • Дублирование пути. Если вы вставите .../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-режим после установления соединения.

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

Какой базовый URL у вашего API?

Это https://api.uncensoredgptapi.com/v1. Включите часть /v1 и уберите путь к эндпоинту.

Какое имя модели я должен использовать?

Используйте uncensored. Имена моделей от других провайдеров, таких как gpt-4o, здесь недоступны.

Можно ли использовать существующий код OpenAI SDK?

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

Работает ли переменная OPENAI_BASE_URL?

Официальные SDK OpenAI используют её, когда базовый URL не передан в коде, поэтому её установка часто бывает достаточной. Проверьте инструмент, который вы используете, так как некоторые его игнорируют.

Почему я получаю ошибку 429?

Код rate_limited означает слишком много запросов в минуту, а код concurrency — слишком много одновременно. 429 с заголовком Retry-After: 5 означает временную перегрузку, поэтому повторите запрос через пять секунд.

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

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

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