API 概览

DDTokens 的主要接入方式是 OpenAI 兼容接口。对于已有 OpenAI SDK 的项目，你通常只需要替换 API Key 和 base_url。

基本配置

项目	值
Base URL	https://apiddt.com/v1
认证方式	Authorization: Bearer <DDDT_API_KEY>
默认协议	OpenAI Chat Completions

示例请求

curl "https://apiddt.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DDDT_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      { "role": "user", "content": "Hello!" }
    ]
  }'

响应结构

成功响应通常包含：

• id：请求或响应标识。
• model：实际处理请求的模型。
• choices：模型输出内容。
• usage：输入、输出和总 Token 数。

不同模型和上游厂商可能返回额外字段。生产环境应只依赖你实际需要的稳定字段。

兼容边界

DDTokens 以 OpenAI 兼容接入为主。不同厂商在模型参数、工具调用、多模态能力、流式输出和错误格式上可能存在差异。

如果你需要稳定行为，建议：

• 固定模型 ID。
• 在上线前用真实请求验证参数兼容性。
• 在业务侧记录请求 ID、模型、费用和耗时。
• 为可重试错误配置重试策略。