应用识别请求头

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

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

#发送请求头

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"}]}'

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"},
)

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，则仅用标题识别应用。两者都没有时不记录。失败的请求永远不记录。

提示词和输出内容不属于应用识别数据，见数据与隐私。

#在哪里显示

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

#验证配置

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

#常见问题排查

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

想在控制台看到按应用统计的数字。 应用识别不在控制台中展示。请为每个应用分配单独的 API Key，并在用量页面按 Key 筛选。

带请求头的请求返回 401 或其他 4xx。 原因不在这些请求头，请对照错误码检查。

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

#相关文档

• OpenRouter 兼容：其他 OpenRouter 约定。
• 按 Key 限额与预算：按应用追踪消费。
• 数据与隐私。