Google Interactions 协议对接

d token 已提供 Google Gemini Interactions 协议的创建、查询、取消和删除能力。接口统一使用 dToken APD Token 鉴权，并由网关选择已启用的 Gemini 渠道。

接口一览

操作	方法	路径
创建 Interaction	`POST`	`/v1beta/interactions`
查询 Interaction	`GET`	`/v1beta/interactions/{id}`
取消 Interaction	`POST`	`/v1beta/interactions/{id}/cancel`
删除 Interaction	`DELETE`	`/v1beta/interactions/{id}`

所有接口都需要：

创建同步请求

model 与 agent 必须且只能填写一个，input 必填。

成功后响应中会包含 id、status、steps 和 usage 等字段。请保存 id，后续查询、取消和删除都使用它。

创建流式请求

将 stream 设为 true。响应类型为 text/event-stream，每个事件都包含 event_type 和对应的增量数据。

客户端应按 SSE 事件逐条处理，不要把整个响应当作一个 JSON。网络中断后，可在查询接口中使用 stream=true 和 last_event_id 尝试从指定事件之后继续接收。

创建后台任务

将 background 设为 true，适合耗时较长的 agent 或研究任务：

使用 agent 时可以传 agent_config，但不能传 generation_config；使用 model 时规则相反。

查询任务

常见状态包括：

in_progress

requires_action

completed

failed

cancelled

incomplete

Interaction 记录与创建它的用户、Token 和渠道绑定。其他用户无法用同一个 ID 查询该资源。

取消任务

取消后台任务后，建议再查询一次资源，确认最终状态和用量已经回传并完成结算。

删除资源

成功删除返回 204 No Content。尚未结算的后台 Interaction 不能直接删除；先取消并查询，待状态与用量落库后再删除。

Apifox 调试建议

新建环境变量 baseUrl，值为实际 dToken API 地址。

新建私密变量 apdToken，不要同步到公开环境。

项目鉴权选择 Bearer Token，值填写 {{apdToken}}。

分别保存同步、流式、后台任务三个接口用例。

后台任务用例从创建响应中提取 id，写入环境变量 interactionId，查询接口路径使用 {{interactionId}}。

发布公开文档时只保留脱敏示例，不发布测试账号和真实 Token。

Google Interactions 协议

Google Interactions 协议对接#

接口一览#

创建同步请求#

创建流式请求#

创建后台任务#

查询任务#

取消任务#

删除资源#

Apifox 调试建议#