五分钟快速接入

本页用一条最小的 OpenAI 兼容请求验证 FlashCoding.AI。先让 curl 调用成功，再配置 SDK 或桌面客户端，排障会更直接。

适用场景

• 第一次使用 FlashCoding.AI，想确认账户、密钥和模型能否正常调用。
• 客户端请求失败，需要用最小请求判断问题是否来自客户端。
• 准备接入 SDK，希望先确认 Base URL 和请求格式。

前置条件

你需要从控制台取得两项内容：

• API Key，例如 sk-your-key。
• 一个当前可用的完整模型 ID，例如本文中的占位符 your-model-id。

本机还需要 curl。macOS、常见 Linux 发行版以及较新的 Windows 通常已包含它；Windows PowerShell 中建议明确运行 curl.exe。

操作步骤

1. 设置临时环境变量

把真实密钥放入当前终端会话，关闭终端后变量即失效。

macOS / Linux：

export FLASHCODING_API_KEY="sk-your-key"
export FLASHCODING_MODEL="your-model-id"

Windows PowerShell：

$env:FLASHCODING_API_KEY = "sk-your-key"
$env:FLASHCODING_MODEL = "your-model-id"

为什么使用环境变量

这样可以避免在后续命令、脚本或截图中反复出现真实密钥。不要把包含真实值的终端历史或日志发到公开位置。

2. 发送聊天请求

macOS / Linux：

curl https://flashcoding.ai/v1/chat/completions \
  -H "Authorization: Bearer $FLASHCODING_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"$FLASHCODING_MODEL\",
    \"messages\": [
      {\"role\": \"user\", \"content\": \"请只回复：连接成功\"}
    ]
  }"

Windows PowerShell：

$body = @{
  model = $env:FLASHCODING_MODEL
  messages = @(
    @{ role = "user"; content = "请只回复：连接成功" }
  )
} | ConvertTo-Json -Depth 4

$headers = @{
  Authorization = "Bearer $env:FLASHCODING_API_KEY"
}

Invoke-RestMethod `
  -Uri "https://flashcoding.ai/v1/chat/completions" `
  -Method Post `
  -Headers $headers `
  -ContentType "application/json; charset=utf-8" `
  -Body $body

不要把 https://flashcoding.ai/v1 再与 /v1/chat/completions 拼接，否则会得到重复的 /v1/v1/。

3. 查看用量记录

请求返回后，打开控制台的使用记录或用量页面，按刚才的请求时间查找记录。记录出现说明请求已经到达平台；用量与账户显示规则见用量与账单。

成功验证

成功响应通常具备以下特征：

• HTTP 状态码为 200。
• 响应的 Content-Type 是 JSON。
• JSON 中包含回复内容，没有顶层 error。
• 控制台中出现对应请求记录。

如果要同时查看状态码和响应头，可添加 -i：

curl -i https://flashcoding.ai/v1/models \
  -H "Authorization: Bearer $FLASHCODING_API_KEY"

/v1/models 可用于确认鉴权和查看接口返回的模型标识；最终可调用范围仍以你的密钥、分组和控制台配置为准。

常见错误

401 Unauthorized

检查 API Key 是否完整、是否已停用，以及请求头是否为 Authorization: Bearer <密钥>。Bearer 与密钥之间必须有一个空格。

404 Not Found

检查 URL 是否误写成 /v1/v1/...，或客户端是否自动追加了路径。不同客户端应填写的 Base URL 见 Base URL 与协议。

模型不存在或不可用

不要沿用教程、群聊或旧配置中的模型名。回到控制台复制当前分组显示的完整模型 ID，再重新请求。

429 或额度相关提示

查看控制台的用量、余额、分组限制和请求频率。不要通过高频自动重试掩盖问题；先确认错误正文给出的原因。

返回 5xx 或连接超时

保留状态码、响应正文、请求时间和请求 ID，稍后重试一次。持续失败时按故障排查收集信息。

PowerShell 报参数解析错误

确认使用的是 curl.exe，不是旧版 PowerShell 中名为 curl 的命令别名；也可以改用 Invoke-RestMethod。

下一步

• 在代码中调用：阅读 OpenAI 兼容接口。
• 配置开发工具：选择 Claude Code、Codex 或 Gemini CLI。
• 长期保存密钥前：先阅读获取与保护 API Key。