API 密钥

​

创建密钥

1. 填写名称。建议使用项目名、环境名或工具名，例如 prod-web、cursor-local。
2. 设置有效期。临时测试密钥建议使用短期过期时间。
3. 设置额度。默认可以使用无限额度；如果要控制成本，关闭无限额度后填写上限。
4. 按需限制可用模型和来源 IP。只允许项目需要的模型，或只开放固定出口 IP 时再启用。
5. 选择分组。分组只用于列表管理和归类，不影响密钥权限、额度或请求路由。
6. 需要时批量创建。一次生成多把同配置密钥时，再填写创建数量。

​

在请求中使用

Authorization: Bearer 你的密钥

​

管理密钥

• 查看用量：确认该密钥已消耗的额度。
• 编辑：调整名称、额度、过期时间、模型限制、IP 限制和分组。
• 启用或禁用：临时停用密钥，不改变其他配置。
• 删除：永久作废密钥，适合泄露或项目下线后使用。

​

安全实践

• 为开发、生产、自动化脚本和外部工具分别创建密钥。
• 对浏览器插件、桌面客户端和临时测试密钥设置额度上限。
• 在服务端通过环境变量读取密钥，不要硬编码到源码。

export MOXUS_API_KEY="你的密钥"
export MOXUS_BASE_URL="https://moxus.cloud/v1"

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MOXUS_API_KEY"],
    base_url=os.environ.get("MOXUS_BASE_URL", "https://moxus.cloud/v1"),
)

​

泄露处理

1. 立即在“API 密钥”页面删除或禁用可疑密钥。
2. 创建新密钥并更新应用配置。
3. 进入“控制台与用量”页面按密钥、时间和模型排查异常消耗。
4. 为新密钥添加额度、模型或 IP 限制。

​

相关文档

• 第一次调用：参阅 快速入门。
• 外部工具配置：参阅 Cursor 接入。
• 余额与账单：参阅 付款与账单。