API 基础
Chat Completions 请求
对话请求使用 OpenAI 兼容的 Chat Completions 格式。请先从模型广场确认模型标识及当前可用状态。
1
章节 1
接口与请求字段
发送 POST 请求至 https://api.ainn.cc/v1/chat/completions。最小请求体包含 model 与 messages。
- model:模型广场显示的实际模型标识
- messages:按顺序提供 role 与 content
- 其他参数和能力因模型而异,请以模型广场当前信息和具体模型要求为准
2
章节 2
最小请求示例
以下示例使用环境变量中的密钥;将 your-model 替换为当前可用模型。
cURL
curl https://api.ainn.cc/v1/chat/completions \
-H "Authorization: Bearer $AINN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"your-model","messages":[{"role":"user","content":"你好"}]}'
3
章节 3
读取响应
成功响应通常在 choices[0].message.content 中包含文本回复。用量信息通常在 usage 字段中返回;实际字段依模型和接口能力而定。
图像、视频、流式输出及特殊模型的请求与响应可能不同,不要将此文本对话示例直接套用于所有模型。