跳到主要内容

配额与用量

GVR 通过用户账户的 remainingRequests 值，按 API 密钥跟踪请求用量。

单次请求 API​

大多数 API 调用在成功处理后消耗一个请求。

示例：

  • 语音性别文件请求
  • 语音年龄请求
  • 深度伪造语音请求
  • 图像性别请求
  • 图像年龄请求
  • 单次姓名智能请求

CSV API​

CSV 处理有所不同，因为一个文件可以包含多行。CSV 处理会检查行数，并可能为每个已处理的行消耗一个请求。

如果文件的行数超过该密钥的剩余请求数，API 会在处理 CSV 之前拒绝该请求。

响应元数据​

许多成功的 API 响应都包含更新后的配额信息：

{
  "remainingRequests": 2999
}

您可以使用此值在应用中显示用量，或在用户配额用尽之前触发升级提示。

配额错误​

文件和 CSV 端点可能返回结构化的速率限制响应：

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "You have exceeded your free tier limit of 50 requests.",
    "detailedMessage": "Insufficient remaining requests. Required: 1, Available: 0",
    "details": {
      "limit": 50,
      "used": 50,
      "reset_date": "2026-07-01T00:00:00.000Z"
    },
    "suggested_action": "Please upgrade to a premium plan to continue using the API."
  }
}

单次姓名端点可能返回：

{
  "error": "Insufficient remaining requests"
}

实用建议​

  • 调用 API 前先验证必填字段。
  • 遇到验证错误时避免循环重试。
  • 每次 API 响应后，以 remainingRequests 作为配额的权威依据。
  • 对于 CSV 流程，请在开始大型处理任务前先验证 CSV。