OpenAI 对话接口

OpenAI 兼容的对话补全接口，是最常用的接口。

接口

POST /v1/chat/completions

请求头

Authorization: Bearer sk-你的令牌
Content-Type: application/json

请求体（常用字段）

字段	类型	说明
model	string	模型名，如 gpt-4o-mini
messages	array	消息数组，每项含 role（system/user/assistant）与 content
stream	boolean	是否流式返回，默认 false
temperature	number	采样温度，0–2
max_tokens	integer	最大生成 token 数
tools	array	工具/函数调用定义
response_format	object	结构化输出（如 JSON 模式）

其余 OpenAI 标准字段（top_p、presence_penalty、seed 等）均兼容。

非流式示例

curl https://wordrelay.chat/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的令牌" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "用一句话介绍词驿"}]
  }'

响应（节选）：

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "gpt-4o-mini",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "..."},
      "finish_reason": "stop"
    }
  ],
  "usage": {"prompt_tokens": 12, "completion_tokens": 18, "total_tokens": 30}
}

流式示例

把 stream 设为 true：

curl https://wordrelay.chat/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的令牌" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "写一首关于驿站的短诗"}],
    "stream": true
  }'

返回 Server-Sent Events 流，每个 data: 是一段增量，以 data: [DONE] 结束。

多模态（识图）

在 content 里传图片（URL 或 base64）：

{
  "model": "gpt-4o",
  "messages": [
    {
      "role": "user",
      "content": [
        {"type": "text", "text": "描述这张图"},
        {"type": "image_url", "image_url": {"url": "https://example.com/img.jpg"}}
      ]
    }
  ]
}

本地图片可转成 base64 data URL：data:image/jpeg;base64,/9j/4AAQ...。

模型名

词驿支持的模型见模型价格。常用：

• 文本对话：gpt-4o、gpt-4o-mini、claude-sonnet-4-5、deepseek-chat、gemini-2.5-flash
• 多模态识图：gpt-4o、claude-sonnet-4-5、gemini-2.5-flash

计费

返回的 usage 反映本次调用的 token 消耗，据此计费。规则见引言 · 计费方式。