# FunCaptcha

> 用 YesCaptcha 获取 FunCaptcha（Arkose Labs）的 token：FunCaptchaTaskProxylessM1、自带代理的 FunCaptchaTask 和 FunCaptchaTaskProxyless，websitePublicKey、子域名和 blob 数据怎么填。

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

FunCaptcha（Arkose Labs）任务返回一个 token（`token`），提交给目标网站即可通过验证，不需要做图片题。`FunCaptchaTaskProxylessM1` 每个任务 110 点（0.11 元），自带代理的 `FunCaptchaTask` 每个任务 15 点（0.015 元），都是异步：先 `createTask`，再每 5 秒 `getTaskResult`。识别失败、超时自动退点。

> **FunCaptchaTaskProxyless 线路待修:** `FunCaptchaTaskProxyless` 的线路从 2026-09-10 前后起无法识别成功，正在修复；任务会返回识别失败并自动退点。修好之前请用 `FunCaptchaTaskProxylessM1` 或 `FunCaptchaTask`。修复后会写进 [服务更新记录](https://docs.yescaptcha.com/zh/changelog/)。

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

请求体是 JSON，用 `clientKey` 鉴权。在哪个节点创建的任务，就到哪个节点查询结果。

## 适用场景

网页加载了 Arkose Labs（`arkoselabs.com`、`funcaptcha.com`）的验证，常见于注册、登录页面。想拿 token 直接提交，用这一页；想自己在浏览器里做图片题，用 [FunCaptcha 图像识别](https://docs.yescaptcha.com/zh/tasks/funcaptcha-classification/)。

## 类型与价格

| 任务类型 | 价格 | 返回方式 | 说明 |
| --- | --- | --- | --- |
| `FunCaptchaTaskProxyless` | 30 点（0.03 元） | 异步 |  |
| `FunCaptchaTaskProxylessM1` | 110 点（0.11 元） | 异步 |  |
| `FunCaptchaTask` | 15 点（0.015 元） | 异步 | 自带代理 |

-   `FunCaptchaTask` 用你自己的代理加载验证码，必须传代理字段和 `userAgent`。
-   三个类型参数基本相同，可以对比通过率选用。

## 请求参数

| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `type` | string | 是 | 任务类型，取值见本页"类型与价格" |
| `websiteURL` | string | 是 | 出现验证码的网页地址（完整 URL）。填你看到验证码的网站，不要填验证码厂商的域名 |
| `websitePublicKey` | string | 是 | FunCaptcha 的公钥（public key），网页里 `data-pkey` 的值，或者请求地址里 `pkey=` 后面的部分，形如 `B7D8911C-5CC8-A9A3-35B0-554ACEE604DA` |
| `funcaptchaApiJSSubdomain` | string | 否 | 加载 FunCaptcha 的子域名，部分网站是定制的，按网页里 iframe 的地址填，例如 `client-api.arkoselabs.com` |
| `data` | string | 否 | 附加的 blob 数据，JSON 字符串，形如 `{"blob":"..."}`。原样传入，不要做 URL 编码；网页没有用到时不传 |
| `userAgent` | string | FunCaptchaTask 必填 | 浏览器 User-Agent，要和你访问目标网站时用的一致 |
| `proxyType` | string | FunCaptchaTask 必填 | 代理协议：`http`、`https`、`socks4`、`socks5` |
| `proxyAddress` | string | FunCaptchaTask 必填 | 代理的 IP 地址或域名。不能填 127.0.0.1、192.168.x.x 这类本机或内网地址，我们的服务器访问不到 |
| `proxyPort` | integer | FunCaptchaTask 必填 | 代理端口 |
| `proxyLogin` | string | 否 | 代理用户名（代理需要认证时）（仅 FunCaptchaTask） |
| `proxyPassword` | string | 否 | 代理密码（代理需要认证时）（仅 FunCaptchaTask） |

-   `websiteURL`：填你看到验证码的网站，不要填 `funcaptcha.com`、`arkoselabs.com`。
-   `websitePublicKey`：网页里 `data-pkey` 的值，或者请求地址 `…/fc/api/nojs/?pkey=…` 里 `pkey` 的值。
-   `funcaptchaApiJSSubdomain`：部分网站用定制的子域名加载验证码，按网页里 iframe 的地址填，例如 `client-api.arkoselabs.com`。
-   `data`：网站传给验证码的 blob 数据，形如 `{"blob":"..."}` 的 JSON 字符串，**原样**传入，不要把 `%3D`、`%2B` 这类字符转义或反转义。找不到就不传。

## 请求示例

POST https://api.yescaptcha.com/createTask

```json
{
  "clientKey": "YOUR_CLIENT_KEY",
  "task": {
    "type": "FunCaptchaTaskProxylessM1",
    "websiteURL": "https://example.com/signup",
    "websitePublicKey": "B7D8911C-5CC8-A9A3-35B0-554ACEE604DA",
    "funcaptchaApiJSSubdomain": "client-api.arkoselabs.com"
  }
}
```

**curl**

```bash
curl -s https://api.yescaptcha.com/createTask \
  -H 'Content-Type: application/json' \
  -d '{
  "clientKey": "YOUR_CLIENT_KEY",
  "task": {
    "type": "FunCaptchaTaskProxylessM1",
    "websiteURL": "https://example.com/signup",
    "websitePublicKey": "B7D8911C-5CC8-A9A3-35B0-554ACEE604DA",
    "funcaptchaApiJSSubdomain": "client-api.arkoselabs.com"
  }
}'
curl -s https://api.yescaptcha.com/getTaskResult \
  -H 'Content-Type: application/json' \
  -d '{"clientKey": "YOUR_CLIENT_KEY", "taskId": "TASK_ID"}'
```

**Python**

solve.py

```python
import os
import time

import requests

API = "https://api.yescaptcha.com"
CLIENT_KEY = os.environ["YESCAPTCHA_CLIENT_KEY"]  # 从环境变量读取 clientKey

def call(method, payload):
    r = requests.post(f"{API}/{method}", json={"clientKey": CLIENT_KEY, **payload}, timeout=30)
    data = r.json()
    if data.get("errorId"):
        raise RuntimeError(f"{data.get('errorCode')}: {data.get('errorDescription')}")
    return data

def solve(task):
    task_id = call("createTask", {"task": task})["taskId"]
    for _ in range(36):  # 每 5 秒查询一次，最多等约 3 分钟
        time.sleep(5)
        result = call("getTaskResult", {"taskId": task_id})
        if result.get("status") == "ready":
            return result["solution"]
    raise TimeoutError(task_id)

solution = solve({
    "type": "FunCaptchaTaskProxylessM1",
    "websiteURL": "https://example.com/signup",
    "websitePublicKey": "B7D8911C-5CC8-A9A3-35B0-554ACEE604DA",
    "funcaptchaApiJSSubdomain": "client-api.arkoselabs.com",
})
print(solution["token"])
```

**Node.js**

solve.mjs

```js
const API = 'https://api.yescaptcha.com';
const CLIENT_KEY = process.env.YESCAPTCHA_CLIENT_KEY; // 从环境变量读取 clientKey

async function call(method, payload) {
  const res = await fetch(`${API}/${method}`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ clientKey: CLIENT_KEY, ...payload }),
  });
  const data = await res.json();
  if (data.errorId) throw new Error(`${data.errorCode}: ${data.errorDescription}`);
  return data;
}

async function solve(task) {
  const { taskId } = await call('createTask', { task });
  for (let i = 0; i < 36; i++) { // 每 5 秒查询一次，最多等约 3 分钟
    await new Promise((r) => setTimeout(r, 5000));
    const result = await call('getTaskResult', { taskId });
    if (result.status === 'ready') return result.solution;
  }
  throw new Error(`timeout: ${taskId}`);
}

const solution = await solve({
  type: "FunCaptchaTaskProxylessM1",
  websiteURL: "https://example.com/signup",
  websitePublicKey: "B7D8911C-5CC8-A9A3-35B0-554ACEE604DA",
  funcaptchaApiJSSubdomain: "client-api.arkoselabs.com",
});
console.log(solution.token);
```

用自己的代理，并带上 blob 数据：

POST https://api.yescaptcha.com/createTask

```json
{
  "clientKey": "YOUR_CLIENT_KEY",
  "task": {
    "type": "FunCaptchaTask",
    "websiteURL": "https://example.com/signup",
    "websitePublicKey": "B7D8911C-5CC8-A9A3-35B0-554ACEE604DA",
    "data": "{\"blob\":\"BLOB_VALUE_FROM_THE_PAGE\"}",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36",
    "proxyType": "http",
    "proxyAddress": "proxy.example.com",
    "proxyPort": 8080,
    "proxyLogin": "user",
    "proxyPassword": "pass"
  }
}
```

## 返回结果

```json
{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "token": "36859d1086acb06e7.08293101|r=ap-southeast-1|metabgclr=%23ffffff|..."
  }
}
```

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `token` | string | 得到的 token，提交给目标网站。一次性使用，建议尽快用掉 |

处理中时返回 `{"errorId": 0, "status": "processing"}`，5 秒后再查。出错时按 `errorCode` 处理，见 [错误码](https://docs.yescaptcha.com/zh/api/errors/)。

## 常见问题

### token 多久内有效？

一次性使用，建议拿到后尽快提交。

### 一直识别失败？

先检查 `websitePublicKey` 和 `funcaptchaApiJSSubdomain`；网站要求 blob 数据的，`data` 必须带上而且不能被转义。`FunCaptchaTaskProxyless` 在修复期间会一直失败（自动退点），请换用另外两个类型。