创建聊天补全

根据对话历史创建模型响应。支持流式和非流式响应。兼容 OpenAI Chat Completions API。

POST /v1/chat/completions

服务根地址: https://getrouter.ai

协议: OpenAI Chat Completions

认证: Authorization: Bearer YOUR_API_KEY

请求体

请求体必填。媒体类型: application/json

请求字段

字段	类型	必填	说明
`model`	`string`	是	模型 ID
`messages`	`array<object>`	是	对话消息列表
`temperature`	`number`	否	采样温度默认值: `1`; 范围: 0–2
`top_p`	`number`	否	核采样参数默认值: `1`; 范围: 0–1
`n`	`integer`	否	生成数量默认值: `1`; 范围: 1–∞
`stream`	`boolean`	否	是否流式响应默认值: `false`
`stream_options`	`object`	否	—
`stop`	`string or array<string>`	否	停止序列
`max_tokens`	`integer`	否	最大生成 Token 数
`max_completion_tokens`	`integer`	否	最大补全 Token 数
`presence_penalty`	`number`	否	默认值: `0`; 范围: -2–2
`frequency_penalty`	`number`	否	默认值: `0`; 范围: -2–2
`logit_bias`	`object`	否	—
`user`	`string`	否	—
`tools`	`array<object>`	否	—
`tool_choice`	`string or object`	否	—
`response_format`	`object`	否	—
`seed`	`integer`	否	—
`reasoning_effort`	`string`	否	推理强度（用于支持推理的模型）可选值: `low`, `medium`, `high`
`modalities`	`array<string>`	否	—
`audio`	`object`	否	—

请求示例

curl --request POST \
  --url https://getrouter.ai/v1/chat/completions \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "MODEL_ID",
  "messages": [
    {
      "role": "system",
      "content": "你好，请介绍一下自己。"
    }
  ],
  "stream": false,
  "temperature": 1,
  "max_tokens": 1
}'

响应

状态码	说明
`200`	成功创建响应
`400`	请求参数错误
`429`	请求频率限制

成功响应字段

字段	类型	必填	说明
`id`	`string`	否	—
`object`	`string`	否	—
`created`	`integer`	否	—
`model`	`string`	否	—
`choices`	`array<object>`	否	—
`usage`	`object`	否	—
`system_fingerprint`	`string`	否	—

响应示例

{
  "id": "string",
  "object": "object",
  "created": 1,
  "model": "MODEL_ID",
  "choices": [
    {
      "index": 1,
      "message": {
        "role": "system",
        "content": "你好，请介绍一下自己。",
        "name": "string",
        "tool_calls": [
          {
            "id": null,
            "type": null,
            "function": null
          }
        ],
        "tool_call_id": "string",
        "reasoning_content": "string"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "total_tokens": 1,
    "prompt_tokens_details": {
      "cached_tokens": 1,
      "text_tokens": 1,
      "audio_tokens": 1,
      "image_tokens": 1
    },
    "completion_tokens_details": {
      "text_tokens": 1,
      "audio_tokens": 1,
      "reasoning_tokens": 1
    }
  },
  "system_fingerprint": "string"
}

#创建聊天补全

#请求体

#请求字段

#请求示例

#响应

#成功响应字段

#响应示例

#相关指南

创建聊天补全

请求体

请求字段

请求示例

响应

成功响应字段

响应示例

相关指南