01认识入口
懂AI中转站（DongAI，简称懂AI）由北京同于野科技有限公司运营，面向开发者与团队，提供模型 API 接入及密钥、账户余额、用量和已配置服务路由的管理。底层模型能力由对应供应商提供。
本页由运营方整理，供初次联调参考。示例已经过离线验证，尚未进行真实模型调用验收，不作为性能、可用性或交付案例。
- 产品介绍
- tongyuye.com/products/dongai/ · 核对产品、运营主体与公开能力
- 服务控制台
- api.tongyuye.com · 账户与服务管理
- 接口文档
- api.tongyuye.com/docs · 当前接入要求
API 基础地址示例：
https://api.tongyuye.com/v102下载与预览
下载包包括中文说明、可运行客户端和离线测试。Python 3.10 或更新版本即可使用默认传输，无需第三方 Python 依赖。
下载接入示例 ZIP约 15 KB · 六个文件 · 不含账号密钥
解压后在该目录运行以下命令。没有 --execute 时，只预览固定地址、HTTP 方法和字段名，不读密钥、不联网。模型 ID 必须自行指定。
python -X utf8 dongai_example.py models
python -X utf8 dongai_example.py chat --model MODEL_ID_FROM_YOUR_ACCOUNT03先核对模型列表
在服务控制台核对账户情况，创建或选用自己的 API Key。在本地环境设置 DONGAI_API_KEY，不要写入代码、命令参数或共享日志。PowerShell 可以通过密码输入框设置当前进程变量：
$credential = Get-Credential -UserName 'DONGAI_API_KEY' -Message '在密码栏输入自己的 API Key'
$env:DONGAI_API_KEY = $credential.GetNetworkCredential().Password
Remove-Variable credential确认后，显式执行一次模型列表请求：
python -X utf8 dongai_example.py models --execute对应 GET /v1/models。客户端仅显示模型 ID 和数量；列表不能替代对当前账户可用范围的核对。使用结束可在 PowerShell 执行 Remove-Item Env:DONGAI_API_KEY。
04发起一次文本请求
把占位模型 ID 替换成自己账户中已核对的值，再选择是否执行：
python -X utf8 dongai_example.py chat --model MODEL_ID_FROM_YOUR_ACCOUNT --execute对应 POST /v1/chat/completions，请求结构如下。这里只展示结构，不是实际调用结果：
{
"model": "MODEL_ID_FROM_YOUR_ACCOUNT",
"messages": [
{
"role": "user",
"content": "请简短回复：连接测试。"
}
],
"stream": false
}真实请求可能产生计费或消耗配额，按当前服务说明执行。初次联调使用简短测试文本。客户端仅处理非流式文本，输出文本以及存在时的模型名和三项 Token 用量。
05切换 curl 与排查错误
同一客户端也支持使用本机 curl 8.4.0 或更新版本；密钥通过标准输入配置传递，不放入进程命令参数。
python -X utf8 dongai_example.py models --transport curl
python -X utf8 dongai_example.py models --transport curl --execute两种传输均固定官方 HTTPS 地址、禁止重定向、不自动重试，并限制响应大小。401 / 403 时核对密钥和账户范围；404 时核对接口与模型 ID；429 时查看当前服务提示，不反复重发。
下载包的 README 与 CURL_EXAMPLES 说明文件列出完整行为、限制及离线测试命令。终端输出会遮蔽本次密钥，但使用者仍需保护自己的提示词和返回资料。
06继续核对实际接入条件
示例不是完整生产 SDK，未验证流式、多模态、并发、持续可用性或模型质量。模型清单、价格、账户规则与使用限制以当前服务和文档为准。