ДокументацияПоддержка
Решение ошибок и совместимость

Gemini safetySettings: неверный формат

Исправление категорий и порогов safetySettings без смешивания форматов SDK.

Все руководства (.md)

Текст ошибки

Invalid value at safetySettings or unknown enum value

Не публикуйте API-ключ, полный request body с секретами или персональные данные. Для поддержки сохраните request ID и время запроса.

Почему это происходит

Названия полей и enum отличаются между версиями Gemini API и SDK.

КлиентыМодели
Gemini CLI, Google GenAI SDKGemini

Как проверить

  • Зафиксируйте версию используемого SDK.
  • Проверьте регистр category и threshold.
  • Повторите запрос без safetySettings.

Как исправить

  • Используйте структуру из той же версии API, что и endpoint.
  • Не переносите camelCase-поля в snake_case API автоматически.
  • Добавляйте настройки безопасности только после успешного базового запроса.
После исправления сначала отправьте короткий тестовый запрос. Затем верните tools, streaming и дополнительные параметры по одному.
Термины на этой странице
ТерминЧто означает
Base URLБазовый адрес API, к которому клиент добавляет нужный маршрут.
API-ключСекрет для авторизации и списания запросов с вашего баланса.
Model IDТочное системное имя модели из каталога Elysium AI.
EndpointМаршрут конкретной операции после базового адреса API.
RequestОдин запрос клиента к API вместе с его заголовками и телом.
ResponseРезультат обработки запроса: статус, заголовки и данные.