创建对话请求 (OpenAI 兼容)

兼容 OpenAI Chat Completions 协议, 一套接口调用 Claude / Gemini 等主流大模型

POST /v1/chat/completions

Auth: {'type': 'bearer', 'prefix': 'sk-', 'description': 'API Key, 使用 `Authorization: Bearer sk-xxx` 鉴权'}

统一的对话补全接口, 请求 / 响应结构与 OpenAI 完全一致。已有使用 OpenAI SDK 的项目只需替换 `baseURL` 即可切换。 - 支持 `stream: true` SSE 流式推送 - `messages[].content` 支持字符串或多模态数组 (文本 + 图片 URL) - 工具调用 (tools / function calling) 同 OpenAI 规范

Request body

`model`	string	required	模型 ID, 如 `claude-opus-4-7` / `claude-sonnet-4-6` / `gemini-2.5-pro` / `gemini-2.5-flash`
`messages`	array	required	对话消息数组, 按时间顺序传入 system / user / assistant
`role`	string	required
`content`	string	required	消息内容 (字符串, 或多模态数组 `[{"type":"text","text":"..."},{"type":"image_url","image_url":{"url":"..."}}]`)
`name`	string		(可选) 消息作者标识
`tool_call_id`	string		(仅 role=tool) 对应的 tool_call id
`temperature`	number		采样温度, 值越高输出越随机, 建议 0.7 左右。与 `top_p` 二选一
`top_p`	number		核采样
`max_tokens`	integer		生成 token 上限
`stream`	boolean		是否以 SSE 流式返回
`stop`	array		停止序列, 最多 4 个
`presence_penalty`	number
`frequency_penalty`	number
`tools`	array		工具定义数组 (function calling)
`response_format`	object		(可选) 响应格式约束, 如 `{"type":"json_object"}` 强制 JSON 输出
`user`	string		(可选) 终端用户标识

Responses

200 — 返回 assistant 消息

Example

curl https://api.router.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      {"role": "system", "content": "你是一位资深的技术写作助手"},
      {"role": "user", "content": "用三句话介绍 Redis"}
    ],
    "temperature": 0.7,
    "max_tokens": 512
  }'

API reference