API 参考
OpenAI 兼容接口
了解模型列表与 Chat Completions 基础请求形状和兼容边界。
朵灵 AI 提供常见OpenAI SDK可使用的兼容接口。第一版以模型列表和Chat Completions作为基础范围。
Base URL
https://duolingai.com/v1获取模型列表
curl https://duolingai.com/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"模型可见范围可能受令牌分组、账户状态和当前渠道影响。
创建对话补全
POST /v1/chat/completions
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY基础请求：
{
"model": "your-model",
"messages": [
{ "role": "user", "content": "你好" }
]
}常见字段：
| 字段 | 类型 | 说明 |
|---|---|---|
model | string | 实时可用的准确模型名称 |
messages | array | 对话消息列表 |
stream | boolean | 是否使用流式响应 |
temperature | number | 采样参数；是否生效取决于模型 |
max_tokens | number | 输出限制；具体兼容性取决于模型 |
不要假设所有参数都受支持
不同模型可能忽略、不支持或限制某些参数。上线前应对你实际使用的模型和参数组合做真实测试。
消息角色
常见角色包括：
system：提供全局行为或上下文user：用户输入assistant：历史模型响应
角色与多模态内容支持情况由实际模型决定。
兼容边界
- 兼容接口不代表与任何单一厂商100%等价。
- 模型名称必须使用价格页或控制台的实时名称。
- 工具调用、多模态、推理字段等高级能力需逐模型验证。
- 重要业务应记录请求ID、状态码和耗时，便于排障。
继续阅读流式响应。