常见问题

DDTokens 是什么？

DDTokens 是一个 OpenAI 兼容的 AI 模型聚合与分发网关。你可以用 DDTokens API Key 调用多个模型，并通过控制台查看用量、费用和日志。

是否兼容 OpenAI SDK？

是。大多数 OpenAI SDK 项目只需要替换 API Key 和 base_url：

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-key-here",
    base_url="https://apiddt.com/v1",
)

支持哪些模型？

DDTokens 支持的模型以控制台和价格页展示为准。常见系列包括 OpenAI、Claude、Gemini 等。具体模型名、价格和可用性可能随上游资源变化。

如何创建 API Key？

登录控制台，在令牌或 API Key 管理页面创建。建议生产、测试和本地开发分别使用不同 Key。更多说明见创建 API Key。

如何计费？

DDTokens 按实际 Token 用量计费。费用通常由输入 Token、缓存 Token、输出 Token、模型标准价格和账户折扣共同决定。更多说明见模型价格。

为什么同一模型价格可能不同？

同一模型可能由不同供应商提供。供应商不同，成本、容量、稳定性和参数兼容性都可能不同。默认路由适合大多数场景；需要固定供应商时，阅读渠道与路由。

免费模型可以用于生产吗？

不建议。免费模型适合测试接入和轻量验证，通常有更严格的 RPM、RPD 和并发限制。生产服务应使用付费模型并配置重试、限流和日志。

请求失败时先看哪里？

按顺序检查：

1. API Key 是否有效。
2. Base URL 是否是 https://apiddt.com/v1。
3. 账户余额和令牌额度是否充足。
4. 模型名是否可用。
5. 控制台日志是否有请求 ID 和错误详情。

更多排查步骤见故障排查。

如何控制成本？

建议为每个环境创建单独令牌，并设置额度。生产环境还应记录请求 ID、模型、Token 用量和费用，便于对账和告警。

如何获取帮助？

如果控制台提供工单系统，优先通过工单提交问题。联系支持时，请提供请求时间、模型、状态码、错误响应和请求 ID，不要提供完整 API Key。