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

# 面向服务商

> 将您的模型和端点集成到 ARouter，通过统一 API 触达使用该平台的开发者。

ARouter 通过单一 API 为开发者提供数百个模型的访问。如果您运营 AI 模型或推理服务，与 ARouter 集成可让您直接触达那些已在 ARouter API 上构建应用的开发者——无需他们更改代码。

## 为什么与 ARouter 合作

* **即时触达开发者** — 使用 ARouter 的开发者无需注册独立账户或 SDK 即可立即访问您的模型
* **零摩擦切换** — 开发者只需修改一个字符串（`model: "yourprovider/your-model"`）即可试用您的模型
* **流量增长** — 您的模型出现在 ARouter 模型目录中，并可通过统一的 `/v1/models` 端点访问
* **透明定价** — 您设定价格；ARouter 向最终用户准确呈现

***

## 集成要求

要与 ARouter 集成，您的 API 必须提供：

### 1. OpenAI 兼容端点

ARouter 使用 OpenAI API 格式进行请求路由。您的端点应接受：

```
POST /v1/chat/completions
```

使用标准 OpenAI 请求/响应格式，包括通过 Server-Sent Events（SSE）的流式传输。

### 2. 模型 ID

您暴露的每个模型应具有唯一且稳定的模型 ID。ARouter 使用 `provider/model` 命名约定：

```
yourprovider/your-model-name
```

### 3. 使用量报告

您的响应必须包含带有准确 Token 计数的 `usage` 对象：

```json theme={null}
{
  "usage": {
    "prompt_tokens": 100,
    "completion_tokens": 50,
    "total_tokens": 150
  }
}
```

***

## ARouter 负责处理的内容

集成后，ARouter 将为您的用户透明处理以下事项：

| 职责         | ARouter       | 您的 API    |
| ---------- | ------------- | --------- |
| API Key 管理 | 使用注入的凭证路由请求   | 验证凭证      |
| 服务商健康监控    | 熔断器 + 密钥池健康检查 | 响应请求      |
| 速率限制       | 追踪每个密钥和用户的限制  | 执行您的速率限制  |
| 使用量记录      | 记录 Token 和成本  | 在响应中返回使用量 |
| 流式传输       | 透传 SSE 流      | 生成 SSE 流  |
| 错误规范化      | 标准化错误代码       | 返回原生错误    |

***

## 模型元数据

ARouter 通过 `/v1/models` 端点向开发者提供丰富的模型元数据。您可以为每个模型提供：

```json theme={null}
{
  "id": "yourprovider/your-model",
  "name": "Your Model Name",
  "description": "A brief description of capabilities.",
  "context_length": 128000,
  "architecture": {
    "input_modalities": ["text", "image"],
    "output_modalities": ["text"],
    "tokenizer": "cl100k_base",
    "instruct_type": "chatml"
  },
  "pricing": {
    "prompt": "0.000002",
    "completion": "0.000006"
  },
  "supported_parameters": ["tools", "temperature", "max_tokens", "structured_outputs"]
}
```

***

## 支持的端点类型

| 端点类型                    | 说明                                |
| ----------------------- | --------------------------------- |
| OpenAI Chat Completions | 支持流式传输的标准聊天                       |
| OpenAI Embeddings       | 通过 `/v1/embeddings` 的文本嵌入         |
| Anthropic Messages      | 原生 Anthropic 消息格式                 |
| Gemini GenerateContent  | 原生 Gemini 格式                      |
| 自定义端点                   | 通过服务商代理（`/{yourprovider}/{path}`） |

***

## 服务商代理

开发者也可以通过 ARouter 的服务商代理直接向您的 API 发送请求，完全绕过模型路由层：

```
POST /{yourprovider}/v1/chat/completions
```

这对于希望使用您的原生 API 格式同时仍受益于 ARouter 的密钥管理和计费功能的开发者非常有用。

***

## 快速开始

将您的模型集成到 ARouter：

1. **联系我们**，发送邮件至 [providers@arouter.ai](mailto:providers@arouter.ai)，附上您的 API 文档和模型目录
2. **提供凭证** — ARouter 使用的 API Key 或 OAuth 凭证
3. **检查模型元数据** — 确认模型 ID、定价、上下文长度和支持的参数
4. **测试集成** — ARouter 团队验证路由和响应格式兼容性
5. **上线** — 您的模型将出现在 ARouter 目录中，立即可访问

***

## 数据处理

ARouter 尊重您的数据政策：

* 请求/响应数据**默认不存储** — 参阅[数据采集](/zh/guides/privacy/data-collection)
* 您可以指定您的端点是否支持**零数据保留（ZDR）**
* 开发者可以按请求选择是否启用数据采集

***

## 定价与收益

ARouter 向开发者准确呈现您的定价。您设定每 Token 的价格；ARouter 不对标准路由添加任何加价。

开发者通过 ARouter 计费，您将按约定费率获得补偿。商务条款请联系 [providers@arouter.ai](mailto:providers@arouter.ai)。