跳转到主要内容
Rock API 会处理 API 凭证和请求内容,用于认证、路由和模型调用计费。网关会将请求内容转发给上游服务完成推理。发送敏感数据前,需要同时了解网关的数据处理方式,以及实际上游路由适用的条款。 本页说明已核验的实现行为和你可以采取的操作。生产配置、运营留存周期及上游合同需要单独确认;仅凭代码不能确定这些政策。

请求数据流向哪里

  1. 应用将 API Key 和请求发送到 HTTPS 地址 https://rockapi.ai/v1。请在服务端发起调用,配置方式见认证。
  2. 网关检查密钥和账户,应用已配置的限制并选择上游渠道。根据接口及渠道设置,网关可能映射模型名称、转换请求格式、覆盖参数,或以透传模式转发请求体。
  3. 上游服务接收推理所需内容,包括消息、工具输入,以及提交的媒体或媒体引用。网关处理响应和用量信息,再将结果返回客户端。
  4. 用量和错误记录用于计费及排障。异步媒体任务还可能保存任务输入、状态、供应商返回数据及结果 URL;其记录不同于文本请求日志。
透传是转发选项,不是匿名化处理。标准上游适配器使用渠道配置的凭证。按通配符和正则规则转发请求头时,会排除 Cookie 和常见认证头,但显式的渠道请求头覆盖配置可以改变转发行为。不要在自定义请求头里放入密钥或个人标识。

保护与撤销 API Key

为每个应用和环境创建独立的 API Key。在密钥编辑界面提供相应选项时,设置有效期、有限额度、允许模型及 IP 白名单。实现会在模型转发前检查密钥状态、有效期、可用额度和已配置的 IP 限制;模型限制约束可用路由。请从应用实际出口 IP 验证白名单。 将密钥放入服务端密钥管理系统或受保护的运行配置。不要写入浏览器打包文件、移动应用、代码仓库、URL、截图或共享请求记录。优先使用文档规定的认证请求头,避免通过查询参数传递凭证。 密钥列表和详情响应会遮蔽密钥,另有经过认证的操作可读取完整值。遮蔽属于展示控制,不能证明密钥使用不可逆哈希存储或已做静态加密。 常规轮换时,创建新密钥、更新应用并验证调用,然后禁用或删除旧密钥。如果已经泄露,先禁用或删除泄露密钥,再更换密钥并检查用量日志中的异常调用。确认旧密钥已被拒绝;若仍可用,联系支持处理。撤销密钥不会删除历史记录。

日志可能包含什么

消费日志和用量汇总受配置控制。用户可见的日志会移除部分管理信息,因此控制台显示的内容并不涵盖所有存储字段。关闭某类日志或 IP 偏好,并不会关闭全部访问、安全、任务或基础设施记录。核对消耗可参考价格与计费。

尽量减少请求信息

只发送完成任务所需的对话轮次、文档片段、工具结果和媒体。移除密码、访问令牌、支付信息及无关个人信息。用内部代号替代客户身份,并在你自己的系统中保存映射。除提示词正文外,也要检查文件名、媒体元数据、自定义请求头和签名 URL。验证新集成时,使用虚构的测试数据。 联系支持时,先提供请求或任务 ID、含时区的时间、模型 ID、接口路径、HTTP 状态及密钥名称。必要时补充简短脱敏错误或最小复现。不要发送完整 API Key、认证请求头、私密对话或未脱敏的媒体签名 URL。

留存、训练用途与合规

实现可以证明处理和日志功能,不能证明 Rock API 及所有上游均采用零留存、不用于训练或固定期限删除的政策。使用敏感数据前,请通过主站 About 页面提供的支持渠道确认:
  • 留存与访问: 请求体、输出、任务文件、用量日志、访问日志和备份分别保存哪些内容、保存多久、谁可以访问,有哪些例外?
  • 训练及其他用途: Rock API 或实际承接请求的上游,是否将输入输出用于模型训练、评估、滥用审查或其他用途?你的账户和路由适用哪些排除条款或退出选项?
  • 上游与地区: 所选模型由哪些处理方和地区处理,包括重试或回退路由?你的业务能否强制限定处理地区?
  • 合同证明: 是否提供数据处理协议(DPA)?跨境传输保障、安全认证和审计报告分别适用于所签服务的哪些范围?
开始使用前,应针对具体模型、路由、账户和数据类别获得确认;仅凭模型名称不能确定这些条款。

申请账户或数据删除

需要终止访问时,先停止相关集成并撤销密钥。账户删除操作采用软删除机制,不能据此认定日志、备份、任务输出或上游副本已被清除。 通过 About 页面的支持渠道申请删除或隐私审查。提供账户标识、数据类别、时间范围、相关请求或任务 ID,并说明是否要求覆盖上游副本。请支持确认身份核验流程、删除范围、完成时限、备份处理及依法需要保留的数据。额外的身份材料只通过支持指定的渠道提交。