Gemini 结构化输出：JSON Schema 范例与验证

大模型输出格式总是不按常理出牌？掌握 response_schema 强制约束规范，100% 稳定输出标准纯净 JSON 格式全代码实战。

一、为什么提示词强行约束不可靠

在以往的 Prompt engineering 中，即使反复强调“只输出 JSON 不要废话”，大模型偶尔仍会在首尾带上 Markdown 反引号或啰嗦的解释，导致后端程序在 json.loads 时瞬间崩溃。

二、Python SDK 原生强制 Schema 语法

import typing_extensions as typing
import google.generativeai as genai

class ArticleSummary(typing.TypedDict):
main_topic: str
key_takeaways: list[str]
confidence_score: float

model = genai.GenerativeModel(
"gemini-1.5-flash",
generation_config={
"response_mime_type": "application/json",
"response_schema": ArticleSummary
}
)

# 模型的输出将在底层解码阶段被状态机强制约束为标准 JSON
response = model.generate_content("对最新人工智能大模型发布进行核心提炼")
print(response.text)

三、生产环境稳定性

采用该方案后，JSON 解析失败率从传统的 5% 直降为 0。
基础配置详见：[Gemini API 入门总指南](https://aihuiyuan.club/articles/gemini-api-key-google-ai-studio-free)。