model

String

是

-

您创建的智能体 ID

bot-202406040*****-*****

messages

Array of MessageParam

是

-

由目前为止的对话组成的消息列表
当指定了 tools 参数以使用模型的 function call 能力时，请确保 messages 列表内的消息满足如下要求：

• 如果 message 列表中前文出现了带有 n 个 tool_calls 的 Assistant Message，则后文必须有连续 n 个分别和每个 tool_call_id 相对应的 Tool Message，来回应 tool_calls 的信息要求
• 如果 system prompt 在智能体创建页已经指定，两个 system prompt 会同时生效 [preset_system_prompt, request_system_prompt]

-

stream

Boolean

否

false

响应内容是否流式返回

• false：模型生成完所有内容后一次性返回结果

• true：按 SSE 协议逐块返回模型生成内容，并以一条 data: [DONE] 消息结束

false

stream_options

StreamOptionsParam

否

-

流式响应的选项。仅当 stream: true 时可以设置 stream_options 参数。

-

temperature

Float

否

1

采样温度。控制了生成文本时对每个候选词的概率分布进行平滑的程度。取值范围为 [0, 1]。0 特殊处理
较高的值（如 0.8）会使输出更加随机，而较低的值（如 0.2）会使输出更加集中确定。通常建议仅调整 temperature 或 top_p 其中之一，不建议两者都修改。

0.8

top_p

Float

否

0.7

核采样概率阈值。模型会考虑概率质量在 top_p 内的 token 结果。取值范围为 [0, 1]。
如 0.1 意味着只考虑概率质量最高的前 10% 的 token，取值越大生成的随机性越高，取值越低生成的确定性越高。通常建议仅调整 temperature 或 top_p 其中之一，不建议两者都修改。

0.8

logprobs

Boolean

否

false

是否返回输出 tokens 的对数概率。

• false：不返回对数概率信息

• true：返回消息内容中每个输出 token 的对数概率

false

top_logprobs

Integer

否

0

指定每个输出 token 位置最有可能返回的 token 数量，每个 token 都有关联的对数概率。仅当 logprobs: true 时可以设置 top_logprobs 参数，取值范围为 [0, 20]。

2

logit_bias

Map<String, Integer>

否

-

调整指定 token 在模型输出内容中出现的概率，使模型生成的内容更加符合特定的偏好。logit_bias 字段接受一个 map 值，其中每个键为词表中的 token ID，每个值为该 token 的偏差值，取值范围为 [-100, 100]。
-1 会减少选择的可能性，1 会增加选择的可能性；-100 会完全禁止选择该 token，100 会导致仅可选择该 token。该参数的实际效果可能因模型而异。

{
    "1234": -100
}

role

String

是

-

发出该消息的对话参与者角色，可选值包括：

• system：System Message 系统消息

• user：User Message 用户消息

• assistant：Assistant Message 对话助手消息

• tool：Tool Message 工具调用消息

user

content

String

否

-

消息内容

• 当 role 为 system、user、tool时，参数必填

• 当 role 为 assistant 时，content 与 tool_calls 参数二者至少填其一

世界第一高山是什么？

tool_calls

Array of MessageToolCallParam

否

-

模型生成的工具调用。当 role 为 assistant 时，content 与 tool_calls 参数二者至少填其一

-

arguments

String

是

-

模型生成的用于调用函数的参数，JSON 格式。请注意，模型并不总是生成有效的 JSON，并且可能会虚构出一些您的函数参数规范中未定义的参数。在调用函数之前，请在您的代码中验证这些参数是否有效。

{\"location\": \"Boston, MA\"}

function

FunctionDefinition

是

-

模型可以调用的工具列表。

-

parameters

Object

否

函数请求参数，以 JSON Schema 格式描述。具体格式请参考 JSON Schema 文档

{
    "type": "object",
    "properties": {
        "location": {
            "type": "string",
            "description": "城市，如：北京",
        },
    },
    "required": ["location"],
}

include_usage

Boolean

否

false

是否包含本次请求的 token 用量统计信息

• false：不返回 token 用量信息

• true：在 data: [DONE] 消息之前返回一个额外的块，此块上的 bot_usage 字段代表整个请求的 token 用量，choices 字段为空数组。所有其他块也将包含 bot_usage 字段，但值为 null。

false

user_info

String

否

-

可以被反序列化成 json 的字符串，需要包含 city 和 district 两个字段

"{\"city\":\"北京\",\"district\":\"海淀区\"}"

model

String

本次请求实际使用的模型名称和版本

doubao-pro-4k-240515

choices

Array of Choice

本次请求的模型输出内容

-

bot_usage

BotUsage

本次请求的 tokens 和插件消耗

-

references

Array of Reference

• 知识库/联网的引用结果，表示调用插件的返回值

• 首chunk返回

-

model

String

本次请求实际使用的模型名称和版本

doubao-pro-4k-240515

choices

Array of StreamChoice

本次请求的模型输出内容

-

bot_usage

BotUsage

本次请求的 tokens 和插件消耗

-

references

Array of Reference

• 知识库/联网的引用结果，表示调用插件的返回值

• 首chunk返回

-

finish_reason

String

模型停止生成 token 的原因。可能的值包括：

• stop：模型输出自然结束，或因命中请求参数 stop 中指定的字段而被截断

• length：模型输出因达到请求参数 max_token 指定的最大 token 数量而被截断

• content_filter：模型输出被内容审核拦截

• tool_call：模型调用了工具

stop

message

Message

模型输出的内容

-

arguments

String

模型生成的用于调用函数的参数，JSON 格式。请注意，模型并不总是生成有效的 JSON，并且可能会虚构出一些您的函数参数规范中未定义的参数。在调用函数之前，请在您的代码中验证这些参数是否有效。

{\"location\": \"Boston, MA\"}

finish_reason

String

模型停止生成 token 的原因。可能的值包括：

• stop：模型输出自然结束，或因命中请求参数 stop 中指定的字段而被截断

• length：模型输出因达到请求参数 max_token 指定的最大 token 数量而被截断

• content_filter：模型输出被内容审核拦截

• tool_call：模型调用了工具

stop

delta

ChoiceDelta

模型输出的内容

-

400

BadRequest

SensitiveContentDetected

The request failed because the input text may contain sensitive information.

输入文本可能包含敏感信息，请您使用其他 prompt。