21. 常見問題 FAQ#

Q：我現有的 OpenAI 程式碼需要改多少？ A：通常只改 baseURL 和 apiKey 兩處，其餘請求參數保持不變。

Q：可以直接用 OpenAI 官方 SDK 嗎？ A：可以。所有主流語言的 OpenAI SDK 都支援自訂 baseURL，指向 http://183.240.79.21:52099/v1 即可。

Q：Claude / Gemini 等非 OpenAI 模型怎麼呼叫？ A：建議統一走 /v1/chat/completions，把 model 換成對應模型名即可，無需切換協定。若必須用 Anthropic 原生協定，可走 /v1/messages（不支援函式呼叫 / 多模態）。

Q：如何知道目前 Key 能用哪些模型？ A：呼叫 GET /v1/models，回傳的即為目前有權存取的模型清單。

Q：呼叫出現 404 怎麼辦？ A：優先確認路徑為單一 /v1（如 /v1/chat/completions，而非 /v1/v1/...）；再確認模型名拼字正確且在 GET /v1/models 回傳清單中。

Q：串流回傳如何判斷結束？ A：OpenAI 端點的 SSE 串流以 data: [DONE] 作為結束標記；/v1/messages 端點回傳 Anthropic 格式的 SSE 事件序列。

Q：影片 / 繪圖任務要等多久？ A：屬非同步任務，送出後用回傳的 id 輪詢 /v1/tasks/{id}，直到狀態變為完成。

Q：忘記儲存 API Key 明文了怎麼辦？ A：基於安全考量，明文僅建立時顯示一次且無法找回。請在控制台吊銷舊 Key 並重新建立。

本文件中的網域 http://183.240.79.21:52099 為佔位地址，正式上線後請替換為實際服務網域。 本機開發環境 Base URL 為 http://183.240.79.21:52099/v1。