Martin-hhht

本プロジェクトの背景

国際開発者が中国の最先端モデル — DeepSeek、Kimi、Qwen、MiniMax、Doubao — を利用しようとすると、プロバイダごとに異なる認証方式、請求仕様があり、さらに中国本土の決済手段や事業者認証を求められる場合が多い。自社運用でこれらのモデルを本番環境で利用している経験から、1つのOpenAI互換エンドポイント、1つのAPIキー、16の中国製LLMへの自動ルーティングを実現するゲートウェイを構築した。

結果として HOUJIAYAN API (https://api.houjiayan.com) が誕生した。以下はそのアーキテクチャノートである。

アーキテクチャ

Client (any OpenAI SDK)
   │  https://api.houjiayan.com/v1
   ▼
Cloudflare (WAF / rate limiting / TLS)
   ▼
NewAPI (forked) — channels, API keys, quota, billing
   │        │
   ▼        ▼
Custom smart    Custom payment bridge (standalone service)
router          ├─ WeChat Native Pay (APIv3)
(quality /      └─ NOWPayments (USDT-TRC20)
 balanced /
 cost tiers)
   │
   ▼
16 upstream model channels (11 enrolled in auto-routing)


Gateway: NewAPIのフォーク。新APIは中国LLMエコシステムで広く使われている成熟したオープンソースAPIゲートウェイである。チャネル抽象化、トークン管理、クォータ会計はそのまま利用し、価格設定をカスタマイズして、上流公式価格と完全に一致（マークアップなし）で提供し、コンソール上にライブ価格表を表示している。最低料金は¥1.00 / 1M tokensから。

スマートルータ：独自のステートレスサービス。標準の `/v1/chat/completions`（16モデルいずれかを直接指定可能）に加え、`POST /v1/auto/chat/completions` を公開し、3つのルーティングティアを提供する：

  • quality（デフォルト）：タスククラスに最適な最高品質モデルを選択
  • balanced：品質とコストのバランスが最適なモデル
  • cost：バッチ処理向けの最安妥当モデル

ルータは、タスク特徴（コンテキスト長、コード/散文、想定出力長）に基づいて候補チャネルをスコアリングし、独自の品質ティアテーブルと照合する。16モデル中14モデルが自動プールに参加。上流障害時は次善チャネルへ自動降格する。

決済ブリッジ：最も困難な部分。新APIは決済機能を扱わないため、独立した pay_bridge サービスを構築した。

  • 国内ユーザー向け：WeChat Native Pay APIv3（QRコードネイティブ注文 → 署名付きコールバック → ゲートウェイへの署名付き epay-style 通知）
  • 中国本土外ユーザー向け：NOWPayments（USDT-TRC20）（IPNコールバック → FX換算 → クレジット）

ブリッジは署名付きコールバックプロトコルでゲートウェイと通信し、ゲートウェイがアカウントに直接クレジットする（二重記帳なし）。

学んだ教訓

  1. WeChatの新「プラットフォーム公開鍵」モード。新規加盟店アカウントは旧プラットフォーム証明書チェーンではなく、公開鍵検証（`PUB_KEY_ID_` プレフィックスのキーID）に強制移行される。ほぼすべてのチュートリアルやSDKサンプルがまだ証明書モードを前提としているため、新規アカウントでコールバック署名検証が失敗する場合はこれが原因。
  2. base_url は `/v1` で終わる必要がある。OpenAI SDKは `base_url` にパスを連結するため、`https://api.houjiayan.com` のみでは404になる。エッジでリダイレクトを追加し、ドキュメント冒頭に正しいスニペットを記載した。
python
from openai import OpenAI
client = OpenAI(api_key="sk-...", base_url="https://api.houjiayan.com/v1")
  1. プロバイダ横断の利用量会計。上流がトークン使用量を非一貫に報告する（ストリーム末尾のみ報告するプロバイダも存在）。ゲートウェイ側でパースした使用量に正規化し、報告がなかったストリームにはローカル推定値をフォールバックとして使用し、リクエストごとの監査詳細を保持する。

アクセス＆料金（完全開示）

  • エンドポイント：`https://api.houjiayan.com/v1`（OpenAI互換）；自動ルーティングは `POST /v1/auto/chat/completions`
  • モデル：16の中国製LLMを直接指定可能（DeepSeek V4 Pro/Flash、Kimi K3、MiniMax M3、Qwen3.6/3.7シリーズ、Doubao Seed Codeなど）；11モデルが自動ルーティングプールに参加
  • 料金：上流公式価格と完全一致、マークアップなし；コンソールにライブ価格表あり；最低¥1.00 / 1M tokensから
  • 新規登録クレジット：¥6.6（約$1）の無料トライアルクレジット；継続利用で有効；7日間連続でAPIコールおよびログインがなければ回収
  • チャージ：WeChat Pay（最低¥50、手数料5.5%）；USDT-TRC20（最低$25、手数料5%、中国本土外居住者のみ）
  • 返金：WeChatチャージは未使用の場合24時間以内返金可（手数料除く）；暗号資産チャージは返金不可
  • ドキュメント：https://houjiayan.com/docs/
  • 運営：内蒙古火种智能科技有限公司；[email protected]

今後の展望

現在、ルーティングティアは静的＋タスク特徴スコアリング。将来、過去の成功率・レイテンシ・ユーザー評価を動的チャネル重みに反映させる予定。より多くのモデルと決済手段に対応。複数上流LLMゲートウェイを運用している方との知見共有を歓迎する。

---