OpenAI compatible 協定

使用 /v1 Base URL 接入 OpenAI compatible 用戶端。

常用端點

本頁列出 OpenAI compatible 的文字、Responses、圖像、影片任務、音訊、向量、審核和即時介面。影片參數與輪詢流程請查看圖片與影片生成；實際可用端點取決於模型和 Key 分組。

模型與探索

用途	方法	路徑
模型清單	GET	/v1/models

文字與回應

用途	方法	路徑
文字補全（舊版）	POST	/v1/completions
聊天對話	POST	/v1/chat/completions
Responses	POST	/v1/responses
Responses 壓縮	POST	/v1/responses/compact

圖像

用途	方法	路徑
圖像生成	POST	/v1/images/generations
圖像編輯	POST	/v1/images/edits

影片任務

用途	方法	路徑
建立影片任務	POST	/v1/videos
查詢影片任務	GET	/v1/videos/{task_id}
取得影片內容	GET	/v1/videos/{task_id}/content
建立影片生成任務（相容）	POST	/v1/video/generations
查詢影片生成任務（相容）	GET	/v1/video/generations/{task_id}

音訊

用途	方法	路徑
音訊轉錄	POST	/v1/audio/transcriptions
音訊翻譯	POST	/v1/audio/translations
文字轉語音	POST	/v1/audio/speech

向量與檢索

用途	方法	路徑
文字嵌入	POST	/v1/embeddings
文件重排序	POST	/v1/rerank

安全與即時

用途	方法	路徑
內容審核	POST	/v1/moderations
Realtime（WebSocket）	GET	/v1/realtime

最小請求

用戶端 Base URL 通常填寫 https://api.popgo.site/v1，驗證使用 Authorization: Bearer YOUR_API_KEY。將 YOUR_MODEL 替換為模型頁的 ID，並確認模型支援目標端點。

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": "請回覆連線成功"}
    ]
  }'

驗證

先用最小請求確認模型和協定，再逐步啟用串流、工具、圖像或音訊參數。出現 404 時檢查 Base URL 是否重複附加 /v1；出現 400 時檢查模型是否支援該端點。