常见问题 · TokenToSea 开发者文档

接入#

Base URL 是什么？#

推理接口为 https://api.tokentosea.com/v1。OpenAI SDK 填这个地址；Anthropic SDK 填 https://api.tokentosea.com（不带 /v1）。实时音频为 wss://api.tokentosea.com/v1/realtime?model=<型号>。见用官方 SDK 接入。

可以直接从网页前端调用吗？#

不可以。api.tokentosea.com 不返回 CORS 响应头，浏览器会拦截跨域请求；把密钥放进前端也会导致泄露。请由你的后端调用并转发结果。

可以使用 OpenAI 或 Anthropic 的官方 SDK 吗？#

可以。对话类型号兼容 Chat Completions、Responses（无状态）与 Messages 三种协议，具体以型号开放的接口为准。建议显式传入 Idempotency-Key 并关闭 SDK 自动重试。

为什么同一个型号有的接口能用、有的返回 422？#

每个型号只开放逐项验收过的接口、响应方式（JSON / 流式）和输入类型。用 GET /v1/models 的 verified_endpoints、response_modes、verified_inputs 确认，见选择型号。

支持联网搜索、代码执行等托管工具吗？#

目前不支持，这些附加产品没有单独定价，请求中出现时返回 422 hosted_tools_not_priced。函数调用（function / custom 工具）可以使用。

Responses 接口能保存对话吗？#

不能。平台以 store: false 转发；previous_response_id、conversation、background 与 store: true 返回 422。请在 input 中自行携带历史。

密钥#

密钥丢了还能找回吗？#

不能。平台只保存密钥的 SHA-256 摘要，明文只在创建时显示一次。请新建一把，并撤销或删除旧的。

全能密钥和模型密钥有什么区别？#

两者格式相同（sk-relay_…），都能调用全部模型接口；全能密钥还能调用工具 API，模型与工具共用同一组限额。见密钥类型。

删除密钥会影响历史账单吗？#

不会。删除会立即撤销密钥并把它从列表中移除，已经发生的调用记录、账单流水和用量统计都保留。但该密钥创建的异步结果、生成文件、平台文件与音色将无法再访问。

为什么一个很小的请求也提示超出密钥限额？#

限额在受理时按“已用量 + 进行中调用的预留 + 本次预留”检查，而预留是按请求上限估算的保守值，例如未设置 max_tokens 时按型号默认输出上限预留。降低 max_tokens，或提高限额。见预留金额如何估算。

计费#

价格比厂商官网贵吗？#

不贵。所有型号按厂商官方现行价格计费，不加价、不收服务费。国内型号以人民币标价，受理时按当时汇率折算为美元扣费。

响应里为什么没有费用？#

推理响应保留厂商原生结构，只包含厂商的 usage。费用请在控制台的账单、「我的 Key」或「模型测试」中查看。

为什么余额够，却提示余额不足？#

可用余额等于余额减去所有未结算调用的预留。并发调用、含图片或文件的请求（按型号最大输入量预留）、较大的 max_tokens 都会占用较多预留。等进行中的调用结束，或充值后再试。

调用失败会扣费吗？#

请求被拒绝或厂商明确拒绝（4xx）时不扣费。结果无法确认时（例如厂商 5xx、流中断），调用进入待核对，预留暂不释放，由平台依据厂商回执人工核对后扣费或全额释放。见待核对。

客户端中途断开，能省下费用吗？#

不能。平台会把厂商的输出读完并按实际用量结算，完整结果可以用原幂等键取回。控制成本请设置合理的 max_tokens。

流式与异步#

为什么流式输出的最后一段要等一会儿？#

结束帧（finish_reason 分片、[DONE]、message_stop、response.completed）会在结算完成后才发出，所以最后一段包含结算时间。测量 TPS 时请用内容分片的时间。见流式输出。

为什么 usage 分片比 finish_reason 分片先到？#

带 usage 的分片不是结束帧，会立即转发；带 finish_reason 的分片要等结算完成。客户端不要依赖两者的顺序。

视频任务要多久？结果能保存多久？#

取决于型号与参数，通常为数十秒到数分钟。平台每 5 秒查询一次厂商，最长 24 小时。结果记录约保留 31 天，生成文件保留 30 天，下载链接最长 300 秒有效。见异步任务与结果。

网络断了，要不要重新提交？#

不要换新的幂等键重新提交。用原幂等键查询 GET /v1/results/{键}；返回 404 说明平台没有这次请求的记录，此时用原键原样重发是安全的。见幂等与重试。

型号与区域#

型号 ID 区分大小写吗？#

区分。请与目录中的 ID 完全一致，例如 MiniMax-M3。

请求会被发到海外吗？#

只有 region 为 global 的 6 个 System One 型号在海外执行节点处理，其余型号都在国内处理。平台按型号路由，不跨区回退。见区域与数据处理。

有速率限制吗？#

平台对推理请求没有按分钟计的频率限制；每个账号同时进行中的调用最多 8 个，超出返回 409。见限制与配额。

有服务等级协议（SLA）吗？#

目前没有公开的 SLA 承诺。生产接入请按幂等与重试与错误处理实现容错。