发起 AI 对话

Authorizations

Authorization

string

header

required

使用 Bearer Token 进行认证，格式：Bearer YOUR_API_KEY

Body

application/json

model

string

required

模型 ID，格式：provider/model

Example:

"anthropic/claude-3-7-sonnet-20250219"

messages

object[]

required

对话消息数组。支持两种格式：

AI SDK 标准格式（UIMessage）：包含 role、content、parts 等完整字段，支持工具调用历史
简化格式：仅包含 {role, content}，服务端会自动归一化为 UIMessage 格式

Show child attributes

messages.role

enum<string>

required

消息角色

Available options:

user,

assistant,

system

messages.content

string

required

消息内容。注意：AI SDK 的 UIMessage 实际可能包含更复杂的结构（如 parts 数组），但简化格式只需此字段。

stream

boolean

default:true

是否启用流式输出。流式输出返回 text/event-stream 格式，非流式返回完整 JSON 响应。

prune

boolean

default:false

是否启用消息剪裁。启用后会根据 pruneOptions 配置自动删除历史消息以控制 token 数量。

pruneOptions

object

消息剪裁选项。当 prune=true 时生效。未指定的字段使用默认值。

Show child attributes

pruneOptions.maxOutputTokens

integer

default:100000

最大输出 token 数。预留给模型输出的 token 配额。

pruneOptions.targetTokens

integer

default:80000

目标 token 数。剪裁后希望达到的输入 token 数量。

pruneOptions.preserveRecentMessages

integer

default:3

保留最近消息数量。最近的 N 条消息不会被剪裁。

systemPrompt

string

直接指定系统提示词，优先级高于 promptType。如果同时指定了 promptType，此字段优先使用。

promptType

enum<string>

系统提示词类型。从 context.systemPrompts 中查找对应的提示词。如果找不到会使用默认提示词。

Available options:

bossZhipinSystemPrompt,

bossZhipinLocalSystemPrompt,

generalComputerSystemPrompt

allowedTools

string[]

允许使用的工具名称列表。如果不指定，会根据 promptType 自动启用对应的工具集。

contextStrategy

enum<string>

default:error

上下文缺失处理策略：

error：缺少必需上下文时抛出错误（默认）
skip：缺少必需上下文时跳过该工具，继续执行
report：返回验证报告，不实际执行对话

Available options:

error,

skip,

report

sandboxId

string | null

E2B 沙盒 ID。使用需要沙盒的工具（如 bash、computer）时必需。可以设为 null 表示不使用沙盒。

context

object

全局上下文配置。包含各种工具可能需要的配置数据。具体字段的类型定义可通过 /config-schema 端点获取。

Show child attributes

context.preferredBrand

string

首选品牌名称

context.modelConfig

object

模型配置对象，包含不同提供商的 API 配置

context.configData

object

业务配置数据，zhipin_reply_generator 等工具需要

context.systemPrompts

object

系统提示词映射。键为 promptType，值为对应的系统提示词文本。

Show child attributes

context.systemPrompts.{key}

string

context.replyPrompts

object

回复提示词配置，zhipin_reply_generator 工具需要

context.dulidayToken

string | null

Duliday API 访问令牌，duliday 相关工具需要

context.defaultWechatId

string | null

默认微信号，微信相关工具使用

toolContext

object

工具特定上下文映射。键为工具名，值为该工具的特定配置。可以覆盖 context 中的同名字段。

Show child attributes

toolContext.{key}

object

validateOnly

boolean

default:false

仅验证模式。设为 true 时，只验证参数和上下文是否正确，不实际执行对话。返回 ValidationReport 而非对话响应。

Response

对话成功

Option 1
Option 2

非流式响应（stream=false）

success

boolean

Example:

true

data

object

Show child attributes

data.messages

object[]

完整的对话历史，包含用户输入和 AI 响应。使用 AI SDK 的 UIMessage 格式，包含工具调用的完整历史。

Show child attributes

data.messages.role

enum<string>

required

消息角色

Available options:

user,

assistant,

system

data.messages.content

string

required

消息内容。注意：AI SDK 的 UIMessage 实际可能包含更复杂的结构（如 parts 数组），但简化格式只需此字段。

data.usage

object

Token 使用统计。遵循 AI SDK 的字段命名（inputTokens/outputTokens，而非 promptTokens/completionTokens）。所有字段都是可选的，部分提供商可能不报告某些值。

Show child attributes

data.usage.inputTokens

integer

输入（提示）token 数量

data.usage.outputTokens

integer

输出（生成）token 数量

data.usage.totalTokens

integer

总 token 数量（可能不等于 input + output，因为可能包含开销）

data.usage.reasoningTokens

integer

推理 token 数量（仅部分模型支持，如 o1 系列）

data.usage.cachedInputTokens

integer

缓存的输入 token 数量（仅部分提供商支持）

data.tools

object

工具使用统计

Show child attributes

data.tools.used

string[]

已成功启用的工具名称列表

data.tools.skipped

string[]

已跳过的工具名称列表（通常因上下文缺失）

API 概览

Models

Chat

Tools

Configuration

Authorizations

Body

Response