这份教程只完成一件事:用最少步骤确认账号、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"
第三步:查询模型
macOS 或 Linux:
curl https://www.aifast.link/v1/models \
-H "Authorization: Bearer $AIFAST_API_KEY"
Windows PowerShell:
在刚才设置环境变量的同一个 PowerShell 窗口继续执行:
$aifastHeaders = @{
Authorization = "Bearer $env:AIFAST_API_KEY"
}
$aifastModels = Invoke-RestMethod `
-Uri "https://www.aifast.link/v1/models" `
-Method Get `
-Headers $aifastHeaders
$aifastModels.data | Select-Object id
从结果中复制一个当前账号可调用、且支持 OpenAI Chat Completions 的文本模型 ID。模型列表只用于发现模型,不能单凭列出某个 ID 就判断其支持所有协议;请同时在模型广场核对接口类型。模型名称和权限可能变化,正式使用时以控制台和接口返回为准。
第四步:发送短请求
把示例中的 YOUR_MODEL_ID 替换为上一步确认支持 Chat Completions 的模型 ID。
macOS 或 Linux:
curl https://www.aifast.link/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
}'
Windows PowerShell:
继续使用同一个 PowerShell 窗口中的认证请求头,通过对象生成 JSON,避免 Bash 续行和引号规则不兼容:
$aifastRequestBody = @{
model = "YOUR_MODEL_ID"
messages = @(
@{
role = "user"
content = "Reply with only: connection ok"
}
)
stream = $false
} | ConvertTo-Json -Depth 4
$aifastResponse = Invoke-RestMethod `
-Uri "https://www.aifast.link/v1/chat/completions" `
-Method Post `
-Headers $aifastHeaders `
-ContentType "application/json" `
-Body $aifastRequestBody
$aifastResponse.choices[0].message.content
看到模型回复后,再进入具体工具配置。
常见问题
curl 返回 HTML
通常是请求到了网页地址,而不是 API 地址。检查是否使用:
https://www.aifast.link/v1
Key 看起来正确但仍然 401
重新复制 Key,避免前后空格。不要把 Bearer 文字保存进 Key 字段;Bearer 应由请求头或客户端自动添加。
模型太多不知道选哪个
第一次测试选择支持 OpenAI Chat Completions 的文本对话模型。仅支持 Responses API、Anthropic Messages 或其他协议的模型,不能直接套用上面的请求;图像、视频和检索模型也需要各自的请求格式。
下一步
基础调用成功后,可以继续阅读 OpenAI Compatible API 快速接入,或者进入对应工具教程。