RU ▾
Получить API-ключ
API без цензуры, совместимый с OpenAI, для разработчиков.Обновлено

Примеры curl для LLM API, которые можно скопировать и запустить

Если вы хотите протестировать LLM API через curl перед написанием кода, приведённые ниже запросы вполне подойдут. Каждый из них обращается к эндпоинту, совместимому с OpenAI, использует идентификатор модели uncensored и выполняется в обычном терминале.

Терминальная панель, посылающая луч света кубу сервера, символизирующая curl-запрос к LLM API

Настройте оболочку и проверьте эндпоинт

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

export API_KEY="paste-your-key-here"
export BASE="https://api.uncensoredllmapi.com/v1"

Каждый запрос отправляет ключ в виде Bearer-токена в заголовке Authorization. Тела запросов имеют формат JSON, поэтому при отправке POST добавьте Content-Type: application/json. Максимальный размер тела — 8 МБ, что важно только при вставке очень больших документов в промпт.

В примерах используются одинарные кавычки оболочки Unix. В PowerShell на Windows поместите JSON в файл и передайте его с помощью --data @body.json, чтобы избежать проблем с экранированием.

Самая простая проверка — GET-запрос, возвращающий список моделей. Он подтверждает работоспособность ключа и URL и ничего не стоит.

curl -s "$BASE/models" \
  -H "Authorization: Bearer $API_KEY"

Массив data в ответе должен содержать идентификатор uncensored. Код 401 означает, что ключ отсутствует или введён неверно. Если curl вообще не может подключиться, проверьте хост в $BASE и убедитесь, что он заканчивается на /v1 без дополнительных путей.

1. Отправьте запрос chat completion

Это запрос, который отправляет каждый клиент в стиле OpenAI под капотом.

curl -s "https://api.uncensoredllmapi.com/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Give me three names for a fantasy tavern."}
    ],
    "temperature": 0.8,
    "max_tokens": 200
  }'

Ответ — это JSON. Текст находится в поле choices[0].message.content, а данные об использовании токенов — в поле usage. Если у вас установлен jq и вам нужен только текст, пропустите вывод через jq -r '.choices[0].message.content'. Поле max_tokens необязательно; если его не указать, завершение может использовать оставшийся объём в контекстном окне на 100 000 токенов.

Также доступен новый эндпоинт POST /v1/responses, если ваш клиент использует такой формат. Полный список параметров см. в документации.

2. Потоковая передача ответа

Добавьте "stream": true и укажите curl не буферизовать вывод с помощью флага -N. Токены будут выводиться по мере генерации.

curl -N "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "stream": true,
    "messages": [{"role": "user", "content": "Count from one to ten in words."}]
  }'

Каждая строка начинается с data: и содержит небольшой фрагмент JSON с полем delta. Последние события содержат данные об использовании, а поток завершается строкой data: [DONE]. Без флага -N curl ожидает заполнения буфера, и вывод кажется единым блоком. Обратите внимание, что потоковый запрос удерживает один слот параллелизма занятым до завершения.

3. Запросите JSON

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

curl -s "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "response_format": {"type": "json_object"},
    "messages": [{"role": "user",
      "content": "Return JSON with keys name and level for a fantasy character."}]
  }' | jq -r '.choices[0].message.content | fromjson'

Финальный фильтр fromjson парсит строку внутри поля content, поэтому jq выдаст ошибку, если модель вернёт невалидный JSON. Это удобный быстрый тест. Дополнительные примеры см. на странице JSON-режим.

4. Попробуйте вызов инструмента

Вызов функций позволяет модели попросить ваш код выполнить функцию. Вы описываете функции в массиве tools, и если модель решит их использовать, в ответе будет запись tool_calls вместо текста.

curl -s "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the weather in Oslo?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get current weather for a city",
        "parameters": {
          "type": "object",
          "properties": {"city": {"type": "string"}},
          "required": ["city"]
        }
      }
    }],
    "tool_choice": "auto"
  }' | jq '.choices[0].message.tool_calls'

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

5. Проверка заголовков и баланса

Добавьте флаг -i, чтобы увидеть заголовки ответа вместе с телом. Вы найдёте заголовки X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests и X-RateLimit-Limit-Concurrency.

curl -s -i "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":5}' \
  | grep -i "^x-"

curl -s "$BASE/balance" -H "Authorization: Bearer $API_KEY"

Второй запрос возвращает ваш баланс напрямую. Инструменты в стиле OpenAI могут использовать вместо этого GET /v1/dashboard/billing/credit_grants. Небольшой запрос, подобный приведённому выше, стоит дробную часть цента: при 10 входных токенах и 5 выходных цена составляет 10 x 0,15 / 1 000 000 + 5 x 0,50 / 1 000 000 = $0,000004. См. страницу с ценами для тарифов.

Многоразовый скрипт для smoke-теста

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

set -euo pipefail
BASE="https://api.uncensoredllmapi.com/v1"

echo "models:"
curl -sf "$BASE/models" -H "Authorization: Bearer $API_KEY" | jq -r '.data[].id'

echo "chat:"
curl -sf "$BASE/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say ok."}],"max_tokens":5}' \
  | jq -r '.choices[0].message.content'

echo "balance:"
curl -sf "$BASE/balance" -H "Authorization: Bearer $API_KEY"

Флаг -f заставляет curl завершаться с ошибкой при сбое HTTP, а конструкция set -e останавливает скрипт в этой точке. Поместите его в cron или шаг CI, если вы запускаете сервис поверх этого API и хотите получать раннее предупреждение об изменениях. Храните ключ в хранилище секретов или переменной окружения, но не в файле скрипта.

При изменении запроса меняйте по одному параметру за раз: temperature для случайности, top_p для выборки по ядру, stop для пользовательских последовательностей завершения и seed для воспроизводимого вывода. Все они передаются модели, поэтому вы можете сравнить их влияние по истории терминала.

Чтение ошибок из curl

СтатусВероятная причинаИсправление
401Отсутствующий или неверный ключПроверьте заголовок Authorization и убедитесь, что переменная $API_KEY экспортирована
400Некорректный JSON или неверное полеПроверьте тело запроса с помощью jq . перед отправкой
429, код rate_limitedБолее 300 запросов в минуту (60 на пробном ключе)Уменьшите скорость цикла
429, код concurrencyБольше 8 запросов одновременно (2 для пробного ключа)Запустите меньше параллельных задач
429 с Retry-After: 5Временная перегрузкаПодождите 5 секунд и повторите попытку

Добавьте -w "\n%{http_code}\n", чтобы вывести код состояния после тела ответа — это избавит вас от необходимости угадывать. Тела ошибок содержат JSON с сообщением и кодом, поэтому jq .error выводит их в удобном виде. Если в цикле вы видите 429, не пытайтесь выполнить запрос сразу; небольшая пауза в несколько секунд позволяет обновиться минутному окну и освободить слоты параллельных запросов, а быстрый цикл повторных попыток лишь удерживает вас выше лимита. Пробный ключ имеет более строгие ограничения, чем полный ключ, поэтому скрипт, который работает после первого пополнения, может дать сбой при использовании пробного ключа, если он запускает задания параллельно. Как только запросы начнут работать стабильно, переходите к SDK; тот же URL и имя модели переносятся без изменений. Новые аккаунты могут получить $0,50 пробного кредита в один клик — этого хватит на сотни небольших тестовых вызовов. Пополнения после этого начинаются от $20 и оплачиваются криптовалютой (USDT в сети TRC20 или USDC в сети Base).

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

На какой URL отправлять curl-запросы?

Используйте https://api.uncensoredllmapi.com/v1 как базовый URL, затем добавьте /chat/completions, /responses, /models или /balance в зависимости от того, что вам нужно.

Как протестировать вызов инструментов через curl?

Добавьте массив tools с определением функции в тело запроса chat completion. Если модель решит вызвать её, в ответе появится tool_calls, и вы отправите результат обратно как сообщение с role tool.

Почему curl ничего не показывает до завершения ответа?

Вероятно, вы используете потоковую передачу без флага -N. Добавьте -N, чтобы curl выводил каждый фрагмент по мере его поступления.

Стоит ли денег неудачный запрос?

Нет. За неудачные или отклонённые запросы плата не взимается.

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

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