Appearance
Chat Completions
Chat Completions 适合多轮对话、普通文本生成和兼容 OpenAI Chat Completions 的现有应用。
请求地址
text
POST https://ai.aidmx.xyz/v1/chat/completions认证
http
Authorization: Bearer $AIDMX_API_KEY
Content-Type: application/json参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称，使用控制面板中显示的可用模型。 |
| messages | array | 是 | 对话消息数组，常见角色包括 system、user、assistant。 |
| stream | boolean | 否 | 是否使用流式输出，是否支持以当前模型和接口实际表现为准。 |
| temperature | number | 否 | 采样温度。不同模型可能接受不同范围。 |
| max_tokens | number | 否 | 输出 token 上限。实际限制以模型能力和控制面板显示为准。 |
不确定某个 OpenAI 参数是否被当前模型接受时，先用最小请求验证，再逐步增加参数。
示例
bash
curl -N https://ai.aidmx.xyz/v1/chat/completions \
-H "Authorization: Bearer $AIDMX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "<model-from-panel>",
"stream": true,
"messages": [
{"role": "system", "content": "你是简洁可靠的技术助手。"},
{"role": "user", "content": "给我一个 AIDMX API 的最小调用示例。"}
],
"temperature": 0.3
}'错误
| 状态 | 常见原因 |
|---|---|
| 400 | JSON 格式错误、缺少 model 或 messages、参数不被当前模型接受。 |
| 401 | API Key 无效或缺失。 |
| 403 | 当前账号、密钥、模型或余额状态不允许调用。 |
| 404 | 模型名称不存在或接口路径错误。 |
| 429 | 达到当前额度或频率限制。 |
计费说明
Chat Completions 通常按模型实际处理的输入和输出 token 计量。价格、模型可用性、上下文长度、额度和频率限制以控制面板实时显示为准。