Первый запрос к API Liho LLM

Аккаунт, ключ и первый ответ модели. API работает в формате OpenAI Chat Completions, поэтому подойдут curl и официальный OpenAI SDK для Python или TypeScript — достаточно поменять адрес и ключ.

Что понадобится

  • Аккаунт Liho LLM с положительным рублёвым балансом.
  • curl, Python 3 с пакетом openai или Node.js с пакетом openai.

Шаги

  1. Зарегистрируйтесь

    Откройте страницу регистрации Liho LLM и нажмите «Создать аккаунт». Нужны email, имя и пароль не короче 12 символов.

    Регистрация в Liho LLM
  2. Пополните баланс

    В кабинете откройте раздел «Баланс и платежи» и пополните баланс в рублях. Перед каждым запросом сервис резервирует его максимально возможную стоимость, а после ответа списывает фактическую. Если доступных средств не хватает на резерв, запрос вернёт ошибку 402.

  3. Создайте API-ключ

    Раздел «API-ключи» → «Создать ключ». Задайте имя ключа и, если нужно, лимит расходов и срок действия. Ключ начинается с lh_ и показывается один раз: скопируйте его, затем нажмите «Я сохранил ключ». Сохраните ключ в переменной окружения, а не в коде.

    shell
    export LIHO_API_KEY="lh_…"
  4. Отправьте запрос

    Запрос отправляется на https://llm.liho.dev/v1/chat/completions. Поля model, messages и max_tokens обязательны: max_tokens ограничивает длину ответа и задаёт резерв стоимости. У моделей с рассуждением токены рассуждения входят в этот лимит, поэтому закладывайте запас. В OpenAI SDK меняются только base_url и ключ.

    shell
    curl https://llm.liho.dev/v1/chat/completions \
      -H "Authorization: Bearer $LIHO_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gpt-6-sol",
        "max_tokens": 512,
        "messages": [
          {"role": "user", "content": "Объясни в двух предложениях, что такое API-шлюз."}
        ]
      }'
  5. Проверьте стоимость

    В ответе поле usage содержит число токенов и cost — списанную сумму в рублях. Тот же запрос появится в разделе «Логи» кабинета: модель, ключ, токены, стоимость и время ответа.

    Если списание ещё не окончательное, поля cost в ответе не будет — итоговая сумма появится в «Логах».

  6. Включите потоковый ответ

    С "stream": true ответ приходит частями в формате SSE и заканчивается строкой data: [DONE]. Последний фрагмент перед ней содержит usage со стоимостью. Ответ может занимать до 15 минут — ставьте таймаут клиента не меньше 900 секунд.

    shell
    curl -N https://llm.liho.dev/v1/chat/completions \
      -H "Authorization: Bearer $LIHO_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gemini-3.8-flash",
        "max_tokens": 512,
        "stream": true,
        "messages": [
          {"role": "user", "content": "Объясни в двух предложениях, что такое API-шлюз."}
        ]
      }'
  7. Выберите модель

    Идентификаторы моделей и цены за 1 млн токенов — в каталоге. Модель меняется одним полем model. Набор поддерживаемых параметров у моделей разный: он указан в карточке модели.

    Каталог моделей

Что получится

  • Рабочий ключ lh_… и проверенный запрос к API.
  • Стоимость каждого запроса в рублях — в ответе и в разделе «Логи».
  • Шаблон запроса для curl, Python или TypeScript, который можно перенести в своё приложение.

Ограничения

  • Поддерживается только POST /v1/chat/completions. Нет Responses API, эмбеддингов, генерации изображений и аудио.
  • Без max_tokens (или max_completion_tokens) запрос вернёт ошибку 400.
  • Протокол Anthropic (/v1/messages) не поддерживается.
  • Структурированный вывод (response_format) и stop сейчас не включены ни для одной модели каталога.
  • Документация в кабинете открывается после входа. Без входа доступны openapi.yaml и llms.txt.
  • Ключ показывается только при создании. Если он потерян, отзовите его и создайте новый.