快速开始
入门 · 约 5 分钟
使用 cURL 完成第一次 AI API 调用
cURL 不依赖编程语言，适合在正式开发前验证 API Key、接口地址和模型名称是否正确。
开始前准备
- 已注册 AINN API 账号
- 已在控制台创建 API Key
- 电脑已安装 cURL
1
步骤 1
确认模型名称
前往模型广场选择当前可用模型，复制页面显示的模型标识。教程中的 your-model 必须替换为实际模型名称。
- 先用成本较低的模型验证调用链路
- 模型供应和价格以模型广场实时信息为准
2
步骤 2
把 API Key 保存为环境变量
使用环境变量可避免把密钥直接写进代码仓库或截图。
macOS / Linux
export AINN_API_KEY="你的 API Key"Windows PowerShell
$env:AINN_API_KEY="你的 API Key"
3
步骤 3
发送聊天请求
请求使用 OpenAI 兼容的 Chat Completions 格式。成功后，回复内容通常位于 choices[0].message.content。
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": "用一句话介绍你自己"}
]
}'
4
步骤 4
检查常见错误
如果请求失败，先查看 HTTP 状态码和返回的错误信息，再按下面顺序排查。
- 401：检查 API Key 是否完整、是否带有多余空格
- 模型不存在：重新从模型广场复制当前模型标识
- 余额不足：检查控制台余额或联系客服申请体验额度
- 连接错误：确认接口地址包含 /v1，且服务器能访问 HTTPS
完成检查
- 终端返回 JSON 响应
- choices 数组中包含模型回复
- 控制台能够看到对应调用记录
继续完成项目接入
选择合适模型并估算实际成本
教程中的模型名只是占位符。请根据业务场景选择当前可用模型，再用真实 Token 用量估算预算。