德他数据 / API 教程

文本对话示例

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

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

核心解答

向 /v1/chat/completions 发送 model、纯文本 messages、正数输出上限和 stream:false。成功时读取 choices[0].message.content;超时或结果不明时先查请求记录与账务,不应立即重复提交。

最小请求

以下为 Bash / Linux / macOS 示例。Windows 可使用后续 Python 或 JavaScript 示例。请在自己的运行环境设置 DETA_API_KEY 和 DETA_MODEL,勿把真实值提交到仓库。

curl --request POST "https://www.data123.com.cn/v1/chat/completions" \
  --header "Authorization: Bearer ${DETA_API_KEY}" \
  --header "Content-Type: application/json" \
  --data "{\"model\":\"${DETA_MODEL}\",\"messages\":[{\"role\":\"user\",\"content\":\"用一句话介绍德他数据。\"}],\"max_tokens\":64,\"stream\":false}"

替换配置

DETA_MODEL 必须是你获准调用的德他模型 ID,不是品牌名称,也不是随意填写的供应商模型名。

测试前核实账户余额、令牌美元预算、模型范围、过期时间和 IP 限制。

读取结果

成功响应中的 choices[0].message.content 为文本结果。usage 用于查看返回用量;最终消费以德他美元账务记录为准。

限制与风险

不传入图片、音频、视频、tools、stream:true 或其他扩展字段。不要给失败请求配置无限重试。

502 或超时可能意味着上游结果尚待对账,应先核验请求记录。

常见问题

可以去掉输出上限吗?

不可以。当前受控调用需要明确的正数输出上限,用于请求验证和费用预留。

接下来阅读

接口开放范围 · 错误码排查 · 密钥安全与上线检查

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