跳转到主要内容
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 对象:
{
  "usage": {
    "prompt_tokens": 100,
    "completion_tokens": 50,
    "total_tokens": 150
  }
}

ARouter 负责处理的内容

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

模型元数据

ARouter 通过 /v1/models 端点向开发者提供丰富的模型元数据。您可以为每个模型提供:
{
  "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,附上您的 API 文档和模型目录
  2. 提供凭证 — ARouter 使用的 API Key 或 OAuth 凭证
  3. 检查模型元数据 — 确认模型 ID、定价、上下文长度和支持的参数
  4. 测试集成 — ARouter 团队验证路由和响应格式兼容性
  5. 上线 — 您的模型将出现在 ARouter 目录中,立即可访问

数据处理

ARouter 尊重您的数据政策:
  • 请求/响应数据默认不存储 — 参阅数据采集
  • 您可以指定您的端点是否支持零数据保留(ZDR)
  • 开发者可以按请求选择是否启用数据采集

定价与收益

ARouter 向开发者准确呈现您的定价。您设定每 Token 的价格;ARouter 不对标准路由添加任何加价。 开发者通过 ARouter 计费,您将按约定费率获得补偿。商务条款请联系 providers@arouter.ai