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

API в стиле OpenAI с cURL и Bearer-токеном

Чтобы вызвать API в стиле OpenAI из командной строки, вы отправляете HTTP POST с заголовком Authorization, содержащим ваш токен. На этой странице приведены рабочие команды cURL для каждой функции API и проверки, которые нужно выполнить, если одна из них не сработала.

Обновлено

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

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

  • Токен размещается в заголовке Authorization: Bearer YOUR_KEY, а идентификатор модели — uncensored.
  • Существует два эндпоинта: GET /v1/models и POST /v1/chat/completions.
  • Добавьте -N и stream true, чтобы увидеть, как токены приходят через события, отправляемые сервером.
  • Прочитайте заголовки X-Balance-USD и лимитов запросов с помощью curl -i; код 429 означает, что нужно подождать и повторить запрос.

Минимальный запрос

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

export UF_KEY="paste-your-key-here"

curl https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Explain what a bearer token is in two sentences."}
    ]
  }'

Ответ — это JSON в формате завершения чата OpenAI. Текст ответа находится в поле choices[0].message.content, а объект usage сообщает о количестве токенов промпта и токенов завершения. Каждая часть команды выполняет свою задачу:

  • Authorization: Bearer ... содержит токен. "Bearer" — это имя схемы; тот, кто владеет токеном, считается его владельцем, поэтому вы держите его вдали от публичных репозиториев.
  • Content-Type: application/json сообщает серверу, как читать тело. Без него запрос часто завершается ошибкой разбора тела.
  • model должен быть uncensored, единственной моделью, которую обслуживает это API.
  • messages — это список объектов с полем role (system, user, assistant или tool) и content.

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

Проверьте ключ через GET /v1/models

Перед отладкой длинного запроса убедитесь, что токен работает, выполнив самый дешевый вызов. Получение списка моделей ничего не стоит и показывает, правильны ли URL, заголовок и ключ.

curl -s https://api.unfilteredaimodels.com/v1/models \
  -H "Authorization: Bearer $UF_KEY"

Хороший ответ — это список JSON, который включает uncensored. Если у вас установлен jq, пропустите вывод через конвейер, чтобы извлечь только идентификаторы:

curl -s https://api.unfilteredaimodels.com/v1/models \
  -H "Authorization: Bearer $UF_KEY" | jq -r '.data[].id'

Если ничего полезного не возвращается, пройдите по списку ниже по порядку, так как причины перечислены по частоте возникновения:

  1. Переменная пуста. Выполните echo "${UF_KEY:0:6}", чтобы увидеть первые символы, не печатая весь ключ.
  2. Заголовок написан с ошибкой или перед ключом отсутствует "Bearer".
  3. Типографские («умные») кавычки из документа или клиента чата заменили прямые кавычки в команде.
  4. Базовый URL неверен. Это https://api.unfilteredaimodels.com/v1, с api. в начале и /v1 в конце.
  5. Ключ был скопирован с пробелом или символом новой строки в конце.

Читайте заголовки ответа

Добавьте -i, чтобы включить заголовки в вывод, или -D -, чтобы вывести их, сохраняя тело чистым:

curl -s -D - -o /dev/null \
  https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"ping"}]}'

Стоит знать о четырех заголовках ответа:

ЗаголовокЧто значит
X-Request-IdИдентификатор этого запроса. Укажите его, если обратитесь в поддержку.
X-Balance-USDВаш оставшийся предоплаченный баланс.
X-RateLimit-Limit-RequestsКоличество запросов в минуту, разрешенных для вашего ключа.
X-RateLimit-Limit-ConcurrencyКоличество одновременных запросов, разрешенных для вашего ключа.

Лимиты составляют 300 запросов в минуту и 8 одновременных запросов для полного ключа, и 60 в минуту и 2 одновременных запроса для пробного ключа. Запрос выше устанавливает max_tokens в 5, чтобы тест был небольшим. В обычном использовании max_tokens необязателен, и завершение может использовать все, что осталось от 100 000-токенного окна после вашего промпта.

Потоковая передача из командной строки

Установите "stream": true и добавьте -N, чтобы curl не буферизовал вывод. Вы увидите строки, начинающиеся с data:, каждая из которых содержит небольшую JSON-дельту, и финальную строку data: [DONE]. Предыдущий чанк содержит данные об использовании токенов.

curl -N https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "stream": true,
    "messages": [{"role": "user", "content": "Write a four-line poem about a cron job."}]
  }'

Чтобы вывести только текст, отфильтруйте поток с помощью короткого конвейера:

curl -sN https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","stream":true,"messages":[{"role":"user","content":"Count to five."}]}' \
  | sed -u 's/^data: //' | grep -v '^\[DONE\]' | grep -v '^$' \
  | jq -rj '.choices[0].delta.content // empty'
echo

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

JSON-режим и вызовы инструментов

JSON-режим заставляет модель возвращать один действительный объект JSON. Укажите желаемую структуру в промпте, иначе ключи будут любыми, какие выберет модель.

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "response_format": {"type": "json_object"},
    "messages": [
      {"role": "user", "content": "Return JSON with keys city and country for the capital of Portugal."}
    ]
  }' | jq -r '.choices[0].message.content'

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

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "tool_choice": "auto",
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }],
    "messages": [{"role": "user", "content": "What is the weather in Lisbon?"}]
  }'

В ответе ищите choices[0].message.tool_calls[0].function.arguments. Это JSON-строка, которую нужно разобрать, передать в свою функцию погоды и вернуть в следующем запросе. Параметры, такие как temperature, top_p, stop, seed и штрафы, передаются как есть. документация содержит все поддерживаемые поля.

Храните токен в безопасности и поддерживайте аккуратность команд

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

История оболочки — самая частая утечка на личном компьютере. Ввод ключа напрямую в команду сохраняет его в файле истории. Установка его один раз с помощью export также сохраняет эту строку. Помогут две более аккуратные привычки. Читайте ключ из файла, который можете открыть только вы, или поставьте перед командой пробел, если ваша оболочка настроена игнорировать строки, начинающиеся с пробела. Небольшой файл отлично подходит:

mkdir -p ~/.config/uf
printf '%s' 'paste-your-key-here' > ~/.config/uf/key
chmod 600 ~/.config/uf/key

export UF_KEY="$(cat ~/.config/uf/key)"

Длинные JSON-тела трудно читать внутри одинарных кавычек, и цитирование ломается, как только сам промпт содержит апостроф. Поместите тело в файл и позвольте curl читать его с помощью -d @file:

cat > request.json <<'JSON'
{
  "model": "uncensored",
  "temperature": 0.3,
  "messages": [
    {"role": "system", "content": "You answer in plain language."},
    {"role": "user", "content": "What's the difference between a 401 and a 403 status code?"}
  ]
}
JSON

curl -s https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json | jq -r '.choices[0].message.content'

Тот же подход позволяет удерживать большие промпты в пределах лимита тела запроса 8 МБ, а файл можно версионировать в git, при этом ключ остаётся вне репозитория. В PowerShell на Windows одинарные кавычки вокруг JSON ведут себя иначе, а обратная косая черта для переноса строки отсутствует; вариант -d @request.json избегает обеих проблем, а для продолжения команды можно использовать обратную кавычку в конце строки.

Когда вы закончите тестирование, перейдите к SDK. Библиотеки OpenAI для Python и Node принимают тот же базовый URL и ключ, обрабатывают повторные попытки и потоковую передачу за вас, и читают тот же формат ответа, который вы парсили вручную здесь. Команды cURL остаются самым быстрым способом проверить, исходит ли сбой из вашего кода или из самого запроса, поэтому держите известную рабочую команду в своих заметках. Когда вы сообщаете о проблеме в поддержку, включайте X-Request-Id неудачного вызова и точный код статуса; эта пара позволяет кому-то найти запрос, не прося вас повторить тест, и экономит раунд обмена сообщениями.

Ошибки, повторные попытки и стоимость вызова

Когда вы превышаете лимит, API отвечает HTTP 429. Код ошибки указывает, какой лимит: rate_limited означает слишком много запросов в минуту, concurrency — слишком много одновременно. Временная перегрузка также возвращает 429 и добавляет Retry-After: 5. Curl может повторять запросы самостоятельно для временных ошибок:

curl --retry 3 --retry-delay 5 --retry-all-errors \
  https://api.unfilteredaimodels.com/v1/chat/completions \
  -H "Authorization: Bearer $UF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Hello"}]}'

Также держите тело в пределах 8 МБ, что важно, если вы отправляете файлы, закодированные в промпт.

Неудачные или отклоненные запросы не оплачиваются. Успешные рассчитываются по простой формуле: $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов. Тестовый вызов с 40 входными и 120 выходными токенами стоит 40 / 1 000 000 x $0,15 = $0,000006 плюс 120 / 1 000 000 x $0,50 = $0,00006, итого $0,000066. Тысяча таких вызовов обойдется в $0,066.

Кредит предоплаченный и никогда не истекает. Пополнения от $20 до $500 целыми суммами, с бонусом 5% от $50, 10% от $100 и 15% от $200, криптовалютой (USDT на TRC20, USDC на Base). На странице цен показаны детали. Если ответ выглядит неверным, страница мифов и фактов объясняет, что модель делает и не делает.

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

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

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

Куда вставить токен в команде cURL?
    В заголовке: -H "Authorization: Bearer YOUR_KEY". Тело запроса также требует заголовка Content-Type: application/json.
Какое имя модели использовать?
    Используйте uncensored. Вы можете подтвердить это через GET /v1/models.
Почему я получаю 429?
    Вы превысили лимит. Код rate_limited означает слишком много запросов в минуту, concurrency — слишком много одновременно. Подождите несколько секунд или уменьшите количество параллельных запросов.
Как посмотреть оставшийся баланс?
    Каждый ответ включает заголовок X-Balance-USD. Выведите заголовки с помощью curl -i или curl -D -.
Это официальный API OpenAI?
    Нет. Это независимый OpenAI-совместимый сервис, работающий на одной модели с открытыми весами, поэтому SDK и команды cURL, созданные для формата OpenAI, работают после изменения базового URL и ключа.