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

# 提供商

> 每个模型可能由多个提供商支持，你可以在令牌中配置路由策略，也可以在请求时通过 Header 临时指定。

## 什么是提供商

平台上的每个模型可能由**多个提供商**支持。提供商是按来源和成本划分的服务节点，不同提供商的价格倍率和可用模型各有不同。

发送请求时，系统会根据你的令牌配置，从可用提供商中自动选择一个处理请求。如果某个提供商出现故障或超时，系统会自动重试其他提供商，整个过程对你的代码透明无感。

## 当前可用提供商

| 标识 | 名称 | 说明 |
| - | - | - |
| `official` | 官方 | 提供商组，聚合各大官方平台（OpenAI、Anthropic、Google 等）的直连节点，稳定性最高 |
| `official_cheap` | 官方\_优惠 | 官方渠道的优惠版本，稳定性高，价格更低 |
| `mix` | 混合 | 多来源混合渠道，价格最低，覆盖模型最广 |

### 关于 `official`

`official` 是一个**提供商组**，它将 OpenAI、Anthropic、Google、DeepSeek 等主流官方平台的节点统一归类在一起。选择 `official` 时，系统会在所有官方节点中进行智能路由和故障转移，无需单独指定每个厂商。

### 如何选择

| 你的需求 | 建议配置 |
| - | - |
| 最高稳定性，不在意价格 | `official` |
| 稳定且有一定性价比 | `official_cheap` |
| 价格最低，可接受轻微不稳定 | `mix` |
| 先走优惠官方，失败再回退混合 | `official_cheap,mix` |

***

## 在令牌中配置提供商

在创建或编辑令牌时，可以配置该令牌的默认路由行为。

### 提供商列表

指定令牌允许使用的提供商范围。

* **留空（推荐）**：自动从所有可用提供商中路由，获得最佳可用性
* **填写单个提供商**：如 `official`，仅在官方节点中路由
* **填写多个提供商**：逗号分隔，如 `official_cheap,mix`，按顺序或排序策略依次尝试

### 仅限指定提供商

* **关闭（默认）**：指定提供商优先，失败后自动回退到其他可用提供商
* **开启**：严格限定在指定范围内，不进行任何回退，全部失败则返回错误

### 指定提供商排序

填写多个提供商时，控制尝试顺序：

* **手动（默认）**：按填写顺序依次尝试
* **延迟**：优先尝试响应速度最快的
* **价格**：优先尝试价格最低的
* **吞吐量**：优先尝试吞吐量最高的

***

## 请求时通过 Header 指定

也可以在**每次请求**时通过 Header 临时覆盖令牌设置，只对当次请求生效。

| Header | 作用 |
| - | - |
| `X-Provider-Order` | 指定本次请求使用的提供商及顺序 |
| `X-Provider-Only` | `"true"` 表示严格模式，不回退 |
| `X-Provider-Sort` | 覆盖排序策略（`latency` / `price` / `throughput`） |
| `X-Provider-Ignore` | 本次请求忽略的提供商，叠加在令牌配置之上 |

> 通过 Header 指定的提供商受账号权限限制，无法访问没有权限的提供商。

### 示例

**优先走官方优惠，失败后回退到混合**

```bash theme={null}
curl https://api.ephone.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-your-token" \
  -H "X-Provider-Order: official_cheap,mix" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "你好"}]}'
```

**严格只走官方，不允许任何回退**

```bash theme={null}
curl https://api.ephone.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-your-token" \
  -H "X-Provider-Order: official" \
  -H "X-Provider-Only: true" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-opus-4-5-20251101", "messages": [{"role": "user", "content": "你好"}]}'
```

**在 SDK 中设置默认 Header**

```python Python theme={null}
import openai

client = openai.OpenAI(
    api_key="sk-your-token",
    base_url="https://api.ephone.ai/v1",
    default_headers={
        "X-Provider-Order": "official_cheap,mix",
    }
)
```

```javascript Node.js theme={null}
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-token",
  baseURL: "https://api.ephone.ai/v1",
  defaultHeaders: {
    "X-Provider-Order": "official_cheap,mix",
  }
});
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.