GLM API key: как получить ключ для GLM 5.3 и какой URL указать

Для GLM 5.3 есть два пути: ключ на официальной платформе Z.ai или один ключ шлюза, который работает и с GLM, и с остальными моделями. Ниже по шагам: как получить GLM API key в обоих случаях, какой URL указывать в коде, какие id моделей использовать, сколько это стоит на примере и как расшифровать типичные ошибки.

Платформа Z.ai сверена с её документацией на 18 октября 2026. Цены Zukko даны на ту же дату: актуальные всегда в GET https://api.zukko.pro/v1/models или на странице «Модели» в кабинете.

GLM API Z.ai: ключ на официальной платформе

По документации Z.ai (раздел Quick Start) путь такой:

1. Зайдите на открытую платформу Z.ai, зарегистрируйтесь или войдите в аккаунт.
2. На странице Billing пополните баланс, если он нужен для выбранной модели.
3. На странице API Keys создайте ключ типа Standard API Key.
4. Скопируйте ключ и сохраните его в безопасном месте.

Отдельно у Z.ai есть подписка GLM Coding Plan для инструментов программирования, у которой, по документации, свой выделенный эндпоинт. Она настраивается по отдельной инструкции платформы, здесь мы её не разбираем.

Запрос к платформе, по примеру из документации:

curl -X POST "https://api.z.ai/api/paas/v4/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: en-US,en" \
  -H "Authorization: Bearer ВАШ_КЛЮЧ_ZAI" \
  -d '{"model": "glm-5.3", "messages": [{"role": "user", "content": "Привет! Представься."}]}'

Это ответ на запрос «glm api url»: у платформы Z.ai базовый адрес для OpenAI-совместимых клиентов https://api.z.ai/api/paas/v4/, а модель называется glm-5.3. Вы можете подключить и обычный openai SDK:

from openai import OpenAI

client = OpenAI(api_key="ВАШ_КЛЮЧ_ZAI", base_url="https://api.z.ai/api/paas/v4/")
r = client.chat.completions.create(
    model="glm-5.3",
    messages=[{"role": "user", "content": "Привет! Представься."}],
)
print(r.choices[0].message.content)

Условия доступа к платформе, способы пополнения и ограничения по странам определяет сама платформа. Раздел Payment Method и правила смотрите на её сайте.

GLM API key через шлюз Zukko

Второй путь — ключ Zukko. Он нужен один на все модели: GLM, Claude, GPT, Gemini, DeepSeek, Qwen. Баланс общий, в долларах, оплата за токены без подписки.

1. Откройте кабинет↗ и создайте ключ. Полный ключ fetch_... показывается один раз, сохраните его сразу.
2. Пополните баланс от $1.
3. Укажите в клиенте адрес https://api.zukko.pro/v1 и модель glm-5.3 или glm-5.3-flash.

curl https://api.zukko.pro/v1/chat/completions \
  -H "Authorization: Bearer fetch_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{"model": "glm-5.3-flash", "messages": [{"role": "user", "content": "Привет! Представься."}]}'

from openai import OpenAI

client = OpenAI(base_url="https://api.zukko.pro/v1", api_key="fetch_ваш_ключ")
r = client.chat.completions.create(
    model="glm-5.3",
    messages=[{"role": "user", "content": "Привет! Представься."}],
)
print(r.choices[0].message.content)

Доступ из России — через шлюз, оплата СБП (платёжная страница добавляет 8,5% сверху), картой MasterCard или криптой. Модели GLM можно вызывать и в формате Anthropic: POST https://api.zukko.pro/v1/messages. В Claude Code и в официальном Anthropic SDK адрес указывается без /v1: ANTHROPIC_BASE_URL=https://api.zukko.pro, ключ в ANTHROPIC_AUTH_TOKEN. Подробности — в инструкции по Claude Code↗.

Два адреса, которые не стоит путать

Ключ Z.ai не подходит к адресу Zukko и наоборот: получите 401.

Модели GLM и их параметры

Данные на 18 октября 2026. Цены Zukko — доллары за 1M токенов.

Кэш у GLM учитывается, если поставщик сообщает о нём в ответе; отдельной платы за запись нет. Индекс силы — Intelligence Index от Artificial Analysis, других цифр качества не приводим: проверьте модель на своих задачах.

Расчёт стоимости

Запрос с 500K токенов входа и 100K токенов выхода:

• glm-5.3 в Zukko: 0.5 × 0.1 + 0.1 × 0.1 = 0.05 + 0.01 = $0.06;
• glm-5.3 по официальным ценам: 0.5 × 1.4 + 0.1 × 4.4 = 0.70 + 0.44 = $1.14;
• glm-5.3-flash в Zukko: 0.5 × 0.04 + 0.1 × 0.04 = 0.02 + 0.004 = $0.024;
• glm-5.3-flash по официальным ценам: 0.5 × 0.15 + 0.1 × 0.5 = 0.075 + 0.05 = $0.125.

Официальные цены взяты из нашей таблицы и совпадают со страницей Pricing платформы Z.ai на дату проверки. У поставщика они могут измениться.

Free GLM API: что здесь правда

Запрос «free glm api» ищут часто. Мы бесплатный доступ не обещаем. Z.ai на странице Pricing на момент проверки помечала как Free некоторые модели прошлых версий (например, GLM-4.7-Flash и GLM-4.5-Flash) и отдельные позиции со словами Limited-time Free. Такие условия меняются, у них бывают лимиты, а актуальную 5.3 они не заменяют. Если нужно потратить копейки, возьмите glm-5.3-flash за $0.04 за 1M токенов: 100K токенов входа и столько же выхода обойдутся в 0.1 × 0.04 + 0.1 × 0.04 = $0.008.

Ошибки при подключении GLM

• 401: неверный ключ или перепутаны адреса из таблицы выше. Проверьте префикс fetch_ и пробелы.
• 402: на балансе Zukko не хватает денег. Пополните баланс.
• 403 model_not_allowed_for_key: у ключа в списке allowed_models нет нужной модели. Добавьте её в настройках ключа.
• 404 model_not_found: неверное имя. Берите id из GET /v1/models, например glm-5.3-flash (с дефисами и точкой в версии).
• 429: исчерпан дневной или месячный лимит ключа (key_daily_limit_reached) либо ограничение у поставщика модели.
• 413 или обрезанный контекст: у GLM окно 128K, а не 1M, как у большинства других моделей каталога.

Разбор остальных кодов — в статье 401, 402, model not found↗. Подробно про саму модель — GLM 5.3: подключение↗. Про заголовки и ключи: авторизация в API↗.

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

Какой base URL нужен для GLM?

Для платформы Z.ai: https://api.z.ai/api/paas/v4/. Для Zukko в OpenAI-клиентах: https://api.zukko.pro/v1. Для Claude Code и Anthropic SDK: https://api.zukko.pro без /v1.

Как называется модель в запросе?

glm-5.3 и glm-5.3-flash. Список актуальных id отдаёт GET /v1/models.

Можно ли один ключ использовать и для GLM, и для Claude?

В Zukko да: один ключ fetch_... и один баланс. Модель выбирается строкой model. Для разных проектов лучше завести отдельные ключи с дневным лимитом.

GLM понимает картинки?

В нашем каталоге у glm-5.3 и glm-5.3-flash вход с картинками не отмечен. Для задач с изображениями смотрите другие модели из таблицы, у которых картинки на вход поддерживаются.