# report 上报结果

> POST /report 上报任务的识别结果是否正确。图像识别类型在任务创建后 1 小时内上报失败，约 24 小时后结算返点；正确的结果也请上报，帮助改进识别。

Source: https://docs.yescaptcha.com/zh/api/report/ · Last verified: 2026-10-15

`report` 用来告诉我们一组任务的识别结果对不对。图像识别类型上报“错误”后，符合条件的会在约 24 小时后返还点数；上报的样本也用来改进识别。识别正确的任务同样请上报。

- POST `https://api.yescaptcha.com/report` (国际节点)
- POST `https://cn.yescaptcha.com/report` (国内节点)

## 请求参数

| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `id` | array of string | 是 | 任务 ID 列表，可以一次报多个 |
| `isSuccess` | boolean | 是 | `true` 识别正确，`false` 识别错误 |

不需要 `clientKey`，任务 ID 本身就能对应到任务。

```json
{
  "id": ["610ff5e0-68eb-11ef-95a6-22e70a0b794d", "65b88c06-68eb-11ef-8e9a-52540023ccb3"],
  "isSuccess": false
}
```

一道题要识别多张图时（例如 FunCaptcha 一次要选 5 轮），最后提交失败但不知道是哪一张错了，可以把这一组任务 ID 一起上报。

## 返回结果

```json
{ "errorId": 0, "status": "success" }
```

## 上报失败后的返点

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

返回 token 的类型（reCAPTCHA、hCaptcha、Turnstile、FunCaptcha 等）能否通过由目标网站判定，上报不返点。计费规则汇总见 [计费与退点](https://docs.yescaptcha.com/zh/getting-started/billing/)。