这份教程只完成一件事:用最少步骤确认账号、Key、模型和接口链路都能正常工作。先跑通短请求,再配置 Cursor、Dify、Codex 或自己的应用。
开始前检查
- 打开 AI快站注册页面 创建账号。
- 登录控制台后进入“API 令牌”。
- 准备一个不会提交到代码仓库的本地环境变量。
配置步骤
第一步:创建 API Key
在控制台创建一个新令牌。建议名称写清用途,例如:
macbook-local-test
cursor-work
production-order-service
不同设备和项目使用不同 Key,后续发现泄露时可以单独撤销,不会影响所有业务。
第二步:保存为环境变量
macOS 或 Linux:
export AIFAST_API_KEY="你的_API_Key"
Windows PowerShell:
$env:AIFAST_API_KEY="你的_API_Key"
第三步:查询模型
curl https://www.aifast.club/v1/models \
-H "Authorization: Bearer $AIFAST_API_KEY"
从结果中复制一个真实模型 ID。模型名称可能随上游开放情况变化,正式使用时以控制台和接口返回为准。
第四步:发送短请求
curl https://www.aifast.club/v1/chat/completions \
-H "Authorization: Bearer $AIFAST_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL_ID",
"messages": [{"role": "user", "content": "只回复:连接成功"}],
"stream": false
}'
看到模型回复后,再进入具体工具配置。
常见问题
curl 返回 HTML
通常是请求到了网页地址,而不是 API 地址。检查是否使用:
https://www.aifast.club/v1
Key 看起来正确但仍然 401
重新复制 Key,避免前后空格。不要把 Bearer 文字保存进 Key 字段;Bearer 应由请求头或客户端自动添加。
模型太多不知道选哪个
第一次测试选择一个文本对话模型即可。图像、视频和检索模型的请求格式可能不同,不适合作为基础链路的第一条测试请求。
下一步
基础调用成功后,可以继续阅读 OpenAI Compatible API 快速接入,或者进入对应工具教程。