> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yourouter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 请求透传

> YouRouter 会将你的整个请求体以及除 Authorization 外的所有请求头直接转发给上游提供商。

## 概述

YouRouter 的一个核心原则，是尽可能提供灵活性与透明度。为此我们遵循一条简单规则：

**YouRouter 会把你的完整请求体，以及除 `Authorization` 之外的所有请求头，直接转发给上游提供商。**

我们唯一会做的修改，是把你发送给 YouRouter 的 `Authorization` 请求头替换为对应上游提供商所需的 API Key。

这种设计意味着，只要某个上游提供商发布了新参数或特有能力，你通常都可以立即通过 YouRouter 使用，而不需要等待我们先升级平台适配。如果上游支持，你就可以调用。

## 示例：使用提供商特有参数

比如你想使用 OpenAI 的特有能力 `logprobs`。这个参数不属于跨提供商的统一能力集合，但在 YouRouter 里，你依然可以像直连 OpenAI 一样把它放进请求体。

<CodeGroup>
  ```bash cURL theme={null}
  # 这里发送了一个包含非标准参数 `logprobs` 的请求。
  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 world!"}],
      "logprobs": true,
      "top_logprobs": 5
    }'
  ```

  ```python Python theme={null}
  import os
  from openai import OpenAI

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

  # 你可以在 create 方法中直接传递提供商特有参数。
  # OpenAI Python SDK 会把它们原样写入请求体。
  response = client.chat.completions.create(
      model="gpt-4o",
      messages=[{"role": "user", "content": "Hello world!"}],
      logprobs=True,
      top_logprobs=5,
      extra_headers={"vendor": "openai"}
  )

  logprobs = response.choices[0].logprobs
  print(logprobs)
  ```
</CodeGroup>

YouRouter 看到请求体里的 `logprobs: true` 和 `top_logprobs: 5` 后，会将它们不做修改地转发给 OpenAI，返回结果也会尽量保持和你直连该上游时一致。

这种方式同样适用于任何上游支持的自定义请求头或请求体参数。