接入指南
第一次请求
选择实时模型并通过 cURL 完成第一条对话请求。
第一步：确认模型名称
先打开模型价格或控制台，复制当前令牌分组可以访问的模型名称。下面的 your-model 只是占位符。
第二步：验证模型列表
curl https://duolingai.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"如果这里返回 401，先处理令牌问题，不要继续排查模型。
第三步：发送对话请求
curl https://duolingai.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "your-model",
"messages": [
{"role": "system", "content": "回答要简洁、准确。"},
{"role": "user", "content": "用三点总结保持API密钥安全的方法。"}
]
}'成功响应通常包含模型生成的消息、完成原因和用量字段；具体字段可能随兼容实现与上游能力变化。
第四步：核对调用记录
返回成功后，在控制台检查：
- 使用的模型名称
- 响应状态和耗时
- 输入与输出用量
- 额度扣减是否符合当前规则
健康接口不是业务验收
网页能打开或健康检查通过，只证明服务进程可访问。只有实际模型请求成功，才表示当前令牌、分组、模型与上游链路全部可用。
失败时按顺序排查
GET /v1/models是否成功。- 模型名称是否来自实时列表。
- 令牌分组是否包含该模型。
- 账户是否有足够额度。
- 是否触发限流或上游临时错误。
详见错误排查。