開始前的最小驗證

準備正式設定

網站維護中。本頁提供接入指南，協助你整理應用程式設定、妥善管理服務端憑證，並在安排正式流量前確認服務細節。請向支援取得確認的 base URL、模型識別與認證方式，不要自行猜測服務網域。將測試與正式用途的憑證分開保存，記錄設定來源與確認時間。

用非敏感資料測試

選擇短小、不含個資的測試訊息，從受控伺服器環境發送最小請求。若確認採用相應相容協定，再依實際版本文件設定用戶端。先檢查基本回應，再加入串流或工具等選用能力，不要一次啟用所有功能。

定義成功與下一步

記錄成功狀態、必要回應欄位與錯誤處理，不要把密鑰或完整內容貼到日誌。接著驗證逾時、錯誤參數及權限不足情境，確認重試不會造成重複動作。本文未宣稱任何範例已通過真實 UBTL API 驗證。

服務端接入範例

先在本機安裝相應的官方 SDK（Python：pip install openai；Node.js：npm install openai）。將 OPENAI_API_KEY、OPENAI_BASE_URL 和 OPENAI_MODEL 設為服務方確認的值；不要把實際密鑰貼入官網或前端。下例只展示常見 Chat Completions 模式，不能替代對實際接口的驗收。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
    base_url=os.environ["OPENAI_BASE_URL"],
)

result = client.chat.completions.create(
    model=os.environ["OPENAI_MODEL"],
    messages=[{"role": "user", "content": "Hello, AI."}],
)
print(result.choices[0].message.content)

# Set these to values confirmed by your service contact.
curl "${OPENAI_BASE_URL}/chat/completions" \
  -H "Authorization: Bearer ${OPENAI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "{\"model\":\"${OPENAI_MODEL}\",\"messages\":[{\"role\":\"user\",\"content\":\"Hello, AI.\"}]}"

import OpenAI from "openai";

// Run on your server. Never expose a key in browser code.
const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: process.env.OPENAI_BASE_URL,
});
const result = await client.chat.completions.create({
  model: process.env.OPENAI_MODEL,
  messages: [{ role: "user", content: "Hello, AI." }],
});
console.log(result.choices[0].message.content);

整合範例，並非在線測試。Base URL、模型及權限請先向我們確認。