跳转到主要内容
Endpoint: POST /chat/completions 大多数模型 API 集成都应使用这个接口。发送 model ID 和 messages 数组，YouRouter 会返回 OpenAI 兼容的 completion 响应。对于支持视觉能力的模型，这个接口也能在 messages[].content 中接收图片输入。

​
请求

curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": "Reply with exactly: connected"
      }
    ]
  }'

​
OpenAI SDK

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["YOUROUTER_API_KEY"],
    base_url="https://api.yourouter.ai/v1",
)

completion = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Reply with exactly: connected"}],
)

print(completion.choices[0].message.content)

​
请求头

Header必填说明
Authorization是Bearer <YOUR_YOUROUTER_API_KEY>
Content-Type是使用 application/json。
vendor否使用 auto 或省略代表自动路由。也可使用 openai、anthropic、google 等值固定上游。

​
请求体参数

​
model
string
必填
要调用的模型 ID，例如 gpt-4o、claude-sonnet-4-20250514 或 gemini-2.5-flash。
​
messages
array
必填
有序的对话消息数组。每条消息都包含 role 和 content。
​
stream
boolean
默认值:"false"
若为 true，则以 SSE 分片方式返回结果。
​
temperature
number
在模型支持时，用于控制输出随机性。
​
max_tokens
integer
在模型支持时，用于限制输出 token 数。
​
tools
array
对支持函数调用或工具调用的模型，传入工具定义。

​
多模态图片输入

对于支持视觉的模型，请把 content 设为块数组，并至少包含一个 text 块和一个 image_url 块。 
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "Describe this image in one sentence."
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "https://example.com/image.jpg"
            }
          }
        ]
      }
    ]
  }'
对于私有图片，可以使用 base64 data URL： 
{
  "type": "image_url",
  "image_url": {
    "url": "data:image/jpeg;base64,<BASE64_IMAGE>"
  }
}
更多 Gemini 原生和 Claude 原生格式示例，请参考 多模态指南。

​
响应

成功响应遵循 OpenAI Chat Completions 结构。 
{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "connected"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 1,
    "total_tokens": 13
  }
}
助手文本通常位于： 
choices[0].message.content

​
Provider 路由

默认情况下为自动路由： 
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello"}]}'
如果要固定 provider，可以发送 vendor： 
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "vendor: openai" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello"}]}'

​
流式输出

把 stream 设为 true 后，可按 SSE 增量返回结果。 
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "stream": true,
    "messages": [
      {
        "role": "user",
        "content": "Explain model routing in two sentences."
      }
    ]
  }'

​
常见错误

状态码原因排查方向
400请求体无效或参数不受支持检查 model、messages 和 JSON 格式。
401API Key 缺失或无效检查 Authorization 请求头。
429命中 provider 限流或并发限制用退避方式重试，或改用自动路由。
500网关或上游 provider 错误安全重试，并保留请求 ID 以便支持排查。
模型 ID 和固定 provider 的更多示例，请参考 模型 和 路由指南。