generarContenido

打开 Gemini 官方文档，尤其是 Nano Banana 生成图像这类页面，你可能会注意到页面顶部多了一个切换开关——一边是 Interactions API，一边是 generateContent API。这不是文档改版这么简单，而是 Google 在 2026 年 6 月正式把 Interactions API 推上了 GA（正式可用）的位置，并建议所有新项目优先采用。本文结合官方文档和 APIYI 网关的实测结论，把两者的核心差异、能力缺口和实际调用建议一次讲清楚。 核心价值: 读完本文，你会明确 Interactions API 和 generateContent 在设计理念、状态管理、能力覆盖上的具体差异，并知道经 APIYI 中转调用 Gemini 时该选哪一种范式。 Interactions API 与 generateContent 核心差异 先说结论：这两个 API 不是简单的版本升级关系，而是两套不同的设计理念。generateContent 是无状态的“一次请求一次响应”模式，客户端需要自己维护完整的对话历史；Interactions API 则把状态管理下放到服务端，围绕“Interaction”这个新概念重新设计了整套交互方式。 官方文档把一个 Interaction 定义为“一次完整的对话或任务轮次”，内部由一系列按时间顺序排列的执行步骤组成，包括模型的思考过程、工具调用与返回结果，以及最终的模型输出。这意味着 Interactions API 天生就是为多轮对话和 agent 类任务设计的，而不只是单次问答。 这也解释了为什么 Google 会用“正式可用”这样的措辞而不是简单的“新增功能”。Interactions…