应用归因

让你的应用出现在 OpenRouter 排行榜和分析中

应用归因（App Attribution）让开发者将 API 用量与自己的应用关联起来，从而出现在 OpenRouter 的公开排名和详细分析中。只需在请求中加入简单的请求头，你的应用就能出现在排行榜上，并获得模型用量模式方面的洞察。

应用归因的好处

正确标注应用用量后，你可以获得：

• 公开应用排名：你的应用会出现在 OpenRouter 的 公开排名 中，包含日榜、周榜和月榜
• 模型应用标签页：你的应用会出现在各个模型页面上，展示哪些应用最常使用该模型
• 详细分析：查看全面的分析数据，包括应用随时间变化的模型用量、Token 消耗和用量模式
• 专业曝光：向 OpenRouter 开发者社区展示你的应用

归因请求头

OpenRouter 通过以下 HTTP 请求头跟踪应用归因：

HTTP-Referer（必填）

HTTP-Referer 请求头用于标识应用的 URL，并作为排名的主键。应用归因必须提供此请求头。 没有它，系统不会创建应用页面，你的用量也不会出现在排名中。应用的 URL 会成为系统中的唯一标识符。

X-OpenRouter-Title

X-OpenRouter-Title 请求头用于设置或修改应用在排名和分析中的显示名称。为保持向后兼容，X-Title 仍然可用。仅设置此请求头不会创建应用页面，必须与 HTTP-Referer 一起使用。

X-OpenRouter-Categories

X-OpenRouter-Categories 请求头将应用归入一个或多个市场分类。每次请求最多可传入 2 个以逗号分隔的分类。分类必须为小写、以连字符分隔，且每个分类不超过 30 个字符。仅接受下方列表中的已知分类；无法识别的分类会被 OpenRouter 静默丢弃，不会报错。新分类会与已有分类合并（总计最多 10 个）。

分类分组

分类按组整理，用于 应用市场：

编程（软件开发工具）：

• cli-agent：基于终端的编程助手
• ide-extension：编辑器 / IDE 集成
• cloud-agent：云端托管的编程智能体
• programming-app：编程类应用
• native-app-builder：移动和桌面应用构建器

创意（创意类应用）：

• creative-writing：创意写作工具
• video-gen：视频生成应用
• image-gen：图像生成应用
• audio-gen：音频生成应用

生产力（写作与效率工具）：

• writing-assistant：AI 写作工具
• general-chat：通用聊天应用
• personal-agent：个人 AI 智能体
• legal：法律工具与助手

娱乐（娱乐类应用）：

• roleplay：角色扮演及其他基于角色的聊天应用
• game：游戏与互动娱乐应用

自定义分类

仅接受上方列表中的已知分类。 OpenRouter 会静默丢弃无法识别的值，不会报错。如果你的用例无法归入现有分类，请联系我们，我们可能会在未来新增分类。

实现示例

import { OpenRouter } from '@openrouter/sdk';

const openRouter = new OpenRouter({
  apiKey: '<OPENROUTER_API_KEY>',
  httpReferer: 'https://myapp.com', // 你的应用 URL
  appTitle: '我的 AI 助手', // 应用的显示名称
  appCategories: 'cli-agent,cloud-agent', // 可选分类
});

const completion = await openRouter.chat.send({
  model: 'openai/gpt-5.2',
  messages: [
    {
      role: 'user',
      content: '你好，世界！',
    },
  ],
  stream: false,
});

console.log(completion.choices[0].message);

你的应用会出现在哪里

应用排名

完成归因的应用会出现在 OpenRouter 的主排名页面 openrouter.ai/rankings。排名展示：

• 热门应用：按 Token 用量统计的最大公开应用
• 时间范围：日、周、月视图
• 用量指标：所有模型的 Token 总消耗

模型应用标签页

在各个模型页面上（例如 GPT-4o），你的应用会出现在「应用」标签页中，展示：

• 热门应用：最常使用该模型的应用
• 周排名：根据用量每周更新
• 用量对比：你的应用与其他使用同一模型的应用相比如何

单个应用的分析

应用被跟踪后，你可以在 openrouter.ai/apps?url=<your-app-url> 查看详细分析，包括：

• 模型用量随时间变化：展示应用使用了哪些模型的图表
• Token 消耗：提示词 Token 和补全 Token 的详细拆分
• 用量模式：用于了解应用 AI 用量趋势的历史数据

最佳实践

URL 要求

• 始终包含 HTTP-Referer。 这是应用归因的最低要求。
• 使用应用的主域名（例如 https://myapp.com）
• 除非子域名代表不同的应用，否则避免使用子域名
• 在 localhost 上开发时，务必同时包含 X-OpenRouter-Title
• 可在 openrouter.ai/apps?url=<your-referer-url> 查看应用页面

标题指南

• 标题应简洁、具有描述性
• 使用用户所熟知的实际应用名称
• 避免使用「AI 应用」或「聊天机器人」这类泛称

隐私注意事项

• 只有公开应用（即发送了请求头的应用）才会进入排名
• 归因请求头不会暴露请求中的敏感信息

相关文档

• 快速开始指南 - 带归因请求头的基础设置
• API 参考 - 完整的请求头文档
• 用量统计 - 了解你的 API 用量