What is Capy Puzzle?

Capy (capy.me) is a Japanese captcha service that presents a jigsaw puzzle — the user drags a puzzle piece to complete an image. It's used primarily on Japanese websites and some international sites.

How it works

Send Task

POST your CapyTaskProxyLess with the target URL and sitekey to our API. We'll queue it instantly.

We Solve

Capzy's proprietary solver returns the Capy Puzzle solution payload ready for direct submission. Designed for authorized testing and automation.

Get Token

Poll getTaskResult — when status is 'ready', the solution contains the token to inject into the target page.

Quick integration

solve.py

import requests, time

API = "https://api.capzy.ai"
KEY = "capzy_your_key_here"

# Step 1: Create task
task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
        "type": "CapyTaskProxyLess",
        "websiteKey": "PUZZLE_abc123def456",
        "websiteURL": "https://example.jp/form"
    }
}).json()

task_id = task["taskId"]
print(f"Task created: {task_id}")

# Step 2: Poll for result
while True:
    result = requests.post(f"{API}/getTaskResult", json={
        "clientKey": KEY,
        "taskId": task_id
    }).json()

    if result["status"] == "ready":
        print("Solved!", result["solution"])
        break
    elif result["status"] == "failed":
        print("Failed:", result.get("errorDescription"))
        break

    time.sleep(1)

# Step 3: Capy — submit all three values to the form
sol = result["solution"]
requests.post("https://target.example.com/submit", data={
    "capy_captchakey":  sol["captchakey"],
    "capy_challengekey": sol["challengekey"],
    "capy_answer":      sol["answer"],
})

Using your own proxy

Use CapyTask instead of CapyTaskProxyLess to route the solve through your own proxy. This is useful when the target site checks the IP that solved the captcha matches the IP submitting the form.

solve_proxy.py

import requests, time

API = "https://api.capzy.ai"
KEY = "capzy_your_key_here"

# Step 1: Create task
task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
        "type": "CapyTask",
        "proxyPort": "8080",
        "proxyType": "http",
        "proxyLogin": "user",
        "websiteKey": "PUZZLE_abc123def456",
        "websiteURL": "https://example.jp/form",
        "proxyAddress": "123.45.67.89",
        "proxyPassword": "pass"
    }
}).json()

task_id = task["taskId"]
print(f"Task created: {task_id}")

# Step 2: Poll for result
while True:
    result = requests.post(f"{API}/getTaskResult", json={
        "clientKey": KEY,
        "taskId": task_id
    }).json()

    if result["status"] == "ready":
        print("Solved!", result["solution"])
        break
    elif result["status"] == "failed":
        print("Failed:", result.get("errorDescription"))
        break

    time.sleep(1)

# Step 3: Capy — submit all three values to the form
sol = result["solution"]
requests.post("https://target.example.com/submit", data={
    "capy_captchakey":  sol["captchakey"],
    "capy_challengekey": sol["challengekey"],
    "capy_answer":      sol["answer"],
})

additional proxy parameters

fieldtyperequireddescription

proxyTypetypestringreqyesProxy protocol: http or https

proxyAddresstypestringreqyesProxy IP address or hostname

proxyPorttypenumberreqyesProxy port number

proxyLogintypestringreqnoProxy username (if auth required)

proxyPasswordtypestringreqnoProxy password (if auth required)

userAgenttypestringreqnoUser-Agent string to use. Must match the UA you use when submitting the token

Task parameters

fieldtyperequireddescription

typetypestringreqyesCapyTaskProxyLess or CapyTask

websiteURLtypestringreqyesThe page URL

websiteKeytypestringreqyesThe sitekey (starts with PUZZLE_)

apiServertypestringreqnoCustom Capy widget host. Defaults to https://jp.api.capy.me. Pass this when the target site serves the widget from its own CDN (white-label deployment) — find the value in the page's <script src='…/puzzle/get_js/?k=…'> tag. Aliases: api_server, capyApiServerSubdomain.

Solution response

fieldtypedescription

captchakeytypestringThe Capy captcha public key — echo back to the form.

challengekeytypestringServer-issued challenge identifier for this session.

answertypestringThe solved puzzle answer (drag distance, click coordinate, or text).

respKeytypestringServer-issued response key, returned after the answer is accepted. Submit alongside `answer` to the Capy verify endpoint.

Example response

Full getTaskResult response shape. The fields in the table above describe what's inside solution — the outer envelope (errorId, status) is identical for every captcha type.

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "answer": "187",
    "respKey": "response_key_after_solve",
    "captchakey": "PUZZLE_Abc1234567890DefGhi",
    "challengekey": "challenge_id_token_string"
  }
}

Error response

Failures use the same envelope with errorId: 1 plus errorCode + errorDescription. See the error-code reference for the full list.

{
  "errorId": 1,
  "errorCode": "ERROR_CAPTCHA_UNSOLVABLE",
  "errorDescription": "Solver gave up — automatically refunded."
}

Pending response

While the solver is still working, getTaskResult returns status: "processing". Poll every 1–2 seconds until ready or failed.

{
  "errorId": 0,
  "status": "processing"
}

Features

Solves the Capy jigsaw puzzle

Rare-coverage captcha — most solvers don't support it

Japanese site compatibility

Returns captchakey + challengekey + answer ready to submit

task types

proxyless: CapyTaskProxyLess

with proxy: CapyTask

Capy Puzzle Solver, solved in 5.0s.