Содержание
Как получить API ключ Z.ai
Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.
Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 13 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.
Как получить API ключ Z.ai: зарегистрируйтесь на платформе Z.AI Open Platform, при необходимости пополните баланс в разделе Billing, создайте ключ на странице управления API Keys и скопируйте его для использования. Документация Z.ai описывает этот путь как основной. Ключ нужен для программного доступа к моделям GLM, и он отличается от подписки на чат и от плана для кода. Мы скачали подборку результатов веб-поиска по запросу «Как получить API ключ Z.ai»: текст отдали 5 из 10.
Ключ и первый запрос по документации Z.ai
Quickstart Z.ai задаёт маршрут: зарегистрироваться или войти в Z.AI Open Platform, при необходимости пополнить Billing, создать ключ в API Keys и скопировать его. Для текстового примера используется glm-5.3 и POST на https://api.z.ai/api/paas/v4/chat/completions. Сохраняйте выбранную модель рядом с файлом запроса.
В API Reference указан базовый адрес https://api.z.ai/api/paas/v4 и заголовок Authorization: Bearer ZAI_API_KEY. Для GLM Coding Plan предусмотрен выделенный endpoint. Там же описано расходование API usage bundle: после пакета вызовы переходят на оплату по потреблению. Перед тестом проверьте допустимый расход в Billing.
Конкретный вход проверяйте в своём аккаунте. Редакция API не вызывала. Для упражнения подготовьте собственную папку, переменную окружения с секретом и обезличенный текст. Запишите ожидаемый результат до отправки. Для учебного запроса используйте подготовленный файл и собственную карточку подключения.
Учебный пример и критерии самостоятельной проверки
Соберём учебный сценарий, который читатель проходит сам. Задача: отправить один запрос к модели через API и убедиться, что ключ работает. Никаких результатов заранее не обещаем — их даст ваш собственный прогон.
Шаг первый — подготовка окружения. Сохраните ключ в переменную окружения, например ZAI_API_KEY. В коде обращайтесь к переменной. Это базовая гигиена: при смене ключа правится одно место.
Шаг второй — запрос. Адрес берётся из документации: https://api.z.ai/api/paas/v4/chat/completions. Метод — POST. Заголовок авторизации — Bearer с вашим ключом. В теле — имя модели и сообщение.
Шаг третий — разбор ответа. Успех — это структурированный ответ с текстом модели. Ошибка авторизации указывает на ключ или заголовок. Ошибка адреса — на неверный endpoint. Ошибка модели — на имя в теле запроса.
Критерии самостоятельной проверки, по которым вы сами оцениваете результат:
- ключ создан и виден в списке на странице управления;
- запрос уходит на адрес из документации;
- заголовок авторизации собран по схеме Bearer;
- имя модели в теле совпадает с тем, что вы намерены вызвать;
- ключ не хранится в коде и не попал в систему контроля версий.
Промпт для разбора ответа API, когда нужно быстро понять причину сбоя:
Ты помогаешь разобрать ответ API Z.ai. Вот что вернул сервер: [вставьте код и текст ответа]. Вот как выглядел мой запрос: [метод, адрес, заголовки без ключа, тело]. Объясни кратко, что означает этот ответ, на каком шаге цепочки «ключ — адрес — модель» вероятнее всего расхождение и что проверить первым. Не предлагай менять то, что уже совпадает с документацией.
Вариации той же задачи под другие ситуации:
- проверка ключа после смены: тот же разбор, но с акцентом на заголовок авторизации;
- переход на выделенный endpoint Coding Plan: разбор расхождения между общим адресом и адресом плана;
- смена модели в запросе: разбор ошибки имени модели;
- перенос ключа в переменную окружения: разбор мест, где ключ мог остаться в коде;
- подготовка короткой инструкции для коллеги: тот же разбор в формате памятки.
Смежные варианты подключения и выбор по задаче
У платформы несколько путей подключения, и выбор зависит от того, что вы собираете. В документации ZCode перечислены: GLM Coding Plan (BigModel), Z.ai Coding Plan, подключение через API Key, Anthropic (Claude API), OpenRouter, Moonshot, OpenAI. Это не альтернативы одного уровня — у каждого свой сценарий.
| Вариант | Для чего подходит | Что нужно |
|---|---|---|
| API Key Z.ai | Свои скрипты и сервисы | Ключ и endpoint из документации |
| GLM Coding Plan | Работа в инструменте для кода | Настройка выделенного endpoint |
| Z.ai Coding Plan | Подписка внутри ZCode | Учётная запись и выбранный план |
| Anthropic (Claude API) | Совместимый интерфейс | Ключ соответствующего провайдера |
| OpenRouter | Единая точка к нескольким моделям | Ключ OpenRouter |
| Moonshot, OpenAI | Свои модели и интерфейсы | Ключи этих провайдеров |
Логика выбора простая. Свой код и автоматизация — API Key Z.ai. Работа внутри инструмента для программирования — Coding Plan. Нужен один интерфейс к разным моделям — агрегатор вроде OpenRouter. Документация ZCode описывает эти пути как равноправные способы подключения, и переключение между ними не требует пересборки проекта.
Отдельно про BigModel и Z.ai. В документации ZCode они разведены по аудитории: BigModel — для пользователей в Китае, Z.ai — для пользователей за пределами Китая. У каждого свой API endpoint. Если вы создали ключ в одной панели, используйте адрес этой же панели.
Для локальных сценариев, где модель запускается на своём железе, пригодится другой материал: Qwen GGUF: локальный чат через Ollama и LM Studio. Это смежный путь — модель работает без внешнего API.
Типичные проблемы и проверяемые способы диагностики
Для разбора отказа последовательно проверьте окружение, заголовок, адрес и имя модели. Сохраните код и текст ответа, удалив секреты из записи.
Ключ не создаётся. Вернитесь на страницу управления API Keys и проверьте, что вы вошли в нужную панель. Если баланс не пополнен, документация предлагает сначала пройти на страницу Billing.
Запрос возвращает ошибку авторизации. Проверьте заголовок: документация Z.ai требует стандартный HTTP Bearer, строка выглядит как Authorization: Bearer ZAI_API_KEY. Сверьте фактический заголовок с документированной формой.
Запрос уходит не туда. Сверьте адрес с документацией. Общий endpoint — https://api.z.ai/api/paas/v4. Для GLM Coding Plan документация описывает отдельный порядок настройки выделенного endpoint.
Модель не отвечает. Проверьте имя модели в теле запроса. В примере документации Z.ai указано glm-5.3. Имя чувствительно к опечаткам.
Ключ утёк. Если секрет попал в публичный репозиторий, отзовите его на странице управления и создайте новый. Храните ключ в переменной окружения.
Порядок диагностики держите фиксированным: ключ, заголовок, адрес, модель. Каждый следующий шаг проверяется только после того, как предыдущий совпал с документацией. Так вы не будете менять работающие части.
Копируемый первый запрос
Ниже редакционная сборка по HTTP-форме Z.ai. Вызов редакция не выполняла. В терминале, из которого пойдёт запрос, заранее задайте ZAI_API_KEY своим секретом. Текст сообщения создан для упражнения; модель и адрес взяты из quickstart. Ответ сохранится в локальный файл. Перед запуском проверьте условия расхода в аккаунте.
curl -X POST "https://api.z.ai/api/paas/v4/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${ZAI_API_KEY}" \
-d '{"model":"glm-5.3","messages":[{"role":"user","content":"Перепиши заметку: библиотека переезжает к северным воротам, время открытия пока неизвестно. Сохрани неизвестность срока."}]}' \
-o response.json
Откройте файл и сохраните обезличенное сообщение ошибки либо текст ответа. Сверьте северные ворота и неизвестный срок. Дата, которой нет во входе, означает расхождение с заданием. Успешное чтение файла показывает результат этой попытки; тарифы и пригодность ответа проверяются отдельно.
Памятка передачи учебного проекта
Перед передачей примера коллеге подготовьте обезличенную карточку. Запишите назначение файла запроса, имя переменной с ключом, выбранную модель и место сохранения ответа. Рядом сохраните исходную заметку про библиотеку. Коллега должен видеть, какие сведения разрешено преобразовать и какие остаются неизвестными. Сам секрет передаётся предусмотренным в вашей команде способом; текстовая карточка содержит только его назначение.
Попросите коллегу сначала проверить сборку без отправки: файл открывается, сообщение соответствует учебному входу, адрес и модель совпадают с карточкой. Затем он решает, когда выполнять запрос в своём аккаунте. Если получен ответ, сравните место встречи и отсутствие срока. Если получена ошибка, сохраните её текст и шаг, на котором остановилось выполнение. Такая передача сохраняет проверяемый вход для повторения опыта. Удачная попытка коллеги относится к его аккаунту и окружению; её нельзя выдавать за общий замер доступности или стоимости.
Частые вопросы
Как получить API ключ Z.ai бесплатно?
Проверьте ресурсы аккаунта и Billing до вызова. Создание ключа само по себе не устанавливает бесплатную квоту.
Чем API-ключ отличается от подписки на чат?
В этом упражнении ключ передаётся программным запросом. Условия своего плана проверяйте перед выбором endpoint.
Какой endpoint использовать для запросов?
Для общего API в примере дан /api/paas/v4. Для Coding Plan возьмите выделенный адрес своего плана.
Где хранить секрет?
В предназначенном для секретов месте. В памятке запишите название переменной и её назначение; содержимое ключа туда не вставляйте.
Как проверить, что ключ работает?
Сохраните фактический ответ на учебный запрос. Сверьте технический результат и содержание заметки отдельными проверками.