需要超过65536 token的思考和输出预算时,可在hydrogen的interactions请求中同时设置background=true和较高的max_output_tokens,保留返回id并轮询到完成,最后合并所有model_output步骤中的文本。统一窗口仍受输入占用影响,后台模式也不是无限输出。
准备SDK与任务预算
在已配置GEMINI_API_KEY且安装最新版google-genai的Python环境执行。下面将预算设为131072作为示例;它是上限,不代表模型一定生成同样长度,实际输入、思考及输出还需装入1048576 Token统一窗口。

谷歌Long decode说明统一窗口与连续生成段
import time
from google import genai
client = genai.Client()
job = client.interactions.create(
model="gemini-4-hydrogen",
input="为一个日志处理服务编写分章节的设计说明,覆盖输入、存储、错误处理和验证。",
background=True,
generation_config={
"max_output_tokens": 131072,
"thinking_level": "high",
},
)
job_id = job.id
print("Interaction:", job_id)
deadline = time.monotonic() + 1800
while job.status in ("queued", "in_progress"):
if time.monotonic() >= deadline:
raise TimeoutError("Still running; keep the interaction ID for later retrieval")
time.sleep(5)
job = client.interactions.get(id=job_id)
if job.status != "completed":
raise RuntimeError(f"Interaction ended with status: {job.status}")
text = "".join(
part.text
for step in job.steps
if step.type == "model_output"
for part in step.content
if part.type == "text"
)
print(text)
print(job.usage)重连使用原ID,不重复创建任务
后台创建返回的是任务标识,不是最终完成证明。轮询遇到网络中断时,保留原ID再恢复读取;不要仅因本地连接超时便重新创建同一任务。上例等待达到应用设定的30分钟上限时停止本地等待,并不宣称服务器任务已经取消。
使用AIsa生成图像与视频。仅需一个API密钥即可调用Gemini 3 Pro Image(图像)和Qwen Wan 2.6(视频)。

Interactions API后台执行与状态流程
同时处理状态与数据保留条件
除completed外,任务还可能failed、cancelled或requires_action;需要应用按具体状态处理,不能直接打印部分输出就报告成功。后台执行要求store=True,服务端需要保存交互供后续读取;不接受相应保存条件的业务,应评估客户端续接方式。
仅设置background而省略max_output_tokens仍使用默认65536预算。长输出还会增加时间与费用,正式运行应同时记录状态、usage和自己的截止条件,不能把最大输出能力当成免费或定时完成承诺。

















