API 教程

德他数据 API 教程：快速开始、协议范围、常用示例、错误排查与安全接入实践。

• 快速开始与 API 鉴权

  从邮箱注册到首次 API 请求，说明德他数据的服务地址、Bearer 鉴权、模型核准、余额和令牌预算检查顺序。

• 接口开放范围

  查阅德他数据当前受控开放的文本、同步图片和公开目录接口，区分协议兼容、产品展示与实际调用权限。

• 文本对话示例

  通过 cURL 学习发送非流式文本请求，配置模型与令牌、设置输出上限，并读取结果与核对调用费用。

• 文本对话参数说明

  详解德他文本对话接口的消息角色、输出上限、采样参数及同步响应，说明不支持字段和 Responses 协议边界。

• 同步图片生成

  介绍德他同步图片生成的必填字段、图片数量、URL 返回格式和按张结算条件，帮助区分生成、编辑与异步任务。

• 模型范围、余额与预算

  理解模型目录、账户美元余额与令牌预算之间的关系，按权限、预算、周期额度和频率限制排查调用失败。

• 错误码与故障排查

  按 HTTP 状态和 error.type 定位鉴权、预算、频率、配置及待对账问题，提供脱敏报障与付费请求重试原则。

• 控制台与 API 鉴权的区别

  说明德他网页登录会话、邮箱验证码和模型 API 令牌的用途，帮助开发者正确区分控制台权限与服务端鉴权。

• 账户资料与美元账务

  介绍账户资料、客户归属与美元账务的查看方法，解释可用余额、预留金额、确认消费及人工核验流程。

• 令牌管理与调用记录

  指导按应用隔离 API 令牌，配置模型范围、美元预算、有效期与 IP 限制，并用请求编号核对调用和费用。

• 注册与首次接入准备

  说明邮箱验证码自助注册、未分配客户档案和普通客户权限，以及首次调用前的模型核准、余额与令牌准备。

• Python HTTP 接入示例

  使用 Python 标准库 urllib 发送德他非流式文本请求，演示环境变量、超时、HTTP 错误与请求编号处理。

• JavaScript HTTP 接入示例

  使用 Node.js 服务端 fetch 接入德他文本 API，说明环境变量、超时控制、错误读取和避免前端泄露密钥。

• 密钥安全与上线检查

  从密钥保存、最小权限、预算隔离到上线验收，建立德他 API 接入的凭据保护、脱敏日志与异常费用处理流程。

• Claude 消息调用：格式转换与文本接入

  用一个中文摘要场景比较 Claude Messages 与德他纯文本接口，说明系统提示、消息数组、输出限制和兼容性检查。

• GPT 图像生成与编辑：能力边界与接入准备

  区分从文字生成图像、参考图编辑和图像 Token 计费，提供提示词组织、素材准备、结果验收及德他同步图片接入判断。

• Gemini 图像：多模态结构与生成准备

  认识 Gemini 图像任务的多模态输入与内容块输出，整理提示词、素材和结果验收清单，并明确德他原生接口尚未开放。

• Seedream 图片生成：提示词、规格与验收

  围绕 Seedream 图像需求组织提示词与规格清单，说明固定按张、复杂规格及参考图任务的区别和德他调用前检查。

• Seedance 视频生成：分镜设计与任务流程

  介绍 Seedance 视频需求的分镜、镜头、素材与验收准备，说明异步任务去重、结果保存和德他当前视频开放边界。

• 可灵图像：产品选择与素材准备

  区分可灵相关图像产品与视频产品，整理图像需求、素材授权、渠道和协议检查步骤，避免误用视频路由或未核准规格。

• 可灵视频：任务规划与渠道差异

  为可灵视频接入准备输入素材、镜头描述、规格和任务追踪方案，区分可灵原生与百炼托管产品，说明德他视频尚未开放。

• MiniMax 图像：原生字段与兼容接口区别

  比较 MiniMax 原生图像生成与德他同步图片入口，解释字段和返回格式不能直接互换，并提供提示词与结果处理准备。

• MiniMax 视频：异步生命周期与接入准备

  整理 MiniMax 视频任务的创建、跟踪与结果保存流程，说明不同版本协议不能混用，以及德他当前视频服务的开放边界。

• 异步视频接口：任务状态与可靠性设计

  说明视频异步任务的状态、轮询、去重、回调安全和费用核验原则，为后续 API 适配建立清晰验收标准。

• 语音合成：文本准备与音频交付设计

  介绍语音合成中的文本规范化、分段、音色与授权、音频格式和验收，明确德他音频 API 当前未开放。

• 火山方舟原生协议：与兼容入口的区别

  整理火山方舟原生接入中的模型、任务类型、鉴权和返回结构核对流程，说明不能以换域名代替德他协议适配。

• 火山素材库：资源生命周期与安全准备

  梳理素材上传、权限、引用、保留与删除的设计要点，区分外部文件地址与供应商素材标识，说明德他素材接口未开放。

• 阿里百炼原生协议：产品与协议选择

  区分百炼模型服务、应用服务和托管产品，列出原生接入的工作空间、模型、输入输出与费用核对要点。

• 可灵原生协议：鉴权、任务与适配边界

  梳理可灵原生产品接入前的协议、身份、任务和资源检查，区分原生服务与托管渠道，并明确德他当前未开放原生端点。

• Gemini 原生协议：contents、parts 与兼容迁移

  解释 Gemini 原生消息的 contents 与 parts 结构、响应读取和消息角色差异，提供迁移到德他纯文本入口的判断方法。

• Claude 原生 Messages：系统提示与内容块

  介绍 Claude Messages 的系统提示、消息轮次和内容块响应，说明与德他文本兼容协议的差异以及原生能力开放限制。

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

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

• 火山方舟接入范围与准备指南

  梳理火山方舟文本、图像、视频与素材能力的接入准备，解释原生协议与德他兼容入口的不同边界。

• 百炼与可灵：协议选择与接入检查

  比较阿里百炼与可灵产品的协议选择、素材准备和计费核对流程，帮助避免混用不同平台的路由和模型标识。

• Gemini 与 Claude：原生协议与兼容接入

  比较 Gemini 与 Claude 原生协议和文本兼容接入，说明消息格式、工具与流式能力，以及德他当前的开放范围。