everyapi
連携 · LLM オブザーバビリティOpenAI 互換 · 1 つのキー · ライブカタログ
H

EveryAPI ゲートウェイを次の環境で動かす: Helicone

Helicone のプロキシモードは、OpenAI 互換リクエストを対象 URL に転送し、可観測性データを収集できます。EveryAPI と連結する前に、追加のデータ処理者、ネットワークホップ、ヘッダー、障害時の挙動を確認してください。

01セットアップコード

base URL を 1 行書くだけで Helicone を EveryAPI に向けられます

デフォルトのグローバル Base URL / 中国向け優先 Base URL: https://api.everyapi.ai/v1 / https://api-cn.everyapi.ai/v1

app.py
# Helicone プロキシ モード: ベース URL を oai.helicone.ai/v1 に変更します。
# そして、Helicone-Target-Url ヘッダーを使用して実際のアップストリーム (EveryAPI) を指定します
 
from openai import OpenAI
 
client = OpenAI(
base_url="https://oai.helicone.ai/v1",
api_key="sk-everyapi-...", # EveryAPI キー
default_headers={
"Helicone-Auth": "Bearer sk-helicone-...", # Helicone キー
"Helicone-Target-Url": "https://api.everyapi.ai", # 前方ターゲット
},
)
 
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[[{"role": "user", "content": "Hello"}]],
)
02手順

ゼロから最初の呼び出しまで

  1. Helicone に登録

    us.helicone.ai でサインアップして sk-helicone- キーを取得します(docker でワンコマンドのセルフホストも可能です)。

    us.helicone.ai

  2. proxy と async logger のどちらにするかを決める

    Proxy モードでは base URL を oai.helicone.ai/v1 に変更し、Helicone-Target-Url を EveryAPI に向けます。Async logger ではリクエストを EveryAPI に直接送り、テレメトリを別に送信します。ネットワーク、プライバシー、障害時の違いを環境内で検証してください。

  3. API キーの関係

    Helicone キーを Helicone-Auth ヘッダーに、EveryAPI キーを Authorization(OpenAI クライアントの api_key)に入れます。Helicone は Helicone-Target-Url を使ってリクエストを EveryAPI に転送し、OpenAI キー ヘッダーを EveryAPI へ透過します。

  4. Helicone ダッシュボードで トレースを表示する

    us.helicone.ai/requests にアクセスすると、各呼び出しの 入力 / 出力 / レイテンシ / コスト / tokens を確認できます。コストの数値はモデルごとの推定で、EveryAPI の実際の課金とは差異があります(Langfuse と同様)。