使用 OpenAI Python SDK 接入 EastX｜首次呼叫與錯誤排查

準備 API Key 與模型

EastX 提供 OpenAI 相容的 Chat Completions 入口。先在控制台建立用途明確的 API Key，確認餘額、Key 的消費上限、模型權限與來源 IP 設定。把金鑰設為環境變數 EASTX_API_KEY，不要放進公開程式碼或截圖。

從 EastX 模型目錄選擇支援文字對話的模型，複製精確 ID，並設定為 EASTX_MODEL。統一入口方便不同專案比較模型，獨立 Key 則有助於區分預算和使用量。

傳送第一個請求

python -m pip install openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["EASTX_API_KEY"],
    base_url="https://api.eastx.ai/v1",
    timeout=60.0,
    max_retries=0,
)
response = client.chat.completions.create(
    model=os.environ["EASTX_MODEL"],
    messages=[{"role": "user", "content": "請用一句話介紹自己。"}],
)
print(response.choices[0].message.content)
print(response.usage)

成功取得回覆後，對照控制台的模型、時間與使用紀錄。請求可能產生費用。切換模型時，重新確認串流、工具呼叫、圖片輸入與參數是否受支援。

常見錯誤

• 401：檢查 Key 是否完整、有效。
• 402：分別檢查帳戶餘額、Key 上限及最大輸出的預估費用。
• 403：檢查模型權限與來源 IP 限制。
• 404：核對模型 ID 和 Base URL，避免重複加入 /v1 或 /chat/completions。
• 429：降低並行量，依 Retry-After 指示等待，限制重試次數。
• 5xx 或逾時：保留時間和去識別化的請求編號，確認工作狀態再重試。

EastX API 文件 · 模型與價格 · 簡中及英文原文