Официальный порядок
Руководство Z.ai описывает получение стандартного API-ключа, выбор модели и метода вызова. Для специальных планов нужно следовать их отдельной инструкции настройки.
Кнопки «Регистрация» этой страницы открывают главную STIVA. Они не выдают ключ Z.ai и не подтверждают совместимость API агрегатора. Его адрес, авторизацию, модели и тариф уточняйте у поставщика.
Проверьте минимальный сценарий
Начните с короткого запроса с очевидным ожидаемым ответом. Зафиксируйте статус, фактическую модель и формат результата. Затем добавляйте реальные данные и инструменты, проверяя каждый этап.
Не копируйте endpoint из статьи о другом плане. Если подключение не работает, отдельно проверьте авторизацию, доступ модели и правильность параметров; не меняйте всё сразу.
Контракт для приложения
Опишите структуру ответа, допустимые пропуски и поведение при недостаточных данных. Проверьте поддержку нужного механизма в выбранной модели. Валидируйте полученные поля и не принимайте форматную корректность за смысловую точность.
Предусмотрите тайм-аут, ограничение частоты и неполный результат. Повторы должны иметь предел. Ключи храните на сервере и не публикуйте в клиентском коде.
Проверяйте изменения
Сохраните обычный пример, случай с пропусками и неоднозначный ввод. Измеряйте долю принятых ответов, задержку и расходы. После обновления модели повторите этот набор.
Подход к контрольным данным описан в выборе модели, различия планов — в тарифах.