Gemini
Gemini: invalid system_instruction
Как передавать системную инструкцию в Gemini-compatible и OpenAI-compatible режимах.
Пошаговое объяснение без лишних деталей
Текст ошибки
Invalid JSON payload received. Unknown name system_instruction
Не публикуйте API-ключ, полный request body с секретами или персональные данные. Для поддержки сохраните request ID и время запроса.
Почему это происходит
В запросе смешаны поля OpenAI и нативного Gemini GenerateContent API.
КлиентыGemini CLI, Google GenAI SDK, OpenAI SDK
МоделиGemini
Как проверить
- Определите активный endpoint.
- Сравните структуру contents/messages.
- Удалите system_instruction и проверьте базовый запрос.
Как исправить
- В нативном Gemini формате используйте systemInstruction ожидаемой структуры.
- В OpenAI-compatible формате используйте system/developer message.
- Не отправляйте оба варианта одновременно.
После исправления сначала отправьте короткий тестовый запрос. Затем верните tools, streaming и дополнительные параметры по одному.
Термины на этой странице
Короткая расшифровка обозначений, которые встречаются в этом разделе.
ТерминBase URL
Что означаетБазовый адрес API, к которому клиент добавляет нужный маршрут.
ТерминAPI-ключ
Что означаетСекрет для авторизации и списания запросов с вашего баланса.
ТерминModel ID
Что означаетТочное системное имя модели из каталога Elysium AI.
ТерминEndpoint
Что означаетМаршрут конкретной операции после базового адреса API.
ТерминRequest
Что означаетОдин запрос клиента к API вместе с его заголовками и телом.
ТерминResponse
Что означаетРезультат обработки запроса: статус, заголовки и данные.