跳转到主要内容
curl https://api.poixe.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $POIXE_API_KEY" \
  -d '{
    "model": "gpt-5.2",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful assistant."
      },
      {
        "role": "user",
        "content": "Hello!"
      }
    ],
    "stream": false
  }'
{
  "id": "chatcmpl-Cw5tpkFF274DThTnfODqT87jH15IQ",
  "object": "chat.completion",
  "created": 1767961737,
  "model": "gpt-5.2-2025-12-11",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! What can I help you with today?",
        "refusal": null,
        "annotations": []
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 13,
    "total_tokens": 31,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "audio_tokens": 0
    },
    "completion_tokens_details": {
      "reasoning_tokens": 0,
      "audio_tokens": 0,
      "accepted_prediction_tokens": 0,
      "rejected_prediction_tokens": 0
    }
  },
  "service_tier": "default",
  "system_fingerprint": null
}
POST https://api.poixe.com/v1/chat/completions
这是 OpenAI 最早、最经典的对话协议,目前兼容性最好,几乎所有厂商与 SDK 都支持。 但它的能力相对有限,OpenAI 新推出的模型有许多新特性更倾向在 Responses 协议 中提供。如果只是轻量对话与基础流式输出,用它就足够。

认证与授权

所有 API 请求都必须在 HTTP Header 中包含您的 API 密钥。
Authorization
string
必填
Bearer Token。格式为 Bearer YOUR_API_KEY
Content-Type
string
必填
必须设置为 application/json

请求参数

以下是构建对话请求时最常用的核心参数。
model
string
必填
请求的模型名称。例如:gpt-4o, gpt-4o-mini 等。
messages
object[]
必填
对话消息列表。
stream
boolean
默认值:"false"
是否流式输出。开启后,服务器将通过 SSE (Server-Sent Events) 逐字发送 Token。
temperature
number
默认值:"1"
采样温度(0~2)。较低的值(如 0.2)使输出更聚焦且确定;较高的值(如 0.8)使输出更具创意和随机性。
top_p
number
默认值:"1"
核采样(nucleus sampling)。通常与 temperature 二选一调整即可。
max_completion_tokens
integer
模型生成内容的最大 Token 限制(包含推理 Token)。建议用于替代已弃用的 max_tokens
n
integer
默认值:"1"
返回多少个候选回复(choices)。为降低成本建议保持 1
presence_penalty
number
默认值:"0"
话题惩罚(-2~2):鼓励生成新话题(更少重复)。
frequency_penalty
number
默认值:"0"
频率惩罚(-2~2):降低重复用词/句子的概率。
tools
object[]
工具列表(函数调用)。
tool_choice
string | object
工具调用策略:none / auto / required,或强制指定某个 tool。
response_format
object
输出格式控制。

响应结构

接口返回一个包含生成结果及消耗统计的对象。
id
string
本次请求的唯一标识符。
object
string
对象类型,通常为 chat.completion
created
integer
创建时间(Unix 秒级时间戳)。
model
string
实际处理请求的模型名称。
choices
object[]
生成结果列表(通常只有 1 条)。
usage
object
Token 用量统计(如有返回)。