API 參考

舊版介面與相容性

#OpenAI 相容性

所有路徑都接受 OpenAI 請求主體，廠商專屬參數（如 anthropic tool_use、gemini thinking_config）原樣轉發。

回應結構與 OpenAI 完全一致

回應主體與 OpenAI 完全一致，為 OpenAI 寫的解析、重試和可觀測性封裝都能繼續用。

本頁的端點都可以使用、也照常計費，但它們不是建議的接入方式。只有當你需要讓現有廠商 SDK 原樣繼續運作，或者接手了一段暫時不打算遷移的呼叫時，才用它們。

#該用哪一套介面？

全新接入

用 API 參考裡 OpenAI 格式的 /v1 端點。所有能力共用一套詞彙，而且只有這一套會持續增加新參數。

已有廠商 SDK

用下面對應的直通路徑：只改 base URL 和金鑰，請求主體仍用廠商自己的格式。

接手的舊版呼叫

它會繼續可用。下次修改這段程式碼時順手遷移即可——這些路由已凍結，不再維護。

#廠商原生直通

這些路徑接受廠商自己的請求主體，也回傳廠商自己的回應結構。認證仍然只有一個 Authorization: Bearer 標頭，用本平台的金鑰——不使用廠商自己的驗證方式。

Gemini 原生

直通

把 Google GenAI SDK 指向本閘道即可，無需修改程式碼。generateContent 的路徑格式和請求主體都是 Gemini 自己的。

GET	/v1beta/models	以 Gemini 的目錄結構列出模型。
POST	/v1beta/models/*	Gemini 路徑格式：/v1beta/models/{model}:{action}，例如 :generateContent 或 :streamGenerateContent。
POST	/v1/models/*	同樣的 Gemini 請求格式，掛在 /v1 下，供無法修改 API 版本前綴的客戶端使用。
POST	/v1/engines/:model/embeddings	透過舊版的 engines 路徑呼叫 Gemini 嵌入。

可靈原生

直通

接受可靈官方請求主體（model_name + prompt 及廠商自有欄位），並回傳其任務結構。

POST	/kling/v1/videos/text2video	以廠商自有請求主體提交可靈文生影片任務。
POST	/kling/v1/videos/image2video	提交可靈圖生影片任務。
GET	/kling/v1/videos/text2video/:task_id	輪詢可靈文生影片任務。
GET	/kling/v1/videos/image2video/:task_id	輪詢可靈圖生影片任務。

即夢原生

直通

即夢官方的 Action 查詢式 API。提交與取結果共用一個路徑，由 Action 參數區分。

POST	/jimeng/?Action=CVSync2AsyncSubmitTask&Version=2022-08-31	在廠商請求主體裡用 req_key 和 prompt 提交任務。結尾的斜線是必需的——/jimeng 會發生重新導向，而多數 HTTP 客戶端遇到 301 時會丟掉請求主體。
POST	/jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31	取得已提交任務的結果。

Suno 原生

直通

Suno 格式的音樂提交與查詢。新接入建議用 /v1/music/generations——它回傳的是平台統一的任務結構。

POST	/suno/submit/:action	action 取值為 music 或 lyrics。
POST	/suno/fetch	按 id 列表批次查詢。
GET	/suno/fetch/:id	查詢單個任務。

gemini-native.sh

# Google GenAI SDK: set the API endpoint, keep everything else.
curl "https://www.aisplice.store/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Say hello."}]}]
  }'

直通路徑的回應屬於廠商，不是我們的

這些路由的狀態碼、錯誤主體和欄位名稱都跟隨上游廠商。平台的錯誤結構和文件裡的錯誤碼只適用於閘道側的拒絕，例如認證、額度和路由。

#凍結的舊版路由

仍可路由、仍會計費，但不再變更：不加新參數，不保證支援新模型，除了目前可用的部分之外不做任何相容承諾。

舊版別名

凍結

仍會路由、仍會計費，但已凍結：不加新參數，也不做相容承諾。下次修改呼叫端程式碼時請一併遷移。

POST	/v1/completions	OpenAI 舊版的 prompt 補全介面。請改用 /v1/chat/completions。
POST	/v1/edits	儘管名字如此，它實際走的是圖片編輯格式。請改用 /v1/images/edits。
POST	/v1/video/generations	早於 OpenAI 格式的影片提交介面。請改用 POST /v1/videos。
GET	/v1/video/generations/:task_id	早於 OpenAI 格式的影片輪詢介面。請改用 GET /v1/videos/{task_id}。

Midjourney 封存

凍結

唯讀。Midjourney 的付費提交已停止，僅保留檢視歷史任務及其封存圖片的能力。

GET	/mj/task/:id/fetch	檢視一個封存任務。
GET	/mj/task/:id/image-seed	讀取封存圖片的 seed。
GET	/mj/image/:id	回傳封存圖片。

#什麼情況會回傳 404

不支援的 OpenAI 介面根本不會註冊。某個 OpenAI 路徑回傳 404，就意味著這裡確實不提供該能力——不是暫時的缺口，我們也不會用一個固定回傳 501 的路由來假裝支援。

如何確認一個金鑰實際能呼叫什麼

GET /v1/models 會列出該金鑰允許呼叫的所有模型。再結合路徑本身是否 404，就能區分「模型沒有權限」和「端點不提供」。

還是沒解決？

把請求 ID 或錯誤訊息傳給我們，我們來查。