创建对话补全（Chat Completions）

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

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

请求参数

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

messages 字段

字段	类型	是否必填	说明
role	string	是	角色：system / user / assistant / tool。
content	string / array	是	文本内容；或多模态内容数组（若模型支持）。
name	string	否	可选的消息作者名称（兼容字段）。

cURL 示例

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
  }'