本文へスキップ
HopBase ドキュメント
ログイン

Base URL とプロトコル

モデルとクライアントごとに、HopBase の OpenAI 互換または Anthropic 互換の URL を選択します。

シナリオプロトコルBase URL
Claude モデル(Claude Code、Anthropic SDK)Anthropic Messages のみ — /v1/chat/completions と /v1/responses は非対応https://api.hop-base.com
Codex CLIOpenAI Responseshttps://api.hop-base.com/v1
GPT チャットOpenAI Chat Completions または Responses。Anthropic Messages にも対応し、Claude Code から直接接続可https://api.hop-base.com/v1、Anthropic は https://api.hop-base.com
Gemini チャット(「Gemini 全モデル（画像生成含む）」プラン)OpenAI Chat Completions または Responses。Anthropic Messages にも対応し、Claude Code から直接接続可。Codex CLI は非対応https://api.hop-base.com/v1、Anthropic は https://api.hop-base.com
Gemini チャット(「Gemini 公式ダイレクト」プラン)OpenAI Chat Completions または Responses。Anthropic Messages にも対応し、Claude Code から CC Switch 経由で直接接続可(モデル名は Gemini のモデル ID)。3 プロトコルともツール呼び出しに対応(詳細)https://api.hop-base.com/v1、Anthropic は https://api.hop-base.com
Grok チャットOpenAI Chat Completions または Responses。Anthropic Messages にも対応し、Claude Code から直接接続可。Codex CLI は非対応https://api.hop-base.com/v1、Anthropic は https://api.hop-base.com
Qwen チャットOpenAI Chat Completions または Responses。Anthropic Messages にも対応し、Claude Code から直接接続可https://api.hop-base.com/v1、Anthropic は https://api.hop-base.com
Doubao Seed チャットOpenAI Chat Completions または Responses。Anthropic Messages にも対応https://api.hop-base.com/v1、Anthropic は https://api.hop-base.com
DeepSeek V4 / V4.1OpenAI Chat Completions または Responses。Anthropic Messages にも対応し、Claude Code から直接接続可https://api.hop-base.com/v1、Anthropic は https://api.hop-base.com
DeepSeek・GLM 米国リージョン(-us)OpenAI Chat Completions、Responses、Anthropic Messages のすべてに対応し、Claude Code から直接接続可。米国リージョンを参照https://api.hop-base.com/v1、Anthropic は https://api.hop-base.com
GLM-5.3 / GLM-5.3 Flash(「GLM 公式ダイレクト」プラン)OpenAI Chat Completions のみ — /v1/responses と /v1/messages は非対応で 400 を返します。Codex CLI からは接続できず、Claude Code では CC Switch のローカルルーティングが必要https://api.hop-base.com/v1
Kimi K3OpenAI Chat Completions のみ — /v1/responses と /v1/messages は非対応で 404 を返します。Codex CLI からは接続できず、Claude Code では CC Switch のローカルルーティングが必要https://api.hop-base.com/v1
GPT Image、Gemini Banana、SeedreamOpenAI Imageshttps://api.hop-base.com/v1

表に記載のないプロトコルには対応していません。Gemini にはネイティブの :generateContent パスもなく、この API では x-goog-api-key も使えません。

HopBase は OpenAI 互換・Anthropic 互換の両プロトコルに対応しており、どちらを使うかはクライアントとモデルの種類によって決まり、キーの形式では決まりません。

よく使うエンドポイント

OpenAI・OpenRouter・Anthropic からの移行はHopBase への移行を、/v1/models・/v1/usage・公開カタログのレスポンス項目はアカウント・カタログ APIを参照してください。

機能エンドポイント
モデル検出GET /v1/models
現在のキーの残高・利用状況GET /v1/usage
公開モデルカタログと定価(キー不要)GET /api/v1/models/pricing
OpenAI チャットPOST /v1/chat/completions
OpenAI ResponsesPOST /v1/responses
Anthropic MessagesPOST /v1/messages
画像生成POST /v1/images/generations
画像編集POST /v1/images/edits
音声合成POST /v1/audio/speech / POST /v1/t2a_v2
非同期画像タスクのポーリングGET /v1/images/tasks?task_id=
素材アップロード(非同期タスク用の参照画像・動画)POST /v1/sd/assets
動画生成の送信POST /v1/video/generate
動画タスクのポーリングGET /v1/video/tasks/{task_id}
Kling の顔検出POST /v1/kling/faces
Kling のサブジェクトPOST /v1/kling/subjects / GET /v1/kling/subjects
Wan / HappyHorse 動画の送信POST /api/v1/services/aigc/video-generation/video-synthesis
Wan / HappyHorse タスクのポーリングGET /api/v1/tasks/{task_id}

POST /v1/video/generate と GET /v1/video/tasks/{task_id} は、非同期の動画系ファミリーすべてで共通のエンドポイントです。Seedance、MiniMax、Kling、Grok の動画はいずれもこの 2 つのパスで送信・ポーリングを行い、異なるのはリクエストボディとモデル ID のみです。Kling に必要なのは HopBase の Base URL と API キーだけです。

Wan / HappyHorse はネイティブのパスをそのまま使用します — /v1 は付きません：

Wan 3.0 と HappyHorse は、上記の /v1/video/generate パスを使用しません。公式 API のネイティブパスをホスト直下でそのまま使用します:https://api.hop-base.com/api/v1/services/aigc/video-generation/video-synthesis。この /api/v1/... の前に、追加の /v1 は付きません。 Claude のキーを OpenAI Compatible として設定すると、誤ったプロトコルのパスにリクエストが送られ、404「当前平台不支持该 API 路径」が返されます。プロバイダーの種類を Anthropic に変更し、Base URL から /v1 を削除してください。

次のステップ

このページの内容

よく使うエンドポイント次のステップ