omni-providers

概要

REST API を通じて、プロバイダー接続、API キー、OAuth フロー、接続テストを管理します。OmniRoute の 375 のプロバイダーカタログから、AI プロバイダー連携の一覧表示、追加、更新、削除、テストを行えます。

認証

すべてのリクエストには、有効な Bearer トークンまたはセッション Cookie が必要です。POST /api/auth/login でトークンを取得するか、ローカル開発用に REQUIRE_API_KEY=false を設定してください。

エンドポイント

• GET /api/providers
• POST /api/providers
• GET /api/providers/{id}
• PATCH /api/providers/{id}
• DELETE /api/providers/{id}
• POST /api/providers/{id}/test
• GET /api/providers/{id}/test-message
• POST /api/providers/{id}/test-message
• PUT /api/providers/{id}/test-message
• GET /api/providers/{id}/models
• GET /api/providers/cursor/agent-availability
• POST /api/providers/test-batch
• POST /api/providers/validate
• GET /api/providers/client
• POST /api/providers/agy-auth/import
• POST /api/providers/agy-auth/import-bulk
• POST /api/providers/agy-auth/zip-extract
• POST /api/providers/agy-auth/apply-local
• GET /api/provider-nodes
• POST /api/provider-nodes
• PATCH /api/provider-nodes/{id}
• DELETE /api/provider-nodes/{id}
• POST /api/provider-nodes/validate
• GET /api/provider-models
• PUT /api/provider-models
• POST /api/provider-models/validate-and-add
• GET /api/providers/{id}/cc-alias
• PUT /api/providers/{id}/cc-alias
• GET /api/providers/{id}/chatgpt-web-codex-doctor
• POST /api/providers/{id}/claude-auth/apply-local
• POST /api/providers/{id}/claude-auth/export
• POST /api/providers/{id}/codex-auth/apply-local
• POST /api/providers/{id}/codex-auth/export
• GET /api/providers/{id}/interception-rules
• PUT /api/providers/{id}/interception-rules
• DELETE /api/providers/{id}/interception-rules
• POST /api/providers/{id}/login
• GET /api/providers/{id}/param-filters
• PUT /api/providers/{id}/param-filters
• DELETE /api/providers/{id}/param-filters
• POST /api/providers/{id}/refresh
• POST /api/providers/{id}/refresh-cursor
• POST /api/providers/{id}/refresh-token
• POST /api/providers/{id}/sync-models
• POST /api/providers/bulk
• POST /api/providers/bulk-web-session
• POST /api/providers/claude-auth/import
• POST /api/providers/claude-auth/import-bulk
• POST /api/providers/claude-auth/zip-extract
• POST /api/providers/codex-auth/import
• POST /api/providers/codex-auth/import-bulk
• POST /api/providers/codex-auth/zip-extract
• POST /api/providers/command-code/auth/apply
• POST /api/providers/command-code/auth/callback
• POST /api/providers/command-code/auth/start
• GET /api/providers/command-code/auth/status
• POST /api/providers/command-code/auth/status
• GET /api/providers/expiration
• GET /api/providers/free-onboarding
• POST /api/providers/free-onboarding
• GET /api/providers/health-autopilot
• POST /api/providers/health-autopilot/actions
• GET /api/providers/health-matrix
• POST /api/providers/import
• GET /api/providers/openrouter-stats
• GET /api/providers/quota-windows
• POST /api/providers/volcengine-plan/connect
• POST /api/providers/volcengine-plan/connect/{sessionId}/cancel
• POST /api/providers/volcengine-plan/connect/{sessionId}/code
• POST /api/providers/volcengine-plan/connect/{sessionId}/identity
• POST /api/providers/volcengine-plan/connect/{sessionId}/resend
• GET /api/providers/volcengine-plan/connect/{sessionId}/status
• GET /api/providers/web-session-contract
• POST /api/providers/zed/discover
• POST /api/providers/zed/import
• POST /api/providers/zed/manual-import

ペイロード

詳細なリクエスト／レスポンススキーマについては、GET /api/openapi/spec または docs/openapi.yaml の OpenAPI 仕様全体を参照してください。

その他のエンドポイント

POST /api/providers/{id}/refresh

プロバイダー接続の OAuth トークンをローテーションまたは更新するか、認証情報を再検証します。トークンの有効期限が切れた後や、接続を削除せずに認証情報を更新する必要がある場合に便利です。

curl -X POST https://localhost:20128/api/providers/{id}/refresh \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

GET /api/provider-metrics

すべてのプロバイダー接続の集計された使用状況およびパフォーマンスメトリクス（リクエスト数、エラー率、レイテンシのパーセンタイル、トークン使用量）を取得します。ダッシュボードと Auto-Combo のスコアリングで使用されます。

curl https://localhost:20128/api/provider-metrics \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"

レスポンス例：

{
  "providers": [
    {
      "id": "my-openai",
      "requestCount": 1240,
      "errorRate": 0.02,
      "p50LatencyMs": 340,
      "p99LatencyMs": 1200,
      "tokensIn": 500000,
      "tokensOut": 250000
    }
  ]
}

GET /api/providers/health-matrix

すべてのプロバイダーについて、接続ごとのステータス、サーキットブレーカーの状態、クールダウンの期限を含むヘルスマトリックスを返します。ルーティングの判断をデバッグする際に便利です。

curl https://localhost:20128/api/providers/health-matrix \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"