> 来源页面:https://iwkey.com/transparency/(本页的 Markdown 版本) 透明度 # 透明度说明 面向开发者与技术团队,说明 iwkey 网关系统的流式传输机制、数据库实际留存范围与技术对账能力。法律权利与义务以[《服务条款与隐私政策》](https://iwkey.com/legal/)为准。 网关无正文落库 用量可查 Schema 快照公开 0 成功文本请求正文持久化保存 0 客户数据用于模型微调与训练 7 天 视频成片平台备份保留(按需申请) 按次 调用账单明细支持随时对账导出 请求生命周期 ## 一次 API 请求的四个阶段 网关核心职责为鉴权、路由与计量。请求正文仅在内存中流式中转,不写入底层数据库。 01 · 接入鉴权 ### 校验身份与路由匹配 **网关动作:**校验 API Key、账户余额与速率配额,选择上游路由 **接触数据:**API Key、请求目标模型名称 **留存状态:**无请求正文持久化存储 02 · 原生转发 ### 流式转发与响应传输 **网关动作:**向对应模型提供商发起原生请求,流式透传返回数据段 **接触数据:**提示词与生成回答(仅在内存流经传输) **留存状态:**流式中转,无正文持久化落库 03 · 计量扣费 ### 用量对账与账单记录 **网关动作:**按上游返回的实际 Token 消耗或生成规格扣除账户余额 **接触数据:**Token 用量数字、请求响应耗时、状态码 **留存状态:**写入 1 条结构化计费元数据 04 · 归档生命周期 ### 元数据留存与账单对账 **网关动作:**维护调用流水与计量记录供客户对账与审计,不产生请求正文文档 **接触数据:**无新接触数据 **留存状态:**仅保留计费元数据、状态码与错误摘要 留存范围 ## 网关数据留存矩阵 列明请求经由 iwkey 网关流转时,各项数据的留存状态、用途、保留期限及可见范围。 | 数据类别 | 是否留存 | 主要用途 | 保留期限 | 访问权限范围 | | --- | --- | --- | --- | --- | | **文本/图像调用的提示词与生成回答(常规成功请求)** | ✕ 不留存 | 内存流式中转,透传完成后即时释放;成功请求不写入提示词与回答正文 | 不保留(0 秒) | 文本请求正文不可查 | | **计费日志(模型/Token/费用/时间/来源IP)** | ✓ 留存 | 计费核算、客户自主对账与网络风控 | 账户存续期间留存对账 | 用户本人(控制台导出)、平台管理员 | | **异常错误摘要(状态码/上游报错信息)** | ✓ 留存 | 接口故障定位与排障分析(不含请求正文) | 排障周期内必要留存 | 平台技术支持人员 | | **异步任务记录(视频任务ID/参数/状态/地址)** | ✓ 留存 | 任务状态轮询、成品交付与失败退款核验 | 任务存续期间供轮询与交付 | 提交者本人、平台管理员 | | **视频成片二进制文件** | 默认不存副本 | 上游直链有效期约 24 小时;申请开通备份后存 7 天 | 7 天后自动销毁 | 仅提交者本人 | | **工作台上传的参考素材(图片/视频)** | ✓ 留存 | 用于异步生成时引用与多轮迭代 | 保留至用户主动删除或账号注销 | 提交者本人、平台管理员 | | **账号信息、充值记录与财务订单** | ✓ 留存 | 账务凭证、账户余额维护与法定合规审计 | 依据法律法规要求期限留存 | 用户本人、平台财务审计人员 | | **模型训练、微调或数据二次转售副本** | ✕ 不产生 | 平台仅做网关中转,不从事模型训练或数据分销 | 不存在 | 无 | 机制解析 ## 异步长任务与实时请求的处理差异 解释不同服务模式下的客观技术机制与必要数据留存。 状态流转说明 ### 为何视频异步任务需要暂存参数 与文本请求的即时流式返回不同,视频生成属于耗时数分钟的多阶段异步工作流。网关系统必须在任务生命周期内暂存任务 ID、生成参数(含提示词)、执行状态与成品下载地址,以支撑客户端轮询进度、下载成片并在上游超时或失败时执行退款。文本补全与图像请求不存在异步轮询,网关数据库不持久化提示词与回复正文。 路由中转说明 ### 请求发送至指定模型提供方 iwkey 作为中转路由网关,在完成鉴权与用量计量后,将 API 请求原样发往客户所选模型的官方服务节点以完成运算。网关层不对模型返回进行任何内容改写或降级处理。 真实性与对账 ## 响应真实性与用量对账机制 平台以确定性的技术机制保障调用真实性与计费透明度。 01 · 原样透传 ### 透传原生响应标识 网关透传上游官方原始返回值与标识字段(如 `system_fingerprint`、`request_id` 与响应头),网关层不进行模型降级或参数伪装。 02 · 一调用一记录 ### 调用流水按次记录 每一笔 API 计费均对应唯一的调用记录。控制台支持按模型、API Key 和时间区间导出完整明细,供客户独立核验与对账。 03 · 失败不计费 ### 异常与失败自动退回 上游报错或网络中断时不扣除 Token 配额;视频任务若超时或执行失败,系统自动解冻并退回预扣额度。 访问与删除 ## 访问控制与数据擦除流程 平台对内部数据访问权限实施最小化控制,并提供标准化的数据注销机制。 权限控制 ### 内部访问权限与审计 仅平台授权系统管理员因故障排障需要可查阅计费与错误元数据日志,管理员关键操作全量留存审计日志;成功文本请求流式释放后不留存正文,系统不提供文本请求正文查看功能;异步任务因对账需要保留的任务参数由提交者与授权管理员在生命周期内受限查阅。 - **访问原则:**最小化权限与严格按需隔离 - **操作审计:**管理员关键操作全量留存审计日志 删除流程 ### 数据擦除与注销流程 客户可通过注册邮箱提交数据删除或账号注销申请。平台在收到请求并核验身份后,将及时完成对应数据清理与确认回复(依据法律法规需保留的账务记录除外,详见下文例外说明)。 - **发起方式:**注册邮箱联系 support@iwkey.com - **处理时效:**核验身份后及时完成处理 - **法定例外:**依据税务与监管要求需保留的财务账务记录除外(详见[《服务条款与隐私政策》](https://iwkey.com/legal/#privacy)) 合规与支持 ## 企业合规尽调与联系方式 安全联络 ### 安全 / 隐私 / 支持渠道 - **联系邮箱:**support@iwkey.com - **安全漏洞:**邮件主题加 `[SECURITY]`,优先响应 - **合规问卷:**支持企业采购安全合规自评与第三方尽调问卷代答 尽调核验 ### 合规审计与 Schema 快照 控制台应用层数据库结构快照以 JSON 公开([`/transparency/schema.json`](https://iwkey.com/transparency/schema.json)),作为网关应用数据库不包含请求与生成正文字段的合规基线声明。如需更深层次的供应商安全尽调,我们可在 NDA / 商务框架下提供生产核心路径只读核验材料与现场对账支持。 ### 页面修订记录 - 2026-10发布数据生命周期矩阵与留存对照表;明确区分异步长任务与流式请求处理机制。 - 2026-05发布数据库 Schema 结构公开 JSON 快照;上线双语透明度说明。