使用指南

创建 Key → 选择分组 → 获取模型 → 开始调用

更新：2026-09-09 · 示例使用 Windows PowerShell

1. 开始使用

登录 FrostAPI，确认账户余额或有效套餐。
打开左侧“API Key / API 密钥”，点击“创建”。
填写便于识别的名称，例如“Lyra 生图”，选择对应分组；按需设置额度和有效期。
创建后复制 Key。

不同分组对应不同模型和价格，请使用对应分组的 Key。

2. 在应用中填写

配置项	填写内容
Base URL	`https://api.linfrsot.cloud/v1`
API Key	你在本站创建的 Key

如果应用要求“服务器地址”而不是 Base URL，填写 https://api.linfrsot.cloud。不要重复拼接 /v1/v1。AI3D 使用本站专用接口，见下方示例。不要填写供应商的原始 Key 或插件内部模型别名。

3. 查询可用模型

以下示例在 Windows PowerShell 中执行。先替换 Key；后续示例沿用这些变量。

$base = "https://api.linfrsot.cloud"
$key = "替换为本站创建的APIKey"
$headers = @{ Authorization = "Bearer $key" }
$models = Invoke-RestMethod "$base/v1/models" -Headers $headers
$models.data | Select-Object id

4. 调用对话

使用对话分组的 Key，将 model 替换为上一步返回的对话模型。示例为非流式请求。

$body = @{
  model = "替换为可用对话模型"
  messages = @(@{ role = "user"; content = "你好，请简单介绍你自己" })
  stream = $false
} | ConvertTo-Json -Depth 8
$result = Invoke-RestMethod "$base/v1/chat/completions" -Method Post -Headers $headers -ContentType "application/json; charset=utf-8" -Body ([Text.Encoding]::UTF8.GetBytes($body))
$result.choices[0].message.content

5. 调用生图

使用生图分组的 Key。此示例适用于支持 Images 接口的账号；不同供应商支持的接口与参数可能不同。生成图片会消耗余额，不要连续重复提交同一请求。

$body = @{
  model = "替换为可用生图模型"
  prompt = "白色背景上的蓝色陶瓷杯，柔和自然光"
  n = 1
} | ConvertTo-Json
$result = Invoke-RestMethod "$base/v1/images/generations" -Method Post -Headers $headers -ContentType "application/json; charset=utf-8" -Body ([Text.Encoding]::UTF8.GetBytes($body)) -TimeoutSec 3600
$result.data | Format-List

6. 保存生成图片

返回结果可能是下载链接 url，也可能是图片内容 b64_json。任选对应方式保存。临时链接请及时下载。

# 返回 url 时：
Invoke-WebRequest $result.data[0].url -OutFile "output.png"

# 返回 b64_json 时：
[IO.File]::WriteAllBytes((Join-Path $PWD "output.png"), [Convert]::FromBase64String($result.data[0].b64_json))

7. AI3D 模型生成

使用 AI3D 分组 Key。先查模型，再提交任务。图生 3D 使用 image_url；多视图使用 image_urls；纹理参考图单独填写 texture_image_url，不能混入多视图。具体能力以模型支持范围为准。

# 查询 AI3D 模型
(Invoke-RestMethod "$base/v1/3d/models" -Headers $headers).data | Select-Object id

# 单图生成；替换模型和公开可访问的图片链接
$body = @{
  model = "meshy-7"
  image_url = "https://你的域名/input.png"
  should_texture = $true
  target_formats = @("glb", "obj")
} | ConvertTo-Json -Depth 8
$task = Invoke-RestMethod "$base/v1/3d/generations" -Method Post -Headers $headers -ContentType "application/json; charset=utf-8" -Body ([Text.Encoding]::UTF8.GetBytes($body))
$task | Format-List

# 保存任务 id；每隔几秒查询一次，不要重新提交生成
Start-Sleep -Seconds 3
Invoke-RestMethod "$base/v1/3d/tasks/$($task.id)" -Headers $headers | ConvertTo-Json -Depth 12

8. 计费与常见问题

价格：以所选分组的价格、倍率和用量记录为准。不要用其他分组的价格估算费用。
401：检查 Key 是否完整、有效，是否包含多余空格。
403：检查分组权限、账户状态；不能仅凭状态码断定是网络问题。
400 / 模型不可用：重新获取当前 Key 的模型列表，检查接口和参数。
429：检查余额、Key 额度、并发和上游限额，以返回的错误信息为准。
502 / 连接中断：保留错误、时间、模型和请求 ID。AI3D 优先查询原任务，避免重复扣费。
模型列表为空：确认 Key 绑定了正确分组，并联系管理员检查该分组是否有可用账号。

请求协助时提供：调用时间、分组、模型、接口、错误信息和请求/任务 ID。