OpenAI API

兼容 OpenAI Chat Completions API 格式，适用于 GPT 客户端、OpenAI SDK 等。

端点

POST https://token.pudbot.com/v1/chat/completions

请求头

Header	必填	说明
Authorization	是	Bearer *** Key
content-type	是	application/json

请求参数

参数	类型	必填	说明
model	string	是	模型名称，如 gpt-4o
messages	array	是	消息数组，参见下方格式
max_tokens	integer	否	最大生成 Token 数
temperature	float	否	采样温度，0~2，默认 1.0
top_p	float	否	核采样，0~1
stream	boolean	否	是否流式返回，默认 false
stop	string/array	否	停止序列
n	integer	否	生成候选数，默认 1
presence_penalty	float	否	-2.0~2.0，默认 0
frequency_penalty	float	否	-2.0~2.0，默认 0

messages 格式

[
  {"role": "system", "content": "你是一个有帮助的助手。"},
  {"role": "user", "content": "你好"},
  {"role": "assistant", "content": "你好！有什么可以帮你的？"},
  {"role": "user", "content": "写一首诗"}
]

支持图片输入：

{
  "role": "user",
  "content": [
    {"type": "text", "text": "这张图是什么？"},
    {"type": "image_url", "image_url": {"url": "https://example.com/image.png"}}
  ]
}

请求示例

curl https://token.pudbot.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}],
    "max_tokens": 1024
  }'

响应格式

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1720123456,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 15,
    "total_tokens": 25
  }
}

流式响应

设置 "stream": true，返回 SSE 事件流：

curl https://token.pudbot.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的APIKey" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "写一首关于编程的诗"}],
    "stream": true
  }'

每个 chunk 格式：

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion.chunk",
  "created": 1720123456,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "delta": {"content": "Hello"},
      "finish_reason": null
    }
  ]
}

流结束时 finish_reason 为 "stop"，delta.content 为空字符串。

支持的模型

模型	说明
gpt-4o	GPT-4o，多模态，日常首选
gpt-4o-mini	轻量快速版
gpt-4-turbo	GPT-4 Turbo
gpt-4	GPT-4
gpt-3.5-turbo	GPT-3.5
o1	OpenAI o1 推理模型
o1-mini	o1 轻量版
o1-pro	o1 Pro
o3	OpenAI o3
o3-mini	o3 轻量版
o4-mini	o4 轻量版