Skip to content

创建对话补全(Chat Completions) ​

  • 接口:POST https://api.olddog.shop/v1/chat/completions
  • 鉴权:Authorization: Bearer <API_KEY>
  • Content-Type:application/json

用于根据对话消息生成模型回复,兼容 OpenAI chat.completions 规范。

请求参数 ​

参数名类型是否必填说明
modelstring是模型 ID,例如 gpt-4o-mini(以控制台实际可用为准)。
messagesarray是对话消息数组。每个元素包含 role 与 content。
temperaturenumber否采样温度,通常 (0~2)。越高越随机。
top_pnumber否核采样概率,通常 (0~1)。与 temperature 二选一调整即可。
max_tokensinteger否生成的最大 token 数(不同模型上限不同)。
streamboolean否是否开启流式返回。默认 false。
stopstring / array否停止序列。命中后提前结束生成。
presence_penaltynumber否话题新颖度惩罚,通常 (-2~2)。
frequency_penaltynumber否重复惩罚,通常 (-2~2)。
userstring否终端用户标识,用于风控与分析。

messages 字段 ​

字段类型是否必填说明
rolestring是角色:system / user / assistant / tool。
contentstring / array是文本内容;或多模态内容数组(若模型支持)。
namestring否可选的消息作者名称(兼容字段)。

cURL 示例 ​

bash
curl --request POST "https://api.olddog.shop/v1/chat/completions" \
  --header "Authorization: Bearer $OLD_DOG_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "gpt-4o-mini",
    "messages": [
      { "role": "system", "content": "你是一个专业的中文技术写作助手。" },
      { "role": "user", "content": "用三句话解释什么是向量嵌入。" }
    ],
    "temperature": 0.7
  }'