傳送 GetAPI.ONE API 請求

準備工作與邊界

• 一個儲存在 GETAPI_ONE_API_KEY 中的受限 GetAPI.ONE 金鑰。
• 一個在目前目錄中明確列出預期端點型別的模型。
• 已安裝 curl 且允許訪問 www.getapi.one HTTPS 的命令列。
• 接受真實請求可能產生用量費用。本範例僅做靜態複核，未傳送模型請求。

• 建立並載入金鑰
• 選擇端點相容模型

1. 選擇明確宣告的端點

其它協議族使用不同路徑與請求體。請以所選模型頁顯示的端點為準；不要把 Anthropic、Gemini、影像或影片呼叫強行套用到上面的兩個範例。

2. Responses API 範例

只有選擇了目錄中列出 Responses 端點的模型後才使用此範例。執行前必須替換 YOUR_RESPONSES_MODEL。

curl --fail-with-body https://www.getapi.one/v1/responses \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_RESPONSES_MODEL",
    "input": "Reply with the word ready."
  }'

3. Chat Completions 範例

只有所選目錄模型列出 OpenAI Chat 端點時才使用此範例。執行前必須替換 YOUR_CHAT_MODEL。

curl --fail-with-body https://www.getapi.one/v1/chat/completions \
  -H "Authorization: Bearer $GETAPI_ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "messages": [
      {"role": "user", "content": "Reply with the word ready."}
    ]
  }'

4. 檢查結果

1. 先讀取 HTTP 狀態。2xx 表示閘道接受並完成 HTTP 請求，但用戶端仍需檢查回應物件中是否存在預期輸出。
2. Responses 請求應檢查返回的回應狀態/output 結構；Chat Completions 應檢查 choices 結構。不要把兩種協議的回應形態混用。
3. 開啟 GetAPI.ONE 請求或使用日誌，在可用時核對時間、端點、模型和請求識別碼。

串流與重試

串流會改變回應傳輸和事件處理；是否支援取決於所選端點與模型。先完成非串流請求，再根據協議參考與模型頁新增串流參數。

• 不要自動重試認證、額度、權限或模型選擇錯誤。
• 重試逾時或上游失敗前，先判斷原請求是否可能已處理，以及操作是否可以安全重複。
• 應用中使用有上限的重試次數與退避，並保留請求識別碼和時間以便診斷。

錯誤分支

• 疑難排解清單
• 準備求助材料