跳至主要内容

curl 快速開始

使用最小 OpenAI compatible 請求檢查完整連線。

準備​

  • 在金鑰頁準備 YOUR_API_KEY。
  • 在模型與價格頁選擇目前可用模型，並以它取代 YOUR_MODEL。
  • 確認目前網路可以存取 https://api.popgo.site。

查看即時模型與價格

接入前檢查清單​

  • 先只替換 YOUR_API_KEY 與 YOUR_MODEL，不要同時修改請求路徑、協定和進階參數。
  • 如果軟體要求 Base URL，依對應教學填根位址或 /v1 位址；如果要求完整 Endpoint，才填完整介面路徑。
  • 先用快速開始請求取得一次成功回應，再把同一組 Key、模型和位址複製到用戶端。

依協定分類選擇位址與端點​

OpenAI compatible 通常使用 /v1 Base URL；Claude Messages 和 Gemini 原生請求使用根位址，再由用戶端或完整 Endpoint 附加協定路徑。

完整端點清單請查看 API Reference。影片任務和媒體參數請查看 圖片與影片生成。

本機環境準備​

如果要執行 CLI、自動化腳本或需要 Node.js 的工具，先確認 Node.js 與 npm 已安裝，並在啟動工具的同一個終端檢查版本：

node --version
npm --version
  • Windows：使用官方安裝程式或系統套件管理器安裝 Node.js LTS。
  • macOS：使用官方安裝程式或 Homebrew 安裝 Node.js。
  • Linux/WSL2：使用發行版套件管理器或 Node.js 官方建議方式安裝。
  • 安裝後仍找不到命令時，關閉舊終端再重新開啟；新的程序才會讀取更新後的 PATH。

傳送請求​

以下請求使用 OpenAI compatible Base URL。

curl https://api.popgo.site/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "messages": [
      {"role": "user", "content": "請回覆連線成功"}
    ]
  }'

成功判斷​

HTTP 狀態成功且回應包含助理內容，表示 Base URL、金鑰與模型皆可使用。失敗時請依狀態碼進行疑難排解。

下一步​

依用戶端支援情況閱讀 OpenAI、Claude 或 Gemini 協定頁，或選擇軟體整合教學。