白雲 API 教程：Python、Node.js 與 LangChain
服務端環境變數、Responses / Chat SDK 最小示例與重試。 附完整檢查步驟、實操驗證和錯誤處理。
Python、Node.js 與 LangChain
服務端保存金鑰
密鑰通過進程環境變數 BAIYUN_API_KEY 讀取。 瀏覽器網頁和移動應用不能內建共享密鑰; 需要由你自己的後端鑑權、限額後代發請求。 部署前檢查日誌是否會列印請求標頭或環境變數。
Python
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["BAIYUN_API_KEY"],
base_url="https://api.baiyun.si/v1",
timeout=120.0, max_retries=0)
response = client.responses.create(model="gpt-6-luna",
input="用一句话说明 Token 是什么。")
print(response.output_text)output_text 是 SDK 提供的便利屬性; 直接解析 REST JSON 時應遍歷 output 訊息項目中的文字欄位。 安裝依賴應使用隔離環境，保留項目鎖文件; 不要為了測試升級整個生產項目。
Node.js
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: process.env.BAIYUN_API_KEY,
baseURL: 'https://api.baiyun.si/v1',
maxRetries: 0,
timeout: 120000,
});
const stream = await client.chat.completions.create({
model: 'gpt-6-luna', stream: true,
messages: [{role: 'user', content: '你好'}],
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}LangChain
使用支援 OpenAI 相容位址的模型適配器，在其當前版本中設定 API Key、Base URL 與模型。 先調用普通文本，再添加鏈、檢索或工具; 框架自動附加的額外參數仍須符合本站開放範圍，不要把框架名稱當成兼容保證。
錯誤與重試
首先區分 HTTP 狀態、SDK 解析錯誤和業務返回錯誤。 生成中斷可能已經產生消費，不要自動無限重試; 429 按提示退避，401 修復憑據，400 修復參數。 連接逾時應核對狀態頁和網路，再決定是否重試。
Python SDK 官方項目 · Node SDK 官方項目 · LangChain 官方文件
實操前的檢查清單
- 準備自己的帳戶與呼叫金鑰，不使用他人的共享憑據。
- 記錄客戶端版本、系統和準備使用的模型，便於排查時復現。
- 儲存原配置或截圖，隱藏金鑰、驗證碼與私人內容。
- 確認測試可能消費少量 DK，先用一句話、一次請求開始。
- 查閱當前模型廣場與狀態頁，再決定是否啟用更多功能。
詳細排查：把請求問題與程式碼問題分開
先用相同金鑰和模型運行最小 curl，再比較 SDK 的實際位址、請求協定和參數。 curl 成功而 SDK 失敗時，排查代理環境、SDK 自動重試、超時和額外欄位。 不要在錯誤日誌中列印 Authorization; 部署中的密鑰也不能寫到前端構建變數。
怎樣確認本節已經學會
不要只檢查「配置保存成功」提示。 你應能說清當前 Base URL、密鑰用途、選用模型和請求協議，能在相應控制台核對自己的操作結果。 客戶端教程以一次實際純文本響應和對應日誌為初步完成標準; 賬戶教程以安全信息完善為標準; 計費教程以本金、通道費與 DK 的對應關係核對為標準。
如果出現錯誤，記錄發生時間、HTTP 狀態、脫敏錯誤內容以及實際期待的結果。 不要截圖整頁密鑰，也不要把密碼和驗證碼交給其他人。 對 401 應先解決認證，對 400 應先解決參數，對 429 應停止密集重試，對 404 應核對請求路徑與上游是否實現，不能用重新充值解決所有報錯。
一個適合練習的小任務
在自己的測試環境完成本節的最小步驟，用文字記錄「原來怎麼設置、改了哪一項、看到了什麼結果」。 不把生產資料、真實付款或不可恢復的命令當練習。 遇到超出本節的功能，先查看對應協議教程，再考慮添加功能; 一次只變更一個配置，容易判斷哪一步導致錯誤。
下一步與版本邊界
返回完整學習地圖 · API 站精簡配置 · 本站即時狀態。
教程於2026年10月9日整理。 具體介面與能力可能隨客戶端和上游版本變化; 配置指引不等於所有客戶端版本已經實測通過。 本站餘額消費、QQ / 支付寶登錄及已開放通路以實際頁面為準; 壓縮介面此前的上游 404、生圖尚無可用渠道等限制不要理解為配置文件能自動消除。