Esta página todavía solo está disponible en chino. La navegación y los menús ya aparecen en español.

团队 Key 与用量

团队 API Key 归属于项目，用于标识服务、环境、Agent 或自动化任务。它继承项目边界，并可设置更严格的预算、模型和路由限制。个人 Key 适合个人试验，生产服务应使用团队 Key。

创建团队 Key

进入“企业协作 → Key 管理”，选择项目并填写：

名称：建议包含应用、环境和用途，如 support-prod-agent。
预算：不得超过项目可分配额度。
路由模式：均衡、价格优先或速度优先。
模型范围：只开放实际需要的公共模型。

Key 完整值只应在创建或授权查看时短暂出现。复制后立即放入服务端密钥管理系统，不要发送到聊天工具或工单正文。

服务端使用

export INONEAPI_API_KEY="ioa_sk_..."

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.INONEAPI_API_KEY,
  baseURL: "https://api.inoneapi.com/v1",
});

const result = await client.chat.completions.create({
  model: "YOUR_MODEL_ID",
  messages: [{ role: "user", content: "你好" }],
});

console.log(result.choices[0]?.message.content);

浏览器和移动客户端不能安全保存服务端 Key，应通过自己的后端调用 InOneAPI。

查看用量

用量页可以按项目、Key、模型和日期筛选请求。排查时重点查看：

X-Gateway-Trace-ID
公共模型与上游渠道
状态码与重试次数
输入、输出、缓存读写 Token
TTFT 与总延迟
请求级成本

平台保存这些计费与诊断元数据，但不会把提示词和模型回复持久化到数据库。

轮换与撤销

推荐使用双 Key 轮换：

创建新 Key，并保持与旧 Key 相同的必要权限。
更新密钥管理系统和服务配置。
发布后观察新 Key 的成功请求。
确认旧 Key 已无流量。
撤销旧 Key。

发现泄露时不要等待常规窗口，应立即撤销、创建新 Key，并按时间和 Trace 检查异常用量。删除成员不会自动替代服务端凭据轮换。

Agent 使用建议

每个 Agent 工具使用独立团队 Key。这样可以单独限制模型与预算，并快速识别重试风暴或失控任务。Agent 侧仍需设置最大轮次、命令审批和沙箱；网关预算不能代替本地执行安全策略。