Shopee Slider

Capture the puzzle and piece images.

Save the gapped background and transparent puzzle piece from one challenge. Preserve the original geometry for its returned slider proportion or offset.

import base64
from pathlib import Path

def image_bytes(filename):
    return base64.b64encode(Path(filename).read_bytes()).decode("ascii")

task_inputs = {
    "image": image_bytes("background.png"),
    "pieceImage": image_bytes("piece.png")
}

Know what goes in.

Choose a field to see its purpose, where to get it, and its place in the request. Optional values omitted from the example can be added when your flow uses them.

The request below follows your selected task configuration.

{
  "clientKey": "capzy_YOUR_API_KEY",
  "task": {
    "type": "ShopeeSliderTaskProxyLess",
    "image": "<base64 puzzle background>",
    "pieceImage": "<base64 piece>"
  }
}

1. Create the task

   Send clientKey and the selected task to /createTask from your server. Keep the returned taskId.

2. Wait for the solution

   Send that same key and ID to /getTaskResult. While processing, wait two seconds before checking again. Stop on Ready or an error.

3. Apply the result

   Use solution.slideXProportion or solution.slideOffset with the actual track dimensions, checking puzzleWidth and origin metadata. Continue the original puzzle session rather than treating the answer as a token.

import json, os, time
import requests

API = "https://api.capzy.ai"
KEY = os.environ["CAPZY_API_KEY"]
task = json.loads("{\"type\":\"ShopeeSliderTaskProxyLess\",\"image\":\"<base64 puzzle background>\",\"pieceImage\":\"<base64 piece>\"}")

def call(path, payload):
    response = requests.post(f"{API}/{path}", json={"clientKey": KEY, **payload}, timeout=30)
    response.raise_for_status()
    data = response.json()
    if data.get("errorId", 0) or data.get("status") == "failed":
        raise RuntimeError(data.get("errorDescription") or data.get("errorCode") or "Task failed")
    return data

created = call("createTask", {"task": task})
for attempt in range(60):
    result = call("getTaskResult", {"taskId": created["taskId"]})
    if result.get("status") == "ready":
        solution = result["solution"]
        print(solution)
        break
    time.sleep(2)
else:
    raise TimeoutError("Task is still processing; keep the taskId to check it later.")

Understand what comes back.

Follow this task from creation to completion. Response fields and usage follow your selected request variant.

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "slideXProportion": 0.4523,
    "slideOffset": 180,
    "puzzleWidth": 400,
    "engine": "cvx-2"
  }
}

# Step 3 — drag the piece by slideOffset pixels (or use the 0-1 proportion)
sol = result["solution"]
offset_px = sol["slideOffset"]              # absolute px, e.g. 186
proportion = sol["slideXProportion"]        # same as a 0-1 fraction of the track
# e.g. Playwright: mouse.down(); mouse.move(start_x + offset_px, y); mouse.up()

When something doesn't work.

Check your captured values, the selected variant, and the response before starting another task.