メインコンテンツへスキップ
ARouter は、API リクエストでアプリケーションを識別するためのオプションの HTTP ヘッダーをサポートしています。これらのヘッダーは ARouter Dashboard でのソーストラッキングに使用され、単一のアカウント下の複数のプロジェクトやワークフローにわたるアプリごとの分析と使用量の内訳を提供します。

ヘッダー

HTTP-Referer

アプリケーションの URL。リクエストのソースを識別するために使用されます。
HTTP-Referer: https://myapp.com

X-Title

アプリケーションの表示名。Dashboard のアクティビティビューに表示されます。
X-Title: My AI App

実装

ARouter API へのリクエストにこれらのヘッダーを含めます:
from openai import OpenAI

client = OpenAI(
    base_url="https://api.arouter.ai/v1",
    api_key="lr_live_xxxx",
    default_headers={
        "HTTP-Referer": "https://myapp.com",
        "X-Title": "My AI App",
    },
)

response = client.chat.completions.create(
    model="openai/gpt-5.4",
    messages=[{"role": "user", "content": "Hello!"}],
)

アプリカテゴリ

ARouter のアナリティクスで正しく表示されるようにアプリを分類します:
カテゴリ説明
Coding開発ツール、IDE、コードアシスタント
Creativeライティング、画像生成、アートツール
Productivityドキュメント処理、要約、自動化
Research知識検索、分析、学術ツール
Entertainmentゲーム、チャット、ロールプレイ
Other上記に当てはまらないもの
X-Title ヘッダーの一部としてカテゴリを渡すか、インテグレーションがサポートしている場合は専用ヘッダーとして渡します。カテゴリはアプリ名とともに Dashboard アナリティクスに表示されます。

Dashboard アクティビティ

アトリビューションヘッダーを含めると、ARouter Dashboard に以下が表示されます:
  • アプリ名: アクティビティフィードとリクエストごとのアナリティクスに表示
  • ソース URL: アプリケーションドメインでリクエストをグループ化するために使用
  • カテゴリ: アプリタイプ別の使用量内訳に表示
  • アプリごとの使用量: 帰属されたアプリの Token 消費、コスト、リクエスト量
以下のような場合に特に有用です:
  • 1つのアカウントで複数のアプリケーションを管理する場合
  • 異なるアプリバージョン間で A/B テストを実行する場合
  • どのワークフローが最も多くの使用量を生み出しているか把握する場合

アトリビューションのメリット

  • アプリ別使用量内訳 — どのアプリが最も多くの Token とコストを消費しているかを確認
  • トラフィック分析 — アプリごとのリクエスト量パターンを把握
  • 最適化シグナル — 最適化のための高コストワークフローを特定
アトリビューションヘッダーは ARouter 側のみで処理され、モデルの動作、ルーティング、または上流プロバイダーには影響しません。