GLM-5 API: ключ, Base URL и подключение через SDK (2026)

GLM-5 — новое поколение универсальных моделей линейки GLM от Zhipu. Команды обычно спрашивают о трёх вещах: где взять ключ, какой Base URL указывать и можно ли обойтись существующим OpenAI SDK. Ответ: линейка GLM давно предоставляет OpenAI-совместимый интерфейс, поэтому в большинстве случаев достаточно изменить три параметра — Base URL, ключ и имя модели.

Ниже — последовательность подключения: сначала о том, что представляет собой GLM-5 API, затем получение ключа и первый запрос, в конце — разбор ошибок и контроль расходов.

Примечание: Zhipu и GLM — товарные знаки их правообладателей; статья носит технический характер. Имена моделей, длина контекста и правила тарификации определяются официальной документацией и страницей цены на модели; имена моделей из примеров сверяйте в консоли перед использованием.

1. Что такое GLM-5 API

GLM-5 API — интерфейс вызова моделей, который открытая платформа Zhipu предоставляет разработчикам. Типичные возможности:

многоходовый диалог и следование инструкциям;
суммирование, переписывание и перевод длинных текстов;
структурированное извлечение и вывод JSON;
генерация и объяснение кода;
узлы рассуждения в агентах и рабочих процессах.

Это не то же самое, что веб-продукт: веб-версия работает по подписке аккаунта, API тарифицируется по токенам или объёму вызовов, а ключ — лишь учётные данные для вызова, а не членство. До подключения определите задачу, параллелизм и бюджет, затем решите, идти ли напрямую к поставщику или через агрегирующий шлюз.

2. Два пути получения ключа GLM API

Путь 1: открытая платформа Zhipu

Зарегистрируйтесь и войдите на открытой платформе Zhipu, пройдите верификацию личности или организации (по требованиям платформы).
Создайте API-ключ в консоли и назовите его по проекту или среде.
Проверьте баланс и доступные модели; при необходимости пополните счёт.
Сохраните ключ в переменную окружения на сервере, не выводите его во фронтенд.

Base URL официального интерфейса обычно https://open.bigmodel.cn/api/paas/v4; точное значение смотрите в актуальной официальной документации.

Путь 2: ZSQH AI Gateway

Если вы уже используете несколько моделей или хотите единый биллинг и управление ключами, зарегистрируйтесь в ZSQH AI Gateway, создайте ключ и на странице цены на модели уточните, открыта ли линейка GLM и как записывается имя модели.

У путей нет абсолютного превосходства: если нужна одна модель и официальный доступ стабилен, прямая схема проще; если нужны переключение моделей, единые лимиты и стабильный локальный вход, шлюз удобнее.

3. Конфигурация, совместимая с OpenAI

Интерфейс GLM близок к OpenAI Chat Completions, при миграции меняются три вещи:

Параметр	Прямое подключение	Шлюз ZSQH
Base URL	`https://open.bigmodel.cn/api/paas/v4`	`https://ai.zhongshangqihang.com/v1`
API Key	Создаётся на платформе Zhipu	Создаётся в консоли шлюза
Имя модели	По официальной документации	По странице цен на сайте
SDK	Подходит OpenAI SDK	Подходит OpenAI SDK

Обратите внимание на окончание Base URL: одни SDK сами добавляют /chat/completions, другим нужен полный путь. Смешивание официального адреса и адреса шлюза чаще всего проявляется как 401 или 404.

4. Вызов через curl

export ZSQH_API_KEY="sk-ваш-ключ"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $ZSQH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5",
    "messages": [
      {"role": "system", "content": "Ты технический редактор. Отвечай конкретно."},
      {"role": "user", "content": "Назови три признака, что команде нужен API-шлюз"}
    ],
    "temperature": 0.6,
    "max_tokens": 800
  }'

Замените model на фактический идентификатор GLM-5 со страницы цен. Если возвращается model not found, сначала проверьте регистр и суффикс версии.

5. Вызов из Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ZSQH_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="glm-5",  # сверьтесь со страницей цен
    messages=[
        {"role": "system", "content": "Ты помощник по контролю качества поддержки, выводи только JSON."},
        {"role": "user", "content": "Определи тональность: доставка слишком медленная, но поддержка вежливая."},
    ],
    temperature=0.2,
    response_format={"type": "json_object"},
)

print(resp.choices[0].message.content)

Если версия SDK старая, response_format может не поддерживаться — обновите пакет openai. Если шлюз не поддерживает JSON-режим, задайте формат в подсказке и предусмотрите разбор с запасным вариантом в коде.

6. Как выбрать имя модели

В линейке GLM обычно есть универсальная, облегчённая и рассуждающая ветки, а в именах присутствуют версия и суффикс даты. Рекомендации:

Задача	Подход к выбору	Что учесть
Поддержка, резюме, переписывание	Универсальная диалоговая модель	Начните с низкой temperature
Сложные рассуждения, математика	Усиленная рассуждающая модель	Медленнее, выше расход токенов
Классификация с высокой нагрузкой	Облегчённая модель	Сначала измерьте точность, затем масштабируйте
Работа с кодом	Версия с сильными навыками программирования	Следите за усечением длинного контекста

Какое имя доступно, какова длина контекста и цена — всё это смотрите на странице цен. Не копируйте старые имена моделей из сетевых руководств: версии GLM обновляются быстро.

7. Частые ошибки

Ошибка	Частая причина	Что делать
`401 Unauthorized`	Неверный ключ, нет Bearer, ключ удалён	Скопируйте ключ заново, проверьте заголовки
`404 Not Found`	В Base URL лишний или отсутствующий `/v1`	Приведите адрес к документации
`model not found`	Модель не существует или нет прав	Скопируйте имя со страницы цен
`429 Too Many Requests`	Превышен параллелизм или частота	Снизьте нагрузку, повторите с задержкой
`insufficient balance`	Недостаточно средств	Пополните счёт или смените ключ
Обрыв ответа	Тайм-аут, сеть, длинный вывод	Увеличьте тайм-аут, включите потоковый вывод

Порядок диагностики начинайте с аутентификации: сначала минимальным запросом проверьте ключ, затем имя модели, и только потом подозревайте сеть. Так вы не будете снова и снова править код в неверном направлении.

8. Контроль расходов

Задавайте max_tokens, чтобы модель не генерировала бесконечно.
Сокращайте system prompt; повторяющиеся длинные инструкции выносите в шаблон или кэш.
Пакетные задачи выполняйте облегчённой моделью, сложные — более крупной.
Записывайте расход токенов каждого запроса и разделяйте счёт по бизнес-линиям.
Устанавливайте лимит на ключ, чтобы аномальные вызовы автоматически останавливались.
Перед запуском проведите пиковую нагрузку и определите порог ограничения.

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

9. Безопасность и командная работа

Разделяйте ключи по средам: тест, предпроизводство и производство — отдельные, без повторного использования.
Разделяйте ключи по проектам: так проще считать токены и расход каждого направления.
Храните ключ в переменных окружения или менеджере секретов, не в Git и не во фронтенд-пакете.
Не печатайте в журналах полный ключ и исходный текст пользователя; при необходимости обезличивайте.
Настройте оповещения о расходе: при падении баланса ниже порога уведомляйте ответственного.
При смене сотрудников или утечке ключа немедленно отключайте и меняйте его.

Самый частый риск в команде — не сама модель, а ключ, скопированный в мессенджер, документ или фронтенд-код. Добавьте в процесс одно правило: «ключ существует только на сервере». Это проще, чем потом разбираться с последствиями.

Частые вопросы

Можно ли использовать GLM-5 API с OpenAI SDK?

В большинстве случаев да: достаточно изменить base_url, api_key и model. Отдельные параметры (некоторые переключатели рассуждения, мультимодальные поля) могут быть несовместимы; сверяйтесь с официальной документацией или документацией на сайте.

Ключ GLM API и подписка на веб-версию взаимозаменяемы?

Нет. Подписка на веб-версию — это продукт для пользователя, а API-ключ — учётные данные разработчика; биллинг и права управляются раздельно.

Можно ли одним ключом вызывать другие модели?

В ZSQH AI Gateway один ключ может вызывать несколько открытых моделей; модель указывается в запросе. Конкретный список смотрите на странице цен и в консоли.

Нужна ли дополнительная настройка для вызовов из Китая?

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

Что дальше

Зарегистрируйтесь в ZSQH AI Gateway, создайте тестовый ключ, проверьте минимальный запрос через curl и затем подключите его к рабочему коду. Имена моделей и цены смотрите на странице цены на модели.