跳转到主要内容
POST
通用对话 API
  • 适用于大多数 LLM 的统一聊天 API 接口;哪些模型支持见 LLM 模型
  • 通过 model 参数选择不同的 AI 模型
  • 兼容 OpenAI Chat Completions API 格式

使用示例

基础对话

系统提示词

多轮对话

流式输出

注意事项

  • 使用 stream: true 获取 SSE 流式响应。
  • 不同模型支持的上下文长度、输出上限和可选参数可能不同。
  • 对于需要工具或多模态结构化输入的新 OpenAI 兼容工作流,请使用 Responses API。

响应

非流式请求直接返回 Chat Completions 对象,不带 code / data 包装。DeepSeek 等推理模型还会在 choices[].message.reasoning_content 中返回推理文本,并计入 usage.completion_tokens_details.reasoning_tokens。

流式输出

设置 "stream": true 时,响应为 text/event-stream。每个事件是一行包含 chat.completion.chunk 对象的 data:,流以 data: [DONE] 结束:
  • 文本在 choices[0].delta.content 中返回。推理模型会先流式返回 choices[0].delta.reasoning_content。
  • 最后一个 chunk 携带 finish_reason 和 usage。

错误

  • 401:缺少 API Key 或 API Key 无效。
  • 400:参数无效,或模型不支持 Chat Completions(例如 gpt-5-6-sol 只支持 Responses)。错误信息会列出支持的 URI。
  • 404:未知的 model id。
响应体示例见错误码,哪些模型支持此格式见 LLM 模型。

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证。

创建 API Key:登录 PoYo,进入 仪表盘 → API 密钥(poyo.ai/zh/dashboard/api-key),点击创建 Key。

在请求头中添加:

请求体

application/json
model
string
必填

模型名称。示例:gpt-5.2、claude-sonnet-4-5-20250929、gemini-3-flash-preview。

示例:

"gpt-5.2"

messages
object[]
必填

对话消息列表。每条消息包含 role 和 content。system 用于定义模型行为,user 用于用户输入,assistant 用于多轮对话中模型之前的回复。示例:[{"role": "user", "content": "Explain vector databases in one sentence."}]。

temperature
number

控制输出的随机性,范围 0-2。较低的值(如 0.2)使输出更确定,较高的值(如 1.8)使输出更随机。默认值:1.0。

必填范围: 0 <= x <= 2
示例:

1

max_tokens
integer

生成的最大 token 数。不同模型的上限不同。

必填范围: x >= 1
示例:

256

stream
boolean

是否使用流式输出。true 以 SSE 格式返回流式响应,false 一次性返回完整响应。默认值:false。

示例:

false

top_p
number

核采样参数,范围 0-1。控制生成文本的多样性。建议只使用 top_p 或 temperature 其中之一,不要同时使用。默认值:1.0。

必填范围: 0 <= x <= 1
示例:

1

frequency_penalty
number

频率惩罚,范围 -2.0 到 2.0。正值会降低重复相同词语的可能性。默认值:0。

必填范围: -2 <= x <= 2
示例:

0

presence_penalty
number

存在惩罚,范围 -2.0 到 2.0。正值会提高谈论新话题的可能性。默认值:0。

必填范围: -2 <= x <= 2
示例:

0

stop

停止序列。最多 4 个,遇到其中任一序列时停止生成。

示例:

"\n\nHuman:"

n
integer

生成的补全数量。默认值:1。必须是普通数字,如 1,不要加引号。

必填范围: x >= 1
示例:

1

响应

补全已创建

id
string

响应的唯一标识符。

示例:

"chatcmpl-9876543210"

object
string

对象类型。

示例:

"chat.completion"

created
integer

创建时间戳。

示例:

1677652288

model
string

实际使用的模型名称。

示例:

"gpt-5.2"

choices
object[]
usage
object