使用 Bearer API Key 认证请求,保护凭证并利用 Request ID 完成排障。
所有受保护的模型 API 请求使用 Bearer API Key。API Key 代表对应账号或项目的调用权限与费用责任;Request ID 是一次请求的排障标识,不是认证凭据。
本文面向通过天工智算云 OpenAI 兼容接口接入模型能力的后端开发者、架构师和运维人员。完成本文后,你应当能够独立完成配置、验证结果,并知道出现异常时应该保留哪些信息。
云资源和模型能力会随区域、库存、模型版本及账号权限变化。页面显示的可用规格、价格、配额和状态是本次操作的直接依据;文档用于解释操作逻辑和风险边界。
先完成以下准备,再进入控制台操作。对生产环境而言,准备阶段还应明确资源负责人、费用归属、数据级别和回滚方式。
重要提醒: 任何人获取完整 API Key 后都可能代表你的账号调用并产生费用。发现泄露时,修改登录密码不能替代禁用该密钥。
按照下面的顺序执行。每完成一步都应检查页面反馈,不要在状态仍为“处理中”时连续提交相同操作。涉及删除、重装、退款、密钥禁用等不可逆动作时,应再次核对资源名称和影响范围。
在 API Key 页面按应用和环境创建,使用可追责名称。生产与测试不得共享同一密钥。
将密钥放入服务端密钥系统或运行环境。例如使用 TIANGONG_API_KEY,并确保进程日志不会打印该变量。
请求头示例:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
不要额外添加引号或把密钥放入查询参数。
读取响应中平台提供的 Request ID 或日志对应标识,将其与内部 trace ID 关联,用于跨系统排障。
先创建新密钥并灰度部署,确认请求正常后禁用旧密钥。泄露时应立即禁用并审查异常用量。
工单、截图和监控中只展示密钥前后少量字符作为标识,绝不提交完整值。
功能能够使用并不等于已经具备生产条件。正式承载业务前,请把可观测性、权限、费用和数据恢复纳入同一套运行基线。
建议为关键资源建立变更记录,至少包含操作者、时间、原因、预期结果、实际结果和回退步骤。团队协作时,不要通过聊天工具传递密码或完整 API Key。
排查时先确认影响对象、开始时间和最近一次变更,再区分是浏览器、账号权限、平台资源、网络还是应用自身问题。提交工单时,请附上资源 ID、请求 ID、发生时间、错误信息和已经执行过的排查步骤;不要提交密码、完整密钥或身份证件原图。
检查 Bearer 认证格式、密钥状态、所属环境与模型权限。不要在排障信息中提供完整密钥。
使用最小请求逐项检查模型名称、字段类型、消息结构、文件格式和上下文长度,不要盲目重试相同请求。
限制并发并受控退避。记录 Request ID;若流式响应已经产生部分内容,先判断业务写入是否可安全重放。
离开页面前,逐项确认:
如结果与本文不一致,应停止继续扩大变更范围,通过页面右上角“工单支持”提交问题。