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 字段中返回;实际字段依模型和接口能力而定。

图像、视频、流式输出及特殊模型的请求与响应可能不同,不要将此文本对话示例直接套用于所有模型。