德他数据 / API 教程

编程客户端:协议兼容检查与安全配置

提供编程助手和第三方客户端接入德他的协议检查表,说明 Base URL、流式、工具调用、模型发现与后台请求的兼容边界。

作者:德他数据技术团队 · 更新于 2026-09-24

核心解答

编程客户端只有支持非流式纯文本 Chat Completions 且不依赖未开放功能时,才可能对接德他已核准方案。依赖 Responses、原生 Messages、工具、流式或 /v1/models 的客户端不能只改 Base URL 就保证可用。

阅读范围与当前状态

本篇为完整的协议说明或接入准备指南,不代表所述原生、视频或扩展能力已在德他开放。真实调用以接口开放范围和具体模型的核准状态为准。

不以“OpenAI 兼容”作为唯一判断

客户端的界面名称不能说明它实际发送什么请求。有的客户端会先查询模型列表,或默认启用流式、工具调用及后台补全,必须检查实际协议和配置能力。

兼容检查表

| 检查项 | 当前德他要求 |

| --- | --- |

| 生成协议 | /v1/chat/completions |

| 输入 | 纯字符串 messages |

| 输出模式 | 非流式,明确正数输出上限 |

| 工具与自动执行 | 不支持 |

| 原生 Messages / Responses | 不支持 |

| 自动模型发现 | /v1/models 尚未开放 |

| 模型配置 | 使用已核准德他模型 ID |

客户端如果无法关闭不支持的功能,应判为当前不兼容,不要反复尝试未知路由。

Base URL 与凭据

有些客户端要求根地址,有些要求填写到 /v1。查看客户端实际拼接结果,避免 /v1/v1 或遗漏路径。API Key 使用专门为该客户端创建的德他令牌,不填写登录密码或原厂密钥。

成本和代码安全

为客户端设置独立美元预算、模型范围和有效期,评估后台自动请求。提交代码前去除密钥、客户数据与内部配置;工具自动执行还涉及文件和命令权限,当前德他不提供这类能力承诺。

验证顺序

先确认客户端支持所需模式,再用自己的后端最小文本请求验证已授权模型。最后在可控制预算的环境检查客户端实际请求与账务。若只能运行工具驱动或流式流程,应先等待适配或选择支持当前模式的使用方式。

常见问题

填入模型名称仍提示无法加载模型怎么办?

客户端可能强制依赖尚未开放的模型发现接口,应检查是否能手动配置并关闭探测。

关闭流式就一定兼容吗?

不一定,还要检查协议、输出上限、工具和附带字段。

Python 示例 · JavaScript 示例 · 密钥安全

关联文档:德他数据教程。本文按德他实际功能独立编写。