opper-api

此技能透過其 REST API (api.opper.ai) 為 Opper 平台提供直接介面功能，作為所有 Opper 操作的基礎層。它專為需要細粒度控制模型路由、效能觀察和基礎架構級防護措施（guardrails）的開發人員和工程師所設計。透過使用此技能，您可以直接與 Opper 控制平面互動，以管理部署、執行結構化任務並實現先進的 AI 邏輯，而不受高階抽象的限制。

該技能涵蓋了完整的 Opper v3 表面，包括用於結構化輸入與輸出的 Task API，以及允許您透過簡單更新基礎 URL 和 API 金鑰來替換現有 OpenAI、Anthropic 或 OpenRouter 整合的相容層。它是解決架構查詢、了解 API 端點簽章以及執行特定模型操作（例如查詢支援的提供者或固定特定模型版本以實現一致行為）的主要工具。

• 路由 (Route)：透過單一端點整合 OpenAI、Anthropic、Google 和 Mistral 等提供者的 200 多種模型。

• 觀察 (Observe)：將追蹤、成本追蹤、延遲指標和評估資料集直接整合到您的生產管線中。

• 引導 (Steer)：啟用回饋循環，將高品質輸出保存為範例，用於資料集策劃和迭代提示工程。

• 防護 (Guard)：在資料傳送至模型之前，實施基礎架構級別的防護措施，包括 PII 去除、內容過濾和預算管理。

• 合規 (Comply)：遵循歐洲資料保護指令和安全標準，確保您的 LLM 架構符合 GDPR 要求。

• 請務必優先參考 https://api.opper.ai/v3/openapi.yaml 的即時 OpenAPI 規格，以獲取有關有效負載架構和欄位要求的權威說明。

• 使用 v3/compat 端點將現有特定提供者的 SDK 邏輯替換為 Opper 的統一閘道，確保對聊天完成和訊息 API 的隨插即用相容性。

• 在處理知識庫或 RAG 相關任務時，請特別使用 v2 端點。

• 使用您從 Opper 平台核發的 API 金鑰，透過 Bearer token 方案驗證所有請求；請注意，健康檢查和模型列表等公開端點無需驗證。

• 優先使用 POST /v3/call 執行原生 Opper 任務，以利用結構化輸出架構、原生追蹤以及對影像、音訊或影片生成的跨模態支援。