Viral Clone · Video
Viral Clone · Introduction
Viral clone: give it a viral reference video and it clones the script (re-shot with your product) or the motion (swap person / outfit / background) into a matching video. Two models: advanced viral-clone-flash and pro viral-clone-pro, 720P / 1080P. Billed by output length. Returns a taskId; poll for the result — usually a few minutes.
How to call
- Submit:
POST /api/cqt/generator/viralclone, returns a taskId. - Query:
GET /api/cqt/info/viralclone?id=taskId, poll until status = succeeded.
Capability map
POSTScript cloneNEW
Give it a viral reference video and your product images: it keeps the viral video’s structure and pacing and re-shoots it with your product. You can set the model’s look, the voice-over language and the target market.
POSTMotion cloneNEW
Reuses the viral video’s motion and camera work and swaps the person, outfit and background. Product images are optional, so it also fits non-commerce videos (dance, music videos…).
⏳ File retention:Files generated or uploaded on the platform (images, videos, audio and other outputs) are kept for 15 days and then deleted automatically; their links stop working once deleted. Please download them and re-host them in your own storage in time.
💰 See the pricing page for prices →
Common Errors
| Code | msg | Meaning | How to fix |
|---|---|---|---|
| 400 | model must be one of: [viral-clone-flash, viral-clone-pro] | model is not a model of this channel | Use viral-clone-flash or viral-clone-pro |
| 400 | videoUrls must contain exactly 1 reference video | Exactly 1 reference video is required | Pass one viral reference video URL in videoUrls |
| 400 | imageUrls (product images) is required for script clone: at least 1 | Script clone needs product images | Pass at least 1 product image in imageUrls |
| 400 | duration is required ... / duration must be 2~15 seconds for viral-clone-flash | duration is missing or out of range (flash 2-15 s, pro 4-30 s) | Use a duration in range; for motion clone use the reference video length (rounded up) |
| 400 | outfitUrls/backgroundUrls are only for motion clone | Outfit / background references are accepted by motion clone only | Do not send them for script clone |
| 400 | aspectRatio 'adaptive' is not supported by viral-clone-flash | The advanced model does not support adaptive | Use the pro model, or omit aspectRatio (auto) |
| 500 | generation_failed | Generation failed; data.errorMsg has details (credits auto-refunded) | Adjust per the reason (e.g. material moderation) and retry; contact support if it keeps failing |
Errors are returned as a bizCode, e.g. bizCode=451, msg=prompt_unsafe.
Tip: after saving your API Key via Authorize, every capability page supports "Try it".