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 任务，以利用结构化输出架构、原生追踪以及对图像、音频或视频生成的跨模态支持。