Разделы wikiGemini safetySettings: неверный формат
WikiРешение ошибок и совместимостьGemini safetySettings: неверный формат
Gemini

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

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

Пошаговое объяснение без лишних деталей

Текст ошибки

Invalid value at safetySettings or unknown enum value

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

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

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

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

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

  • Зафиксируйте версию используемого 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
Что означаетРезультат обработки запроса: статус, заголовки и данные.