跳转到主要内容
POST
根据有序消息列表创建模型响应。对于已有 OpenAI SDK 与消息式应用,本端点具有最广泛的兼容性。

端点

请求头

Authorization
string
必填
格式为 Bearer $YELU_API_KEY
Content-Type
string
必填
必须为 application/json

请求体

model
string
必填
模型列表返回的模型 ID。
messages
array
必填
有序对话消息。每项包含 rolecontent;多模态模型也可接受内容数组。
temperature
number
默认值:"1"
采样温度,范围 02。通常只调整 temperaturetop_p 其中一个。
top_p
number
默认值:"1"
核采样概率,范围 01
max_completion_tokens
integer
允许生成的最大 Token 数。
stream
boolean
默认值:"false"
设为 true 时返回 SSE 增量 Chunk。
stream_options
object
流式选项;兼容模型可通过 include_usage 请求最终用量 Chunk。
stop
string | string[]
遇到指定序列时停止生成。
presence_penalty
number
默认值:"0"
范围 -22,按 Token 是否出现调整重复倾向。
frequency_penalty
number
默认值:"0"
范围 -22,按 Token 出现频率调整重复倾向。
tools
array
模型可以请求的函数定义。执行前必须校验参数。
tool_choice
string | object
noneautorequired 或指定函数。
response_format
object
在兼容模型上请求 JSON Object 或 JSON Schema。
reasoning_effort
string
兼容推理模型支持 lowmediumhigh
user
string
稳定且不包含敏感信息的最终用户标识。

响应

id
string
必填
补全请求唯一 ID。
object
string
必填
非流式为 chat.completion,流式 Chunk 为 chat.completion.chunk
created
integer
必填
创建时间的 Unix 时间戳。
model
string
必填
实际生成响应的模型。
choices
array
必填
候选结果,包含 index、助手 messagefinish_reason
usage
object
Token 用量,通常包含 prompt_tokenscompletion_tokenstotal_tokens

错误码

流式输出

安全解析 SSE Chunk。

函数调用

把聊天模型连接到应用工具。
最后修改于 2026年7月13日