跳转到主要内容
同步接口适合调用方和中间代理都能等待最终图片的场景:
模型 ID 位于 URL 中,请求体使用 contents 和可选的 generationConfig,没有额外 YingTu 顶层包装。

哪些场景适合同步

服务端工具、后台管理操作和可控的交互任务通常更容易使用同步方式,因为一个 HTTP 响应就包含最终 Gemini 结果,不需要保存任务状态。 但模型和尺寸仍然决定等待时间与响应体积。Pro 4K 与 Lite 1K 不能使用同一套超时和内存假设;Base64 还会使 JSON 大于解码后的图片。

结果不能按固定位置读取

遍历所有候选结果和 parts,找到带 inlineData.data 的内容,再按 inlineData.mimeType 保存。如果没有图片,检查 promptFeedback.blockReason,不要把 HTTP 200 当成业务成功。
连接超时只能说明客户端没有拿到结果,不能证明上游没有执行。无法安全保持连接时,应在发送前选择异步任务。

打开同步接口

查看通用请求、响应和错误结构。

先确定模型

根据生命周期、尺寸和任务价值选择。

改为后台任务

收到 202 后保存 task_id,再查询结果。
最后修改于 2026年9月2日