API 接続

Capkii は OpenAI、Claude、Gemini の 3 種類の互換 API を同時に提供します。既存のアプリケーションはコードを変更する必要はなく、接続先アドレスを Capkii のサイトアドレスに、API Key を API キー ページで作成したキーに差し替えるだけで利用できます。

以下の例に出てくる https://your-capkii-domain.com は実際に利用しているサイトアドレスに、sk-ここを自分のキーに置き換えてください はご自身の API キーに置き換えてください。3 種類のプロトコルはいずれも同じ API キーを使用します。

まず疎通を確認してから接続する

「API キー」ページで任意の API キーの「テストコマンド」を開くと、Capkii が実際のキー、サイトアドレス、利用可能なモデルを組み合わせて、そのまま実行できる curl を生成します。ターミナルにコピーして動作を確認できます。

OpenAI 互換 API

利用方法は OpenAI API と同じで、接続先アドレスはサイトのルートアドレスです。

API Base の書き方

クライアントによって期待する API Base の形式が異なります。接続に失敗する場合は次の順に試してください。

• https://your-capkii-domain.com
• https://your-capkii-domain.com/v1
• https://your-capkii-domain.com/v1/chat/completions

利用例

curl --request POST \
    --url https://your-capkii-domain.com/v1/chat/completions \
    --header 'Authorization: Bearer sk-ここを自分のキーに置き換えてください' \
    -H "Content-Type: application/json" \
    --data '{
      "model": "gpt-5-mini",
      "messages": [
          {
              "role": "user",
              "content": "hi~"
          }
      ]
  }'

利用できる API

対話のほかに、/v1 配下ではテキスト補完、Responses、ベクトル化（embeddings）、リランキング（rerank）、コンテンツモデレーション（moderations）、画像生成 / 編集 / バリエーション、音声合成 / 文字起こし / 翻訳、およびリアルタイム（realtime）の各 API を提供しています。リクエストとレスポンスの構造は OpenAI 公式と同じです。

現在の API キーで利用できるモデルを照会します。

curl https://your-capkii-domain.com/v1/models \
  --header 'Authorization: Bearer sk-ここを自分のキーに置き換えてください'

Claude 互換 API

利用方法は Claude API と同じで、接続先アドレスは https://your-capkii-domain.com/claude、認証には x-api-key ヘッダーを使用します。

利用例

curl --request POST \
    --url https://your-capkii-domain.com/claude/v1/messages \
    -H "Content-Type: application/json" \
    -H "x-api-key: sk-ここを自分のキーに置き換えてください" \
    -H "anthropic-version: 2023-06-01" \
    --data '{
  "model": "claude-sonnet-4-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "hi~"
    }
  ]
}'

このプロトコルで利用できるモデルを照会します。

curl https://your-capkii-domain.com/claude/v1/models \
  -H "x-api-key: sk-ここを自分のキーに置き換えてください"

Gemini 互換 API

接続先アドレスは https://your-capkii-domain.com/gemini、認証には x-goog-api-key ヘッダーを使用します。パス内のバージョン部分（v1beta など）は公式と同じです。

利用例

curl --request POST \
  --url https://your-capkii-domain.com/gemini/v1beta/models/gemini-2.5-pro:generateContent \
  --header 'Content-Type: application/json' \
  --header 'x-goog-api-key: sk-ここを自分のキーに置き換えてください' \
  --data '{
	"contents": [
		{
			"role": "user",
			"parts": [
				{
					"text": "hi~"
				}
			]
		}
	]
}'

このプロトコルで利用できるモデルを照会します。

curl https://your-capkii-domain.com/gemini/v1beta/models \
  -H "x-goog-api-key: sk-ここを自分のキーに置き換えてください"

コンソールの API カタログ

サイドバーの「API」グループには、モダリティごとに 4 つのカタログページがあります。内容は本ページと同じですが、アドレスは実際に利用しているサイトアドレスに置き換わっています。

ページ	パス	対象エンドポイント
チャット	/panel/api/chat	/v1/chat/completions、/v1/responses、/claude/v1/messages、/gemini/v1beta/models/{model}:generateContent
画像	/panel/api/image	/v1/images/generations、/v1/images/edits、/v1/images/variations、および Recraft と Midjourney の拡張エンドポイント
音声	/panel/api/speech	/v1/audio/speech、/v1/audio/transcriptions、/v1/audio/translations、および /v1/realtime
動画	/panel/api/video	Kling のテキスト / 画像からの動画生成とタスク照会、および Gemini Veo の長時間タスク

各カタログページには「エンドポイント」「リクエスト例」「利用可能なモデル」と完全なドキュメントへのリンクがあります。例に含まれるキーはプレースホルダー sk-YOUR_TOKEN です。「API キー」ページで作成したキーに置き換えればそのまま実行できます。個人コンテキストでは「チャット」ページに「オンライン試用」欄も表示され、その場でリクエストを送信できます。

Midjourney と非同期タスクの実行記録はカタログページには含まれません。「ログ」ページの「Midjourney」「非同期タスク」タブで確認してください。

モデルとグループについて

• 呼び出せるモデルは、API キーで選択したチャネルグループと、その API キーでモデル制限を有効にしているかどうかによって決まります。利用可能な一覧は「ダッシュボード」の「現在利用可能なモデル」で確認できるほか、上記の各プロトコルの models API でも照会できます。
• Claude / Gemini プロトコルのリクエストは、対応する種類のチャネルにしかルーティングできません。これらのプロトコルでモデルが見つからない場合は、現在のグループにその種類のチャネルが存在しないということなので、OpenAI 互換 API をご利用ください。
• リクエストが失敗した場合は、利用状況とログ ページで API キーと時刻から該当するレコードを特定できます。明細には終了理由と課金の内訳が表示されます。

関連

• 推論設定：推論モデルの思考の挙動を制御する
• 特殊な呼び出し：一般的でないシナリオでの呼び出し方法
• API キーとクォータ：クォータ、有効期限、モデル制限、IP ホワイトリスト
• よくある質問：接続エラーのトラブルシューティング