创建 Interaction

POST

/v1beta/interactions

model 与 agent 必须且只能填写一个；input 必填。stream=true 时返回 SSE。

请求参数

Body 参数application/json

示例

模型请求后台 Agent 请求

{
    "model": "gemini-3.1-flash-lite",
    "input": "请介绍 d token",
    "store": true,
    "generation_config": {
        "max_output_tokens": 512
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

模型请求后台 Agent 请求

curl --location '/v1beta/interactions' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gemini-3.1-flash-lite",
    "input": "请介绍 d token",
    "store": true,
    "generation_config": {
        "max_output_tokens": 512
    }
}'

返回响应

🟢200

application/json

创建成功；流式请求返回 SSE

Bodyapplication/json

示例

{
    "id": "string",
    "object": "string",
    "status": "in_progress",
    "model": "string",
    "agent": "string",
    "input": "string",
    "steps": "string",
    "usage": {
        "total_tokens": 0,
        "total_input_tokens": 0,
        "total_output_tokens": 0,
        "total_cached_tokens": 0,
        "total_tool_use_tokens": 0,
        "total_thought_tokens": 0,
        "input_tokens_by_modality": "string",
        "output_tokens_by_modality": "string"
    },
    "previous_interaction_id": "string",
    "created": "string",
    "updated": "string",
    "errors": "string"
}

🟠400ErrorResponse

🟠401ErrorResponse

🟠429ErrorResponse

修改于 2026-10-21 09:18:09

获取文件内容 (未实现)

查询 Interaction