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

curl

HTTP と curl を使って HopBase の互換エンドポイントを呼び出します。

モデルタイププロトコルとエンドポイント認証方式
GPT / Gemini / GLMPOST https://api.hop-base.com/v1/chat/completionsAuthorization: Bearer
ClaudePOST https://api.hop-base.com/v1/messagesx-api-key
画像POST https://api.hop-base.com/v1/images/generationsAuthorization: Bearer

認証と共通の制限

項目ルール満たさない場合
キーのヘッダーAuthorization: Bearer sk-… または x-api-key: sk-…。すべてのエンドポイントで使えます。x-goog-api-key と URL パラメータ ?key= には対応していません401 missing_api_key / invalid_api_key
エンドポイントとグループ各リクエストはそのモデルのプロトコルのエンドポイントを使う必要があります(例:Claude モデルは /v1/messages 経由でのみ呼び出せます)404「現在のプラットフォームではこの API パスはサポートされていません」
モデル現在のキーに含まれるいずれかのグループのモデルであること404 model_not_found
リクエストボディのサイズボディ全体で 60 MB 以下413
GET /v1/models現在のキーで使えるモデル ID を返します。課金されません—

現在のプランキーで GET /v1/models を呼んだ際に返されるモデル ID を使用してください。キーが呼び出せるのは、含まれるプランのモデルだけです。

Claude では max_tokens を明示的に指定する：

Claude のリクエストで max_tokens を省略してもエラーにはならず 4096 が補われるため、長い出力は 4096 トークンで打ち切られます(stop_reason: "max_tokens")。明示的に指定してください。

OpenAI プロトコル(GPT モデル)

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Anthropic プロトコル(Claude モデル)

curl https://api.hop-base.com/v1/messages \
  -H "x-api-key: sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

ストリーミング("stream": true を追加)

curl https://api.hop-base.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.6-sol", "stream": true,
    "messages": [{"role": "user", "content": "Hello"}]}'

次のステップ

このページの内容

認証と共通の制限OpenAI プロトコル(GPT モデル)Anthropic プロトコル(Claude モデル)ストリーミング("stream": true を追加)次のステップ