MAX API
English简体中文日本語한국어
モデル料金ドキュメントコンソールAPI キーを取得

ドキュメント

MAX API API の導入に必要なすべての情報。

クイックスタート

MAX API API は OpenAI API と互換性があります。すでに OpenAI SDK をお使いなら、変更するのはベース URL と API キーの 2 つだけです。

ベース URL
https://clubs.byte-ai.cn/v1
API キー
コンソールで作成

認証

すべてのリクエストで Authorization ヘッダーに API キーを指定してください。キーは秘密にし、ブラウザやモバイルアプリに埋め込まないでください。

Authorization: Bearer YOUR_API_KEY

チャット補完

メッセージのリストを送信して、モデルの応答を受け取ります。カタログ内の任意のチャットモデル ID を使用できます。

curl https://clubs.byte-ai.cn/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

ストリーミング

stream を true にすると、生成中のトークンを Server-Sent Events（SSE）で受け取れます。ストリームは data: [DONE] で終了します。

curl https://clubs.byte-ai.cn/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

画像生成

Images API で画像を生成します。カタログから画像モデルを選んでください。

curl https://clubs.byte-ai.cn/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A lighthouse on a cliff at sunset, watercolor",
    "size": "1024x1024"
  }'

Anthropic 形式

Claude モデルは /v1/messages で Anthropic ネイティブの Messages 形式でも呼び出せます。x-api-key ヘッダーを使用します（Authorization ヘッダーも利用可）。公式 Anthropic SDK をそのまま使えます。

curl https://clubs.byte-ai.cn/v1/messages \
  -H "x-api-key: $API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

モデル一覧

キーで利用可能なモデルの一覧を取得します。

curl https://clubs.byte-ai.cn/v1/models \
  -H "Authorization: Bearer $API_KEY"

エラーコード

エラーは標準的な HTTP ステータスコードと OpenAI 形式の JSON で返されます：

{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}
ステータス意味
400不正なリクエスト：パラメーターが無効、または JSON の形式が正しくありません。
401API キーが無効、または指定されていません。
403残高不足、またはこのキーではこのモデルを利用できません。
404エンドポイントが存在しないか、モデルが利用できません。
429リクエストが多すぎます。間隔を空け、バックオフして再試行してください。
500内部エラー：再試行して問題ありません。
502 / 503上流が一時的に利用できません。少し待ってから再試行してください。

レート制限

デフォルトの制限は本番ワークロードに十分な余裕があります。超過すると 429 が返されるので、指数バックオフで再試行してください。より高いスループットが必要な場合は、コンソールからお問い合わせください。

推論モデルによる長い生成には数分かかることがあります。クライアントのタイムアウトを 300 秒以上に設定するか、ストリーミングを使用してください。

よくある質問

対応している SDK は？+

OpenAI 互換の SDK や HTTP クライアントであれば利用できます：公式 OpenAI SDK（Python / Node.js）、LangChain、LlamaIndex など。Claude モデルでは Anthropic SDK も使えます。

関数呼び出しや JSON 出力に対応していますか？+

はい、対応しているモデルであれば利用できます。tools、tool_choice、response_format などのパラメーターはモデルにそのまま渡されます。

ひとつのキーですべてのモデルを使えますか？+

はい。1 つの API キーでカタログ内の全モデルを利用でき、各モデルの公式価格で課金されます。

モデルを切り替えるには？+

リクエストの model フィールドを変更するだけです。ほかの変更は不要です。