contents 和可选的 generationConfig,没有额外 YingTu 顶层包装。
哪些场景适合同步
服务端工具、后台管理操作和可控的交互任务通常更容易使用同步方式,因为一个 HTTP 响应就包含最终 Gemini 结果,不需要保存任务状态。 但模型和尺寸仍然决定等待时间与响应体积。Pro 4K 与 Lite 1K 不能使用同一套超时和内存假设;Base64 还会使 JSON 大于解码后的图片。结果不能按固定位置读取
遍历所有候选结果和parts,找到带 inlineData.data 的内容,再按 inlineData.mimeType 保存。如果没有图片,检查 promptFeedback.blockReason,不要把 HTTP 200 当成业务成功。
打开同步接口
查看通用请求、响应和错误结构。
先确定模型
根据生命周期、尺寸和任务价值选择。
改为后台任务
收到 202 后保存 task_id,再查询结果。