这份教程只完成一件事:用最少步骤确认账号、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.hk/v1/models \
-H "Authorization: Bearer $AIFAST_API_KEY"
Windows PowerShell:
$headers = @{ Authorization = "Bearer $env:AIFAST_API_KEY" }
$models = Invoke-RestMethod -Uri "https://www.aifast.hk/v1/models" -Headers $headers
$models.data | Select-Object id
PowerShell 使用 $env:AIFAST_API_KEY 读取环境变量;不要直接复制 Bash 的 $AIFAST_API_KEY 或反斜杠换行。部分 Windows PowerShell 版本把 curl 作为其他命令的别名,下面使用原生 Invoke-RestMethod。
从结果中复制一个当前账号可调用的模型 ID。模型名称可能随上游开放情况变化,正式使用时以控制台和接口返回为准。
第四步:发送短请求
将 YOUR_MODEL_ID 替换为上一步返回的文本对话模型 ID。macOS 或 Linux:
curl https://www.aifast.hk/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:
$body = @{
model = "YOUR_MODEL_ID"
messages = @(@{ role = "user"; content = "Reply with OK" })
stream = $false
} | ConvertTo-Json -Depth 5
$response = Invoke-RestMethod -Method Post -Uri "https://www.aifast.hk/v1/chat/completions" -Headers $headers -ContentType "application/json; charset=utf-8" -Body ([System.Text.Encoding]::UTF8.GetBytes($body))
$response.choices[0].message.content
这是一次真实模型调用,可能产生费用;先确认模型价格和令牌额度。看到模型回复后,再进入具体工具配置。
常见问题
AI API 中转站怎么用?
先注册并创建独立 API Key,再请求 https://www.aifast.hk/v1/models 获取当前账号可用的真实模型 ID,最后用 /v1/chat/completions 发送一条最小请求。请求成功后再配置 Cursor、Dify、Codex 或自己的应用;不要只凭网页能打开或一次 HTTP 200 就判断长期稳定性。
curl 返回 HTML
通常是请求到了网页地址,而不是 API 地址。检查是否使用:
https://www.aifast.hk/v1
Key 看起来正确但仍然 401
重新复制 Key,避免前后空格。不要把 Bearer 文字保存进 Key 字段;Bearer 应由请求头或客户端自动添加。
模型太多不知道选哪个
第一次测试选择一个文本对话模型即可。图像、视频和检索模型的请求格式可能不同,不适合作为基础链路的第一条测试请求。
下一步
| 你准备接入什么 | 下一步 |
|---|---|
| 自己的 Python 或 Node.js 应用 | OpenAI Compatible API 与 SDK 示例 |
| Cursor | 自定义 API Key、Base URL 与 Agent 排错 |
| Claude Code | Claude Code 接口配置 |
| Codex | Codex Responses API 配置 |
| Dify | Dify 模型提供商配置 |
Chat Completions 成功不代表 Responses API、Anthropic Messages 或所有工具功能均已通过;按对应教程继续验证实际需要的协议。