API Key Gateway

在线

服务商统计

fal.ai

总数
可用
使用次数

wavespeed

总数
可用
总余额
使用次数

系统状态

健康检查状态

状态
检查间隔
上次检查
下次检查

API Key 管理

API Key Provider 状态 使用次数 余额 上次检查 描述 操作

健康检查配置

配置全局健康检查设置，系统会根据不同服务商自动选择合适的检查方式

不同服务商的健康检查方式

fal.ai: 使用下方配置的端点进行任务创建或状态查询检查
• 推荐使用状态查询模式，不消耗credits
wavespeed: 自动使用余额接口检查（https://api.wavespeed.ai/api/v3/balance）
• 余额低于 0.5 时自动标记为不可用

用于 fal.ai API keys 的健康检查端点，wavespeed keys 使用固定的余额接口

托底方案管理

为不同服务商分别配置托底方案，当对应的普通 key 不可用时自动启用

fal.ai 托底方案

当所有 fal.ai keys 不可用时启用

wavespeed 托底方案

当所有 wavespeed keys 不可用时启用

API 使用文档

多服务商 AI API Key Gateway 的接口使用指南（支持 fal.ai 和 wavespeed）

1. 获取可用的 API Key

接口信息

URL: GET /api/key[?provider=fal|wavespeed]
描述: 获取一个可用的 API Key，系统会根据负载均衡算法返回使用次数最多的可用 Key（尽快用完策略）
参数: provider (可选) - 指定服务商：fal(默认) 或 wavespeed

cURL 示例

获取默认 provider (fal.ai) 的 API Key：

curl -X GET {{BASE_URL}}/api/key -H "Authorization: Bearer {{API_TOKEN}}"

获取 wavespeed 的 API Key：

curl -X GET "{{BASE_URL}}/api/key?provider=wavespeed" -H "Authorization: Bearer {{API_TOKEN}}"

响应示例

fal.ai API Key 响应示例： 

{
  "success": true,
  "data": {
    "id": 1,
    "apikey": "fal-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "account": "main_account",
    "description": "主账户",
    "provider": "fal",
    "usage_count": 42
  }
}

wavespeed API Key 响应示例： 

{
  "success": true,
  "data": {
    "id": 33,
    "apikey": "8d87138c332f0551bd54179fb37884fc64e00d12d432d70a3a22300beeb1dc35",
    "description": "wavespeed 测试账户",
    "provider": "wavespeed",
    "usage_count": 5
  }
}

2. 报告 API Key 失效

接口信息

URL: PUT /api/key/report-invalid
描述: 当使用 API Key 时遇到错误，可以通过此接口报告 Key 失效
Content-Type: application/json

请求参数

apikey (string, 必需): 需要报告的 API Key
reason (string, 可选): 失效原因描述

cURL 示例

curl -X PUT {{BASE_URL}}/api/key/report-invalid \
-H "Authorization: Bearer {{API_TOKEN}}" \
-H "Content-Type: application/json" \
-d '{"apikey":"fal-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx","reason":"401 Unauthorized"}'

响应示例 

{
  "success": true,
  "message": "API key reported as invalid and marked inactive"
}

3. 获取多个可用 API Key

接口信息

URL: GET /api/keys/available?limit=N&provider=fal|wavespeed
描述: 获取多个可用的 API Key，最多返回 10 个
参数:
• limit (可选, 默认 1, 最大 10) - 返回数量
• provider (可选, 默认全部) - 指定服务商：fal 或 wavespeed

cURL 示例

获取 3 个可用的 API Key（所有 provider）：

curl -X GET "{{BASE_URL}}/api/keys/available?limit=3" -H "Authorization: Bearer {{API_TOKEN}}"

只获取 wavespeed 的 API Keys：

curl -X GET "{{BASE_URL}}/api/keys/available?limit=2&provider=wavespeed" -H "Authorization: Bearer {{API_TOKEN}}"

响应示例 

{
  "success": true,
  "data": [
    {
      "id": 1,
      "apikey": "fal-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "account": "main_account",
      "description": "主账户",
      "provider": "fal",
      "usage_count": 42
    },
    {
      "id": 33,
      "apikey": "8d87138c332f0551bd54179fb37884fc64e00d12d432d70a3a22300beeb1dc35",
      "description": "wavespeed 测试账户",
      "provider": "wavespeed",
      "usage_count": 15
    }
  ],
  "count": 2
}

错误处理

常见错误状态码

  • 404: 没有可用的 API Key（可能指定的 provider 没有可用 key）
  • 400: 请求参数错误（如 provider 参数值无效）
  • 401: 认证失败，检查 Authorization header
  • 500: 服务器内部错误

404 错误示例 

{
  "success": false,
  "error": "No available API keys found"
}

使用建议

  • 使用 /api/key 获取单个 Key 已满足大部分场景
  • 多服务商支持：通过 provider 参数指定 fal.ai 或 wavespeed
  • 智能余额检查：wavespeed keys 会自动检查余额，低于 0.5 时自动停用
  • 建议在 API 调用失败时主动报告 Key 失效
  • 系统会自动进行健康检查，无需额外处理
  • 所有接口支持 CORS，可以从浏览器直接调用