Chat
发起 AI 对话
与 AI 模型进行对话，支持流式和非流式输出、工具调用、消息剪裁等功能。
操作限制：
- 最大请求时长：300 秒（5 分钟）
- 工具调用步数限制：30 步
- 工具调用超过限制后会自动停止
流式输出：
- 当
stream=true时，返回 AI SDK 标准流式响应（text/event-stream） - 流式响应包含实时生成的消息内容和工具调用
验证模式：
- 当
validateOnly=true或contextStrategy="report"时，返回 ValidationReport 而非实际对话响应
POST
Authorizations
使用 Bearer Token 进行认证，格式：Bearer YOUR_API_KEY
Body
application/json
模型 ID，格式：provider/model
Example:
"anthropic/claude-3-7-sonnet-20250219"
对话消息数组。支持两种格式：
- AI SDK 标准格式（UIMessage）：包含 role、content、parts 等完整字段，支持工具调用历史
- 简化格式：仅包含 {role, content}，服务端会自动归一化为 UIMessage 格式
是否启用流式输出。流式输出返回 text/event-stream 格式，非流式返回完整 JSON 响应。
是否启用消息剪裁。启用后会根据 pruneOptions 配置自动删除历史消息以控制 token 数量。
消息剪裁选项。当 prune=true 时生效。未指定的字段使用默认值。
直接指定系统提示词，优先级高于 promptType。如果同时指定了 promptType，此字段优先使用。
系统提示词类型。从 context.systemPrompts 中查找对应的提示词。如果找不到会使用默认提示词。
Available options:
bossZhipinSystemPrompt, bossZhipinLocalSystemPrompt, generalComputerSystemPrompt 允许使用的工具名称列表。如果不指定，会根据 promptType 自动启用对应的工具集。
上下文缺失处理策略：
error：缺少必需上下文时抛出错误（默认）skip：缺少必需上下文时跳过该工具，继续执行report：返回验证报告，不实际执行对话
Available options:
error, skip, report E2B 沙盒 ID。使用需要沙盒的工具（如 bash、computer）时必需。可以设为 null 表示不使用沙盒。
全局上下文配置。包含各种工具可能需要的配置数据。具体字段的类型定义可通过 /config-schema 端点获取。
工具特定上下文映射。键为工具名，值为该工具的特定配置。可以覆盖 context 中的同名字段。
仅验证模式。设为 true 时，只验证参数和上下文是否正确，不实际执行对话。返回 ValidationReport 而非对话响应。