# 应用识别请求头

> 通过 HTTP-Referer 和 X-Title 请求头向 BigModel.io 标识你的应用，了解具体记录哪些内容。路由和价格不受影响。

网页版: https://bigmodel.io/zh-cn/docs/app-attribution · 更新于 2026-10-18

两个可选请求头可以告诉 BigModel.io 请求来自哪个应用。它们沿用 OpenRouter 的约定，已经在发送这两个头的应用无需改动。

| 请求头 | 值 | 示例 |
|---|---|---|
| `HTTP-Referer` | 应用的 URL（`http` 或 `https`） | `https://your-app.example` |
| `X-Title` | 应用的显示名称 | `Your App` |
| `X-OpenRouter-Title` | 没有 `X-Title` 时使用 | `Your App` |

这些请求头适用于 `/v1/chat/completions`、`/v1/messages` 和 `/v1/responses`，不影响路由、模型选择和价格。

## 发送请求头

```bash [cURL]
curl https://bigmodel.io/v1/chat/completions \
  -H "Authorization: Bearer $BIGMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "HTTP-Referer: https://your-app.example" \
  -H "X-Title: Your App" \
  -d '{"model":"glm-5.3","messages":[{"role":"user","content":"ping"}]}'
```

```python [Python]
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://bigmodel.io/v1",
    api_key=os.environ["BIGMODEL_API_KEY"],
    default_headers={"HTTP-Referer": "https://your-app.example", "X-Title": "Your App"},
)
```

```js [Node.js]
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://bigmodel.io/v1",
  apiKey: process.env.BIGMODEL_API_KEY,
  defaultHeaders: { "HTTP-Referer": "https://your-app.example", "X-Title": "Your App" },
});
```

Anthropic SDK 同样支持 `default_headers`（Python）和 `defaultHeaders`（TypeScript）。

## 记录哪些内容

对成功的请求，BigModel.io 按应用保留一份简要汇总：

- **应用标识。** `HTTP-Referer` 的主机名，转为小写并去掉开头的 `www.`。`https://www.Your-App.example/settings?tab=1` 记录为 `your-app.example`。路径和查询参数永远不会保存。
- **标题。** `X-Title` 的值，去掉控制字符，最多 100 个字符。
- 使用的**模型**。

如果没有 `HTTP-Referer`，或它不是 `http`/`https` URL，则仅用标题识别应用。两者都没有时不记录。失败的请求永远不记录。

提示词和输出内容不属于应用识别数据，见[数据与隐私](https://bigmodel.io/zh-cn/docs/data-privacy)。

## 在哪里显示

应用识别帮助 BigModel.io 了解平台上都有哪些应用，不在控制台中展示。如需按应用拆分自己的消费，请为每个应用使用单独的 API Key，并在[用量](https://bigmodel.io/usage)页面或通过 [GET /v1/usage](https://bigmodel.io/zh-cn/docs/api-usage) 按 Key 筛选。

## 验证配置

发送 cURL 示例，确认返回 200。这些请求头不会在响应或控制台中产生可见效果。如需确认客户端确实发送了它们，请在 HTTP 客户端的调试日志中打印出站请求头。

## 常见问题排查

**加上请求头后没有任何变化。** 这是预期行为：它们不影响路由和价格，应用识别也不在控制台中展示。

**想在控制台看到按应用统计的数字。** 应用识别不在控制台中展示。请为每个应用分配单独的 API Key，并在[用量](https://bigmodel.io/usage)页面按 Key 筛选。

**带请求头的请求返回 401 或其他 4xx。** 原因不在这些请求头，请对照[错误码](https://bigmodel.io/zh-cn/docs/errors)检查。

**应用名称被截断。** 标题最多 100 个字符。

## 相关文档

- [OpenRouter 兼容](https://bigmodel.io/zh-cn/docs/openrouter-compat)：其他 OpenRouter 约定。
- [按 Key 限额与预算](https://bigmodel.io/zh-cn/docs/key-limits)：按应用追踪消费。
- [数据与隐私](https://bigmodel.io/zh-cn/docs/data-privacy)。