# 计费与退点

> YesCaptcha 怎么扣点：1 元 = 1000 点，按任务类型扣点；识别失败和超时自动退点，返回错误的请求不扣点；余额须大于 10 点；图像识别上报失败约 24 小时后返点。

Source: https://docs.yescaptcha.com/zh/getting-started/billing/ · Last verified: 2026-10-15

YesCaptcha 按任务扣点：每个任务类型有固定价格，1 元 = 1000 点，例如 `NoCaptchaTaskProxyless` 每个任务 15 点（0.015 元）。只为成功的任务付费：识别失败、超时的任务自动退点，返回错误的请求不扣点。各类型的价格见 [任务类型与价格](https://docs.yescaptcha.com/zh/tasks/)。

## 什么时候扣点

-   **异步类型**（返回 token 的大多数类型）：任务创建成功时扣点。之后如果识别失败（`ERROR_CAPTCHA_UNSOLVABLE` 等）或超时（`ERROR_TASK_TIMEOUT`，一般 110 秒），点数自动退回。
-   **同步类型**（图像识别、`ImageToTextTaskOcrBase`、`ImageToTextTaskMuggle`）：识别成功返回结果时扣点。
-   创建任务时就返回错误的（参数不对、余额不足、超过并发上限等），不扣点。

## 余额

-   余额必须**大于 10 点**才能创建任务，否则返回 `ERROR_ZERO_BALANCE`。
-   用 [`getBalance`](https://docs.yescaptcha.com/zh/api/get-balance/) 查询余额，不扣点。
-   充值和 VIP 赠送见 [充值与 VIP](https://docs.yescaptcha.com/zh/account/recharge/)：累计充值达到 VIP 等级后，之后每次充值按比例赠送点数。

## 几种按情况计价的类型

-   **reCAPTCHA v2 图像识别**（`ReCaptchaV2Classification`）：1x1 小图和 3x3、4x4 大图价格不同，见 [reCAPTCHA v2 图像识别](https://docs.yescaptcha.com/zh/tasks/recaptcha-classification/)。
-   **hCaptcha 图像识别**（`HCaptchaClassification`）：没有识别出目标（结果为空）时不扣点。

## 上报识别错误后返点

图像识别的结果点错了，可以用 [`report`](https://docs.yescaptcha.com/zh/api/report/) 上报，符合条件的会返还点数：

-   只限 5 种图像识别类型：`FunCaptchaClassification`、`HCaptchaClassification`、`ReCaptchaV2Classification`、`AwsClassification`、`bCaptchaClassification`。
-   要在任务创建后 **1 小时内**上报，同一个任务只算一次。
-   不是立即返还，**约 24 小时后**统一结算。
-   结算时会和同一时期、同一题目的其他用户比较：上报的失败率明显高于同期水平的，按同期的失败率返还。
-   对结算结果有疑问，可以 [联系客服](https://docs.yescaptcha.com/zh/help/contact/) 申诉。

返回 token 的类型（reCAPTCHA、hCaptcha、Turnstile 等）是否通过由目标网站判定，上报不返点。

## 不扣点的情况

| 情况 | 返回 |
| --- | --- |
| 参数错误、类型不存在、`clientKey` 错误 | 对应的错误码 |
| 余额不大于 10 点 | `ERROR_ZERO_BALANCE` |
| 超过并发上限 | `ERROR_THREADS_MAXIMUM`，见 [并发限制与自动暂停](https://docs.yescaptcha.com/zh/api/rate-limits/) |
| 被自动暂停期间 | `ERROR_IP_BLOCKED_5MIN` |
| 已判定无效的 sitekey 或域名（缓存期内） | 原错误码，带 `cached: true` |
| 识别失败、超时 | 已扣的点自动退回 |

## 分成和奖励

-   用别人的软件或插件时，任务可能带有开发者 ID，开发者会得到分成，不影响你的扣点。自己开发软件的，见 [开发者分成](https://docs.yescaptcha.com/zh/account/developer/)。
-   邀请别人注册，见 [邀请奖励](https://docs.yescaptcha.com/zh/account/referral/)。