Альтернатива OpenAI для разработчиков: настройка API-ключа и SDK
Готовая замена OpenAI API без цензуры
Альтернатива OpenAI для разработчиков должна занимать у вас не более полудня, а не переписывание кода. Эта альтернатива работает со стандартными SDK OpenAI: вы меняете базовый URL, вставляете новый ключ и вызываете модель uncensored.

Ключевые моменты
- Зарегистрируйтесь, заберите $0,50 пробного баланса на странице API-ключа и скопируйте ключ. Для пробного периода карта не нужна.
- Установите base_url на https://api.openaiapialternative.com/v1 и model на uncensored в любой SDK OpenAI.
- Потоковая передача, вызов инструментов и JSON-режим следуют формату OpenAI. Лимиты: 8 параллельных запросов и 300 в минуту для полного ключа.
- Обрабатывайте HTTP 429 с короткой задержкой и учитывайте заголовок Retry-After.
Пять шагов от нуля до рабочего вызова
Если вы хотите протестировать альтернативу OpenAI для разработчиков уже сегодня, это весь путь. Это займёт около десяти минут.
- Создайте аккаунт через Google или с помощью электронной почты и пароля.
- Откройте страницу API-ключа и нажмите кнопку для получения пробного баланса. Вы получите $0,50, действительные 7 дней, один на человека, без карты.
- Скопируйте ключ. Относитесь к нему как к паролю и не храните его в git.
- Установите базовый URL на
https://api.openaiapialternative.com/v1в вашем SDK или клиенте. - Отправьте запрос с моделью, установленной на
uncensored.
Всё остальное, включая формат сообщений, потоковую передачу и вызовы инструментов, такое же, как в формате завершения чата OpenAI, который вы уже используете. Сервис предоставляет POST /v1/chat/completions и GET /v1/models. Ничего лишнего, поэтому изучать почти нечего.
Python с официальным SDK
Установите пакет с помощью pip install openai. Клиент принимает базовый URL и ключ в качестве аргументов конструктора, поэтому глобальное состояние не затрагивается, и вы можете держать второй клиент для другого провайдера в том же процессе.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.openaiapialternative.com/v1",
api_key=os.environ["UNCENSORED_API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "Answer briefly and directly."},
{"role": "user", "content": "List three edge cases for a date parser."},
],
max_tokens=300,
)
print(resp.choices[0].message.content)
print(resp.usage)max_tokens — необязательный параметр. Если его не указать, модель может использовать всё оставшееся пространство в окне в 100 000 токенов, поэтому установите лимит, если хотите предсказуемую стоимость.
Модели для чата не хранят историю самостоятельно. Каждый запрос должен содержать историю, которую вы хотите показать модели, поэтому многотуровый ассистент — это просто список, к которому вы постоянно добавляете данные:
from openai import OpenAI
client = OpenAI(base_url="https://api.openaiapialternative.com/v1", api_key="YOUR_KEY")
history = [{"role": "system", "content": "You are a patient pair-programming partner."}]
while True:
user = input("you> ")
if not user:
break
history.append({"role": "user", "content": user})
r = client.chat.completions.create(model="uncensored", messages=history)
answer = r.choices[0].message.content
history.append({"role": "assistant", "content": answer})
print(answer)Количество входных токенов растёт с каждым шагом, так как весь список отправляется каждый раз. При окне в 100 000 токенов у вас много места, но вы платите за историю при каждом вызове, поэтому удаляйте старые реплики или сжимайте их в краткое резюме, когда список станет большим.
Node и curl
Node SDK следует тому же шаблону. Установите с помощью npm install openai и передайте baseURL.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.openaiapialternative.com/v1",
apiKey: process.env.UNCENSORED_API_KEY,
});
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a haiku about stack traces." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}Для быстрой проверки из терминала выведите список моделей. Вы должны увидеть одну запись с идентификатором uncensored.
# expect one entry with id "uncensored"
curl https://api.openaiapialternative.com/v1/models \
-H "Authorization: Bearer $UNCENSORED_API_KEY"Потоковый запрос занимает один из ваших слотов параллельности до конца потока, что важно, если клиент прерывает поток без закрытия. Закрывайте соединение на своей стороне, когда пользователь уходит со страницы.
Редакторы, агенты и другие клиенты
Многие инструменты позволяют переопределить базовый URL OpenAI. В редакторах вроде Cursor есть экран настроек модели, где можно ввести пользовательский базовый URL, совместимый с OpenAI, и ключ, а в интерфейсах чата вроде SillyTavern можно добавить пользовательский эндпоинт, совместимый с OpenAI. Названия и расположение пунктов меню меняются в разных версиях, поэтому ищите поле с названием вроде «Переопределить базовый URL OpenAI» или «Пользовательский эндпоинт».
Какой бы инструмент вы ни использовали, вам нужны те же три значения:
| Поле | Значение |
|---|---|
| Базовый URL | https://api.openaiapialternative.com/v1 |
| API-ключ | ключ из вашего аккаунта |
| Имя модели | uncensored |
Если инструмент требует список известных имён моделей, добавьте uncensored как пользовательскую модель. Если он автоматически добавляет /v1, укажите адрес без суффикса, иначе вы получите удвоенный путь и ошибку 404.
Вызов инструментов и JSON-режим
Структурированный вывод — это то место, где обычно возникают проблемы, поэтому протестируйте его заранее. Обе функции используют формат OpenAI. Для JSON-режима установите response_format и упомяните JSON в промпте.
import json
from openai import OpenAI
client = OpenAI(base_url="https://api.openaiapialternative.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
response_format={"type": "json_object"},
messages=[
{"role": "system", "content": "Reply with a JSON object with keys title and tags."},
{"role": "user", "content": "Describe a short story about a lost lighthouse keeper."},
],
)
data = json.loads(resp.choices[0].message.content)
print(data["title"], data["tags"])Для инструментов передайте список tools со схемами функций, прочитайте tool_calls из ответа, выполните функцию самостоятельно и отправьте результат обратно как сообщение с role: "tool". Потоковые ответы доставляют tool_calls частями, поэтому накапливайте строку аргументов перед парсингом.
Модели всё ещё могут иногда возвращать некорректный JSON, независимо от провайдера. Оберните парсинг в блок try и повторите попытку один раз, добавив сообщение об ошибке в историю сообщений.
Значения seed также передаются, поэтому установка seed с фиксированной температурой даёт вам способ сравнить изменения промпта на тех же входных данных. Не ожидайте байтово идентичного вывода при каждом запуске, но различия значительно сокращаются.
Лимиты, обработка 429 и контроль затрат
Полный ключ позволяет 8 параллельных запросов и 300 запросов в минуту. Пробный ключ позволяет 2 и 60. Тело запроса может быть до 8 МБ. Каждый ответ содержит X-RateLimit-Limit-Requests и X-RateLimit-Limit-Concurrency, а также X-Balance-USD для вашего оставшегося баланса.
Превышение лимитов возвращает HTTP 429. Код ошибки указывает, какой именно лимит превышен: rate_limited означает слишком много запросов в минуту, а concurrency — слишком много запросов одновременно. Временная перегрузка также возвращает 429 с заголовком Retry-After: 5. SDK OpenAI по умолчанию повторяют запросы с кодом 429 с экспоненциальной задержкой, а количество попыток можно увеличить с помощью параметра max_retries на клиенте. Для пакетных задач семафор на 8 потоков не позволит превысить лимит параллельности.
Для расчёта бюджета ориентируйтесь на цену: $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов. Задача, отправляющая 4 млн входных токенов и получающая 1 млн выходных токенов, стоит 4 × $0,15 + 1 × $0,50 = $1,10. Неудачные или отклонённые запросы не оплачиваются. На странице тарифов указаны размеры пополнения и бонусы.
Короткая обёртка для повторных попыток достаточна, если вы не используете SDK, который повторяет запросы за вас. Читайте Retry-After, если он присутствует, иначе используйте экспоненциальную задержку и прекратите попытки после нескольких неудач. Не повторяйте запросы при ошибках, не являющихся 429 или ошибкой сервера, так как некорректный запрос будет падать одинаково каждый раз.
Ошибки, которые стоят часа работы в первый день
Большинство неудачных первых вызовов происходят из короткого списка причин. Проверьте их, прежде чем подозревать сервис.
- Удвоенный путь. Базовый URL уже заканчивается на
/v1. Не добавляйте ещё один и не вызывайте/chat/completionsбез него. - Неправильное имя модели. Старый код часто содержит имя модели вендора. Замените его на
uncensored, иначе вызов ничего не найдёт. - Ключ с пробелами. Ключи, скопированные с веб-страницы или терминала, часто содержат завершающий символ новой строки. Удалите его.
- Тестирование ключа пробного периода с продакшен-уровнем параллельности. Ключ пробного периода позволяет 2 параллельных запроса и 60 запросов в минуту, поэтому нагрузочное тестирование с 20 потоками почти сразу вернёт 429 с кодом
concurrency. - Ожидание других эндпоинтов. Запросы на генерацию изображений, аудио и эмбеддингов не входят в сервис.
Вторая категория — поведение, а не конфигурация. Модель без отказов будет более буквально следовать странным инструкциям, чем вы ожидаете. Если ответ уходит не туда, куда вы хотели, ужесточите системный промпт, а не температуру. Если выходные данные повторяются, немного повысьте temperature или добавьте штраф за частоту, оба параметра передаются.
Последняя привычка, которую стоит принять рано: сохраняйте точное тело запроса каждого вызова, который вас удивил. Когда вы запросите помощь у команды на странице поддержки, идентификатор запроса плюс это тело — это полный отчёт об ошибке.
Перед запуском
- Храните ключ на сервере. Никогда не передавайте его в бандле для браузера или в мобильном приложении.
- Ведите логи заголовка
X-Request-Idпри каждом вызове. Это позволяет службе поддержки ответить на вопрос. - Добавьте собственную фильтрацию входных и выходных данных, если конечные пользователи могут вводить текст свободно. Модель не будет отказывать, поэтому модерация — ваша задача.
- Держите запасного провайдера в конфигурации. Переключение — это изменение базового URL, поэтому достаточно флага функции.
- Помните о сфере применения: только текст, нет эмбеддингов, нет изображений, нет дообучения.
В документации есть полный список параметров. Если что-то ведёт себя странно, на странице поддержки указано, как связаться с командой.
Дополнительные руководства
Вопросы и ответы
Какие SDK работают?
Любой SDK или клиент OpenAI, позволяющий задать базовый URL и ключ. Официальные библиотеки Python и Node.js работают, как и прямые HTTP-запросы с помощью curl.
Нужна ли карта, чтобы попробовать?
Нет. Пробный баланс $0,50 забирается одним кликом на странице API-ключа после входа и не требует карты. Он действителен 7 дней, один на человека.
Какое имя модели?
Идентификатор модели — uncensored. Выполните GET /v1/models, чтобы подтвердить это с помощью вашего ключа.
Каков максимальный размер запроса?
Контекстное окно составляет 100 000 токенов для суммы промпта и ответа, а максимальный размер тела запроса — 8 МБ.
Ваш ключ — в одном шаге от вас
Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.