API 中継とは：仕組み、リスク、選定チェックリスト

リクエストが中継サービスを通る経路

まず用語を明確にします。「中継 API」とは、あなたのプログラムとモデルを実行するバックエンドの間に、標準 API を公開するゲートウェイを置くことです。コードは OpenAI 形式でリクエストを送信し続けますが、base_url をゲートウェイのアドレスに指し、API キーをゲートウェイから発行されたものに変更します。

このゲートウェイは通常、3つのことを行います。

• リクエストの転送：リクエストボディの形式を検証し、必要に応じてデフォルトパラメータを補完してからバックエンドに渡します。バックエンドからのレスポンス（ストリーミング中の SSE 断片を含む）は、そのまままたは軽微な加工を施してあなたに返します。
• 鍵のマッピング：あなたが保持するのはゲートウェイが発行した鍵であり、ゲートウェイ内でのみ意味を持ちます。ゲートウェイはこれによりあなたの正体、残高、呼び出し可能なモデルを識別します。バックエンドと実際にやり取りする認証情報はゲートウェイ内部に留まり、あなたのコードには現れません。
• 課金とレート制限：各リクエストの完了後、ゲートウェイは usage 内の入力・出力トークン数に単価を乗じて残高を減算し、API キーごとに 1 分あたりのリクエスト数をカウントします。制限を超えると 429 を返します。

これら 3 つの要素を結びつけて見ると、中継サービスの体験に大きな差がある理由が理解できます。転送層の実装がレイテンシの揺らぎとストリーミングの安定性を決定し、鍵層が漏洩時の被害範囲を決定し、課金層が請求書の透明性と照合可能性を決定します。

単一モデルの直接接続サービスとの違い

直接接続サービスとは、モデル提供元の公式ドメインに直接リクエストを送ることを指し、通常は 1 アカウントにつき 1 套のモデル、課金ルール、ドキュメントが対応します。中継サービスには主に 2 つの形態があり、違いは「後段に何がつながっているか」にあります。

比較の観点	直接接続単一サービス	集約型中継	単一モデル中継
モデル数	提供元の数個	数十から数百	1 つ
インターフェース形式	各社固有の形式	OpenAI 互換に統一	OpenAI 互換
デバッグの難易度	最短で、レイテンシが最小	最高、モデル名のマッピングが多い	低い、モデルが 1 つだけ
適したユースケース	1 社の安定した業務のみ	モデルの頻繁な切り替えと比較が必要	固定モデル、予測可能性を追求

もしあなたの業務が 1 つのモデルにのみ依存している場合、集約の恩恵は得られず、「モデル名が誰に対応するか」という不確実性を負うことになります。逆に、毎週モデルを切り替えて比較テストを行う必要がある場合、集約型は多くの適応作業を省きます。絶対的な優劣はなく、自分がどのカテゴリに属するかを把握することが重要です。

当サイトは最後のタイプに属します：1 つのモデルのみを提供し、モデル id は uncensored、インターフェースは OpenAI 互換のチャット補完です。この種のトレードオフとコストについては、無制限 AI API のコストとトレードオフをご覧ください。

最も一般的な 3 つのリスク

鍵のセキュリティ

中継用 API キーはプリペイドカードのようなもので、誰かが取得すればあなたの残高を使えます。よくある漏洩経路は、API キーをフロントエンドコードに書き込む、公開リポジトリにコミットする、サポートチケットやグループチャットのスクリーンショットに貼り付けることです。API キーはサーバーサイド環境変数にのみ配置し、フロントエンドは常にあなたのバックエンドを介してリクエストを転送することをお勧めします。漏洩の疑いがある場合は直ちにリセットし、古い API キーは直ちに無効になるべきです。また、サービスが自己でのリセットをサポートしているか、リセット後に古い API キーが即時無効になるか（数時間後に有効になるなどではないか）を確認してください。

モデルの置換

これは集約型サービスで最も議論される問題です：A をリクエストしても、実際には安価な B が返ってくることがあります。ドキュメントからは判断できず、動作で検証する必要があります。標準回答付きの小さなテストセットを固定し、temperature を固定して繰り返しテストし、出力スタイルが安定しているか確認します。また、/v1/models をリクエストして、リストが課金ページと一致するか確認できます。モデル名が曖昧だったり、同じ名前でも時間によって挙動が大きく異なる場合は、警戒が必要です。

レート制限の不透明さ

一部のサービスはドキュメントに「適正な使用」とだけ記載し、実際にはピーク時に静かに速度を落としたりリクエストをドロップしたりし、あなたのプログラムは偶発的なタイムアウトとして振る舞います。成熟したアプローチは、各鍵の毎分のリクエスト数を明記し、超過時に標準的な 429 を返し、接続をフリーズさせないことです。選定時には必ず確認してください：レート制限は鍵単位かアカウント単位か、超過時に何が返されるか、クレジットが尽きた際に独立したエラーコードが返されるか。

ミドルウェアサービス選択チェックリスト

以下のチェックリストは評価ドキュメントにそのままコピーして、項目ごとにチェックできます。

1. 公開された GET /v1/modelsエンドポイントが提供されており、返されるモデル一覧と価格ページが一致していますか？
2. エラーレスポンスは構造化されたJSONで、codeとmessageを含み、401、402、429、503がそれぞれ区別されていますか？
3. API キーごとの 1 分あたりのリクエスト上限がドキュメントに記載されているか、カスタマーサポートの口頭説明だけではないか？
4. コンテキストウィンドウの長さ、1回の最大出力トークン数、リクエストボディのサイズに明確な数値が示されていますか？
5. 課金が usage 内のトークン数に基づいて正確に減算されるか、残高をいつでも確認できるか？
6. 前払いクレジットの残高は期限切れになりますか？無料トライアルクレジットの有効期間が明確に示されていますか？
7. API キーは自己でリセット可能で、古いキーは即時無効になりますか？
8. ストリーミング出力に対応しているか、最終レスポンスに usage 統計が含まれており、自分で請求額を照合できるか？
9. プロンプトがトレーニングに使用されるかどうかについて、明確な一言の説明がありますか？
10. サポートされていない機能（ベクトル、画像、音声など）は曖昧にせず、正確に表示されていますか？

満点は現実的ではありませんが、最初の5項目で2つ以上回答できない場合は、一度に多額のチャージを行う前に、少額で試用することをお勧めします。

API キー取得後の10分間の検証

どのサービスを選んでも、本番環境にデプロイする前に10分かけて基本的な検証を行う価値があります。最初のステップとして、モデル一覧をリストアップし、返されるidが期待通りであることを確認します：

复制curl -s https://api.llmzhongzhuan.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

2 番目に、小さなリクエストを送信し、レスポンスに usage フィールドが存在するか、その数値が妥当かどうかを同時に確認します。以下の例では、モデルに日付を復述させ、未知の情報を捏造しないかを確認します。これは厳密な評価ではなく、大まかな動作チェックです：

复制curl -s https://api.llmzhongzhuan.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "用一句话介绍你自己，然后复述今天的日期是几号。"}],
    "max_tokens": 200
  }' 

この 2 つの手順をデプロイスクリプトに組み込み、API キーやサービスを変更するたびに実行してください。レスポンスに usage が含まれていない場合、または usage の数値が入力長と明らかに一致しない場合は、課金の透明性に問題があることを意味します。高額使用前にこれを明確にしてください。各種フレームワークへの接続方法については、フレームワーク設定ガイドをご覧ください。

チェックリストと照合するための当サービスのパラメータ

上記のチェックリストを使って項目ごとに照合し、ドキュメントを行き来する必要がないよう、当サービスの実際のパラメータを以下にリストします。

• エンドポイント：https://api.llmzhongzhuan.com/v1、POST /v1/chat/completionsとGET /v1/modelsをサポートし、認証にはBearerトークンを使用します。
• モデルは1つだけで、idは uncensoredです。テキストのみで、ベクトル、画像、音声、ビデオ、ファインチューニングはサポートしていません。
• コンテキストウィンドウは合計100,000トークン（入力と出力の合計）、max_tokensのデフォルトは2048、1回あたりの最大値は32,000です。リクエストボディは8 MB以下です。
• キーごとに毎分300リクエストまで、上限を超えると429を返します。503のupstream_busyは後で再試行してください。残高が尽きた場合や無料トライアルが期限切れになった場合は、402のno_creditを返します。
• 価格は入力100万トークンあたり0.25ドル、出力100万トークンあたり1.00ドルで、前払いチャージ、サブスクリプションなし、残高は期限切れになりません。
• プロンプトはトレーニングに使用されません。

具体的な数値は価格ページとドキュメントを基準としてください。新規アカウントには0.50ドルの無料トライアルクレジットが付与され、有効期間は7日間です。支払い情報の入力は不要で、まずこのクレジットを使って上記の検証フローを完了させることができます。