跳转到主要内容

概述

YouRouter 的一个核心原则,是尽可能提供灵活性与透明度。为此我们遵循一条简单规则: YouRouter 会把你的完整请求体,以及除 Authorization 之外的所有请求头,直接转发给上游提供商。 我们唯一会做的修改,是把你发送给 YouRouter 的 Authorization 请求头替换为对应上游提供商所需的 API Key。 这种设计意味着,只要某个上游提供商发布了新参数或特有能力,你通常都可以立即通过 YouRouter 使用,而不需要等待我们先升级平台适配。如果上游支持,你就可以调用。

示例:使用提供商特有参数

比如你想使用 OpenAI 的特有能力 logprobs。这个参数不属于跨提供商的统一能力集合,但在 YouRouter 里,你依然可以像直连 OpenAI 一样把它放进请求体。
# 这里发送了一个包含非标准参数 `logprobs` 的请求。
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_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
  }'
YouRouter 看到请求体里的 logprobs: truetop_logprobs: 5 后,会将它们不做修改地转发给 OpenAI,返回结果也会尽量保持和你直连该上游时一致。 这种方式同样适用于任何上游支持的自定义请求头或请求体参数。