常见问题 FAQ

接入

用本平台需要改代码吗？

不需要重写。本平台是 OpenAI 兼容接口，官方 openai SDK 只改 base_url 即可；Claude / Gemini 用各自官方 SDK 指到本平台。不写代码的话用 客户端接入。

Base URL 到底要不要带 /v1？

• 直接调 API 或用 OpenAI SDK：要带 /v1（如 https://gateway.mindproxy.ai/v1）。
• 部分桌面客户端会自动补 /v1，那里只填到域名。
• 报 404 基本就是 /v1 多了或少了，调一下即可。

支持哪些模型？

OpenAI、Claude、Gemini 等主流模型。实际可用列表以你的 Key 为准，用 GET /v1/models 或控制台「模型价格」查看。

能用 Claude / Gemini 的原生格式吗？

可以。Claude 用 /v1/messages，Gemini 用 generateContent。也可以统一用 OpenAI 兼容格式调所有模型。

计费

怎么收费？

预付费钱包：先充 USDT，调用按真实用量扣费。文本按 token，图像按张，任务按结算。详见 充值与计费。

充值多久到账？

链上确认后自动入账。可在控制台「充值记录」看订单状态。

流式请求中途断了会乱扣费吗？

不会刻意多扣。平台会尽量按已产生的真实用量结算；拿不到真实用量时按预估处理，差额由后台兜底释放。

任务失败会扣费吗？

不会。任务失败 / 取消 / 过期释放冻结、不计费。

缓存命中会便宜吗？

会。命中提示缓存或平台响应缓存时，缓存读取部分按 cache_read_price 计费，通常远低于输入价。响应头 X-TT-Cache-* 会标明节省。

排障

调用报 401？

Key 错误、带了空格、或被禁用。检查 Authorization: Bearer sk-...。

报 402？

余额不足（billing_shortfall）或超 Key 月额度（api_key_quota_exceeded）。去充值或调额度。

报 429？

触发限流。按响应头 Retry-After 重试，建议指数退避。

怎么向客服报问题？

带上响应头里的 X-TT-Request-ID、大致时间、模型和完整错误体。详见 错误码与限流。

安全

API Key 泄漏了怎么办？

立即在控制台 rotate（轮换）这把 Key，旧明文会立刻失效。建议不同应用用不同 Key 并各设月额度。

Key 明文找不回了？

明文只在创建时展示一次，找不回只能 rotate 出新的。