Interactions格式
更新时间：2026-11-11
POST
Gemini Interactions 原生格式，仅支持 Gemini 系列模型。不支持后台运行（background: true）。
详见调用指南 - 鉴权。
详见调用指南 - 公共请求头。
application/json- body
model?string模型 ID，如 gemini-3.5-flash。model 与 agent 二选一。
agent?string智能体名称，model 与 agent 二选一。
input*||array<>输入内容，可以是字符串、单条消息或消息数组。
system_instruction?string系统指令。
generation_config?生成参数，如 temperature、max_output_tokens。
tools?array<>工具定义。
stream?boolean是否流式响应。
previous_interaction_id?string上一次交互的 ID，用于延续多轮对话上下文。
background?boolean是否后台运行，仅支持 false。
默认值
false成功创建响应
application/json- response
id?string交互 ID。
model?string实际使用的模型 ID。
status?string交互状态，如 completed。
outputs?array<>输出内容列表。
usage?Token 用量统计。
curl -X POST 'https://api.cysuo.com/v1beta/interactions' \ -H 'Content-Type: application/json' \ -d '{ "model": "gemini-3.5-flash", "input": "你好，请介绍一下你自己。"}'响应示例200
{ "id": "string", "model": "string", "status": "string", "outputs": [ { "type": "string", "text": "string" } ], "usage": { "total_input_tokens": 0, "total_output_tokens": 0, "total_thought_tokens": 0, "total_cached_tokens": 0, "total_tokens": 0 }}