API 接入

Capkii 同時提供 OpenAI、Claude、Gemini 三套相容介面。既有應用無需改代碼，只要把接入地址換成 Capkii 的站點地址、把 API Key 換成你在 API Key 頁面創建的 API Key 即可。

下文示例中的 https://your-capkii-domain.com 請替換為你實際使用的站點地址，sk-替換為你的key 替換為你的 API Key。三套協議都使用同一把 API Key。

先跑通再接入

在「API Key」頁面打開某個 API Key 的「測試命令」，Capkii 會把你的真實密鑰、站點地址與可用模型拼成一條可直接運行的 curl，複製到終端即可驗證。

OpenAI 相容介面

使用方式與 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-替換為你的key' \
    -H "Content-Type: application/json" \
    --data '{
      "model": "gpt-5-mini",
      "messages": [
          {
              "role": "user",
              "content": "hi~"
          }
      ]
  }'

可用的介面

除對話之外，/v1 下還提供文本補全、Responses、向量化（embeddings）、重排序（rerank）、內容審核（moderations）、圖片生成 / 編輯 / 變體、語音合成 / 轉寫 / 翻譯，以及實時（realtime）介面。請求與響應結構與 OpenAI 官方一致。

查詢當前 API Key 可用的模型：

curl https://your-capkii-domain.com/v1/models \
  --header 'Authorization: Bearer sk-替換為你的key'

Claude 相容介面

使用方式與 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-替換為你的key" \
    -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-替換為你的key"

Gemini 相容介面

接入地址為 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-替換為你的key' \
  --data '{
	"contents": [
		{
			"role": "user",
			"parts": [
				{
					"text": "hi~"
				}
			]
		}
	]
}'

查詢該協議下可用的模型：

curl https://your-capkii-domain.com/gemini/v1beta/models \
  -H "x-goog-api-key: sk-替換為你的key"

在控制台查看介面目錄

側邊欄「API」分組按模態列出四個能力目錄頁，內容與本頁一致，但地址已經換成你實際使用的站點地址：

頁面	路徑	覆蓋的介面
對話	/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 Key」頁面創建的 API Key 即可運行。「對話」頁在個人上下文下還帶一個「線上試用」區，可以直接發一條請求看效果。

Midjourney 與非同步任務的執行記錄不在目錄頁裏，請到「日誌」頁面的「Midjourney」「非同步任務」標籤查看。

關於模型與分組

• 你能調用哪些模型，取決於 API Key 所選的渠道分組，以及 API Key 是否開啟了模型限制。可用清單在「儀表板」的「當前可用模型」中查看，也可以用上面各協議的 models 介面查詢。
• Claude / Gemini 協議的請求只能路由到對應類型的渠道。若這兩個協議查不到模型，說明當前分組內沒有該類型渠道，改用 OpenAI 相容介面即可。
• 請求失敗時可到 用量與日誌 頁面按 API Key 與時間定位具體那一條記錄，明細裏會顯示結束原因與計費構成。

相關

• 推理設定：控制推理模型的思考行為
• 特殊用法：非通用場景的調用方式
• API Key 與額度：額度、有效期、模型限制與 IP 白名單
• 常見問題：接入報錯排查