Opper AI

1) 建立 Opper 帳戶: 前往 https://opper.ai/sign-up/free 並註冊（為您自己或您的公司）。

2) 建立 API 金鑰: 登入 Opper 平台 (https://platform.opper.ai) 並建立新的 API 金鑰（右上角選單）。API 金鑰與專案相關聯；考慮為不同的應用程式/環境建立單獨的專案。

3) (可選) 添加點數或帶上您自己的供應商金鑰: 儲值點數以透過 Opper 使用任何模型/供應商，或根據您的設定和需求配置您自己的供應商金鑰。

4) 在您的環境中設定 API 金鑰: 將您的金鑰匯出為名為 OPPER_API_KEY 的環境變數（切勿將其硬編碼到程式碼中）。

5) 使用 OpenAI SDK 進行首次呼叫（即插即用相容性）: 使用您現有的 OpenAI SDK 程式碼，但將 baseURL 指向 Opper 的相容端點 (https://api.opper.ai/v3/compat) 並傳遞供應商/模型字串（例如，anthropic/claude-sonnet-4-5）。

6) 範例 (TypeScript) — 帶有 Opper 相容端點的 OpenAI SDK: 安裝並執行類似以下程式碼：import OpenAI from "openai"; const client = new OpenAI({ apiKey: process.env.OPPER_API_KEY, baseURL: "https://api.opper.ai/v3/compat" }); const response = await client.chat.completions.create({ model: "anthropic/claude-sonnet-4-5", messages: [{ role: "user", content: "Hello!" }] });

7) 使用供應商/模型命名進行路由: 選擇模型時，將它們作為供應商/模型字串傳遞（例如，openai/gpt-5, anthropic/claude-opus-4-7）。在 https://opper.ai/models 或文件中瀏覽可用模型。

8) (替代方案) 使用帶有明確標頭的 OpenAI 相容端點 (compat/openai): 如果使用帶有 Opper 的 OpenAI 相容端點的 OpenAI SDK，請將 base_url 設定為 https://api.opper.ai/compat/openai 並包含帶有您的 OPPER_API_KEY 的標頭 x-opper-api-key；確保 OpenAI api_key 欄位不為空。

9) 透過技能將 Opper 添加到編碼代理（代理輔助設定）: 要讓編碼代理（Claude Code、Cursor、Codex 等）自動配置 Opper，請按照 https://skills.opper.ai 上的代理輔助設定說明進行操作，或使用以下命令安裝技能包：npx skills add opper-ai/opper-skills

10) 建立自主代理時使用代理 SDK（可選）: 對於工具呼叫代理、MCP 整合、跨度追蹤和多代理組合，請使用 Opper 的代理 SDK（Python 或 TypeScript）。從 https://docs.opper.ai/agents 開始。

11) 使用帶有模式的結構化輸出（可選）: 為了獲得可靠、類型化的回應，請使用 https://docs.opper.ai/build/task/calls 中描述的模式/結構化輸出功能（例如，Python 中的 Pydantic）。

12) 透過索引添加 RAG/語義檢索（可選）: 使用 Opper 索引上傳文件/物件並在 LLM 呼叫中檢索它們，以進行分塊/重新排名管理的 RAG。請參閱 https://docs.opper.ai/capabilities/indexes。

13) 透過控制平面啟用可觀察性和治理（可選）: 隨著規模擴大，使用 AI 控制平面觀察呼叫/令牌/會話，跨供應商/區域路由，透過上下文工程引導，防護（PII 遮罩/內容過濾），並遵守（預算上限/審計追蹤）。探索：https://opper.ai/ai-control-plane

14) 審查合規性和數據保留選項（可選）: Opper 託管在歐盟（AWS 斯德哥爾摩），具有以 GDPR 為中心的控制；預設不儲存提示（用於分析的元數據），企業選項可以啟用零保留。請參閱 https://opper.opper.ai/ai-compliance