ByteDance has its own image-puzzle CAPTCHA, shared by TikTok, CapCut, Lark and Douyin. It comes in four looks: slide, rotate ("whirl"), 3D object matching and icon selection. Each challenge is tied to the device ID, the cookies and the session IP, so an answer produced somewhere else is worthless. It has to be applied inside the same session.
- A wide background with a cut-out and a separate piece (slide)
- Two concentric round images (whirl / rotate)
- Several 3D-rendered objects and a "find the matching pair" prompt
- A picture plus a text instruction to click the matching icons
- Requests carrying
device_id and iid to TikTok/ByteDance anti-bot endpoints
- A drag or click task that comes back after a failure
| Variant |
Task |
Answer format |
| Slide |
Move the piece into the gap |
X distance or ratio |
| Whirl |
Turn the inner disc until it lines up with the ring |
Angle or drag distance |
| 3D |
Click the two identical 3D objects |
Two points |
| Icon |
Click the icons named in the prompt, in order |
A list of points |
- A challenge is requested during login, sign-up or any action the risk engine flags.
- The server sends back one or more images plus the challenge type.
- While the visitor drags, rotates or clicks, the client logs the path and its timing.
- The answer is submitted along with device and session identifiers.
- TikTok checks both the answer and the behaviour. A wrong position or an unnatural path fails.
- A failure brings a new challenge. There is no long-lived token to fall back on.
- Take the original challenge images from the network response, keeping their size and transparency.
- Recognise the variant: wide background plus piece means slide, concentric circles mean whirl, several 3D objects mean match, a prompt with icons means icon.
- Slide: run Sobel or Canny with
matchTemplate to find the gap, then drag along an eased, jittery path.
- Whirl: estimate the angle and drag along the circular track.
- 3D and icon: use a detector or classifier and click the targets in the order requested.
- Do all of it in the same browser session and submit at once.
- An answer generated on another device or IP is refused, because the challenge belongs to the session.
- The drag path is analysed: a straight move at constant speed fails even when it ends in the right place.
- Work on the original image bytes rather than a resized screenshot, or the geometry will be off.
- After a failure a new challenge appears. Try again with a different path.
- TikTok switches variants often, so keep solvers ready for slide, whirl, 3D and icon.
- Mobile and desktop apps may serve different sets of challenges.