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): 如果使用 OpenAI SDK 和 Opper 的 OpenAI 兼容端点，请将 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) 在构建自主代理时使用 Agent SDK（可选）: 对于工具调用代理、MCP 集成、跨度跟踪和多代理组合，请使用 Opper 的 Agent 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.ai/ai-compliance