术语表
TokenToSea API 文档中出现的产品、计费与协议术语。
| 术语 | 含义 |
|---|---|
| 全能密钥 | sk-relay_ 开头的密钥,可调用全部模型接口与工具 API,模型与工具共用同一组限额。见认证与密钥。 |
| 模型密钥 | sk-relay_ 开头的密钥,只能调用模型接口。 |
| 工具密钥 | tts_tool_ 开头的密钥,只能调用工具 API。 |
| 订单专用密钥 | 绑定交易市场已购额度的密钥,不能调用 api.tokentosea.com。 |
| 调用范围 | 密钥可调用的型号:全部模型、指定服务商或指定模型。 |
| 限额周期 | 密钥 token 上限与金额上限的滚动统计窗口:每小时、每天、每周、每月(30 天)或自定义。 |
| 型号 ID | 请求体 model 字段的取值,区分大小写,例如 qwen3.8-flash。 |
| 服务商标识 | 型号所属厂商的标识,即 GET /v1/models 中的 owned_by,例如 qwen、zhipu。 |
| 区域 | 型号的执行区域:cn(国内)或 global(海外)。见区域与数据处理。 |
| 官方直供 | 平台直接对接厂商官方接口、按官方价格结算的型号标识。 |
| 已验收接口 | 型号经平台逐项测试后开放的接口(verified_endpoints)、响应方式(response_modes)与输入类型(verified_inputs)。未列出的组合返回 422。 |
| 幂等键 | Idempotency-Key 请求头的值。同一把密钥下,一个键只对应一次调用,可用于重放与取回结果。见幂等与重试。 |
| 请求编号 | 响应头 X-Request-Id / X-TokenToSea-Request-Id,值等于幂等键。 |
| 结果信封 | /v1/results、/v1/tasks、/v1/videos 与 202 响应返回的统一结构:id、run_id、status、billing_status、output 等。见异步任务与结果。 |
run_id | 平台调用记录编号,用于核对费用与联系支持。 |
| 资产(asset) | 平台转存的生成文件,通过 asset_id 重新获取下载链接,保留 30 天。 |
| 签名链接 | 资产的短期下载地址,最长 300 秒有效。 |
| 平台文件 / 音色 | 通过 /v1/files、/v1/audio/voices 创建的 file_tts_…、voice_tts_… 资源,只能由创建它的密钥使用。 |
| 预留 | 受理请求时按最大可能用量冻结的金额,结算后退回未用部分。见计费与结算。 |
| 结算 | 按厂商报告的实际用量与价格规则计算并扣除费用。 |
| 可用余额 | 余额减去所有未结算调用的预留金额。 |
待核对(needs_review) | 结果或用量无法自动确认的调用。预留暂不释放,由平台依据厂商回执人工扣费或释放。 |
| 价格版本 | 型号价格的版本号(price_version)。调用按受理时的版本结算。 |
| 价格规则(tariff) | 型号的计价规则集合:每条规则包含适用条件(when)与计量项(components)。 |
| 计量项 | 计费的数量维度,例如输入 token、缓存命中 token、输出 token、输出秒数、图片张数、字符数。 |
| 暂定价格 | 尚未查到厂商公布单价时,以可比型号最高价设定的价格,pricing_status 为 provisional。 |
| 价格快照 | 受理时冻结的价格版本、汇率与计价条件,结算时使用同一份快照。 |
| SSE | Server-Sent Events,流式输出使用的 HTTP 协议。 |
| 结束帧 | 流式输出中表示结束的帧,例如 data: [DONE]、message_stop、response.completed。平台在结算完成后才发出。 |
| 首字延迟(TTFT) | 从发出请求到收到第一个内容分片的时间。 |
| TPS | 每秒输出 token 数:completion_tokens ÷(最后一个内容分片时间 − 第一个内容分片时间)。 |
| 实时会话 | 通过 WS /v1/realtime 建立的双向音频会话,单次最长 60 秒、8 轮。 |
| PCM16 | 16 位有符号小端线性 PCM 音频,实时会话使用的音频格式。 |
| System One | 返回结构化答案(概率、选项、评分、定位框、字段)的模型类别。见 System One 指南。 |
| Noul / Choice / Score / Box | System One 的四种判断原语:条件概率、单选、有序评分、区域定位。 |
| 执行节点 | 实际调用厂商接口的内部服务。用户只通过统一入口访问,不能直接调用。 |