GetAPI.ONE

使用 Python 呼叫 GetAPI.ONE

安裝官方 OpenAI Python SDK，將其指向 ONE Base URL，傳送一次受控的 Responses 請求，並在不把憑據寫入原始碼的前提下驗證結果。

準備專案與憑據

Python 3.10 或更高版本，以及一個虛擬環境。
一個已啟用、設定了明確有效期與額度的 GetAPI.ONE API 金鑰。
從目前目錄複製一個明確宣告 Responses 端點的模型 ID。

powershell

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade openai

設定並傳送請求

在程序環境中設定 GETAPI_ONE_API_KEY；不要把金鑰貼上進檔案。
建立用戶端，並將 https://www.getapi.one/v1 設為 base_url。
用目前目錄中明確支援 Responses 的準確模型 ID 替換醒目的預留位置。
僅在你接受該請求可能計費時執行指令碼。
首次驗證停用 SDK 重試。只有在明確哪些操作可安全重複後，才新增有界且可觀測的重試。

python main.py

import os
from openai import OpenAI

api_key = os.environ.get("GETAPI_ONE_API_KEY")
if not api_key:
    raise RuntimeError("Set GETAPI_ONE_API_KEY before running this program")

with OpenAI(
    api_key=api_key,
    base_url="https://www.getapi.one/v1",
    timeout=30.0,
    max_retries=0,
) as client:
    response = client.responses.create(
        model="<MODEL_ID_FROM_CURRENT_CATALOG>",
        input="Reply with one short readiness check.",
    )
    print(response.output_text)

理解呼叫契約

欄位	所需值
base_url	https://www.getapi.one/v1
api_key	來自伺服器端環境的 GETAPI_ONE_API_KEY
model	目前目錄中的準確 ID
方法	client.responses.create

驗證預期結果

程序正常退出，且沒有鑑權或端點錯誤。
response.output_text 包含請求的簡短回答。
GetAPI.ONE 主控台中出現與該金鑰匹配的請求或用量記錄。

修復常見錯誤

現象	檢查
401 或鑑權錯誤	重新複製 ONE 金鑰，確認已啟用，並核對環境變數確實傳入目前程序。
404	base_url 中只保留一個 /v1，並僅對宣告該端點的模型使用 Responses 方法。
模型不可用或不相容	從目前目錄重新複製準確 ID，不要推斷別名。

保障串接安全

僅在可信伺服器端或本地工具程式碼中執行 SDK，絕不要放進瀏覽器 JavaScript。
從版本控制中排除 .env；金鑰一旦暴露應立即輪換。
開發與生產使用不同且額度受限的金鑰。

下一步

串流接收回應處理 SSE 生命週期事件與終止結果。
選擇模型讓任務匹配目錄中的端點契約。