Viral Clone · Video
Motion cloneNEW
📌 What is this: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…).
💡 When to use:You want your own person or character to perform the same moves, or to change the outfit or scene of the same performance.
Endpoints
| Usage | Method | Path |
|---|---|---|
| Submit task | POST | /api/cqt/generator/viralclone |
| Query Result | GET | /api/cqt/info/viralclone?id={taskId} |
⏱ Recommended polling interval:Viral clone is slow — usually a few minutes. Poll every 10 s until status = succeeded / failed.
Models
Both models share the same endpoint and parameters; they differ in quality, allowed length and ratios. Lengths outside the table are rejected at submit (no charge).
| model | Usage | Materials | Duration (sec) | Resolutions |
|---|---|---|---|---|
| viral-clone-flash | Advanced: balanced speed and price (default tier) | 1 reference video · ≤10 product images | 2~15 | 720P / 1080P |
| viral-clone-pro | Pro: higher quality and fidelity, longer videos and the adaptive ratio | 1 reference video · ≤10 product images | 4~30 | 720P / 1080P |
Request Parameters
| Param | Type | Required | Description |
|---|---|---|---|
| model | string | Required | viral-clone-flash (advanced) / viral-clone-pro (pro) |
| cloneMode | string | — | Clone type; motion on this page (defaults to script when omitted) |
| videoUrls | string[] | Required | Viral reference video URL, exactly 1 (must be publicly accessible) |
| duration | number | Required | Use the reference video length (seconds, rounded up): the result follows the reference video; this is used for billing only. flash ≤15, pro ≤30 |
| resolution | string | — | 720P (default) / 1080P |
| aspectRatio | string | — | 9:16 / 16:9 / 3:4 / 4:3 / 1:1 / 21:9; pro also accepts adaptive (match the reference video). Omit to auto-pick 9:16 or 16:9 from the reference video |
| prompt | string | — | Extra requirements (optional), e.g. scene, mood, selling points |
| imageUrls | string[] | — | Product image URLs (optional, ≤10); omit for non-commerce videos |
| productName | string | — | Product name (optional) |
| productDescription | string | — | Selling-point description (optional) |
| personaImages | string[] | — | Person reference images (optional, ≤10) to set the on-screen person |
| personaGender | string | — | Model gender: male / female / any |
| personaAge | string | — | Age group: teenager / youth / middle_aged / senior |
| personaEthnicity | string | — | Appearance: caucasian / asian / latino / african / middle_eastern |
| personaBodyType | string | — | Body type: slim / standard / athletic / chubby |
| outfitUrls | string[] | — | Outfit reference images (motion clone only, ≤10). With several outfits they are applied in order as the reference video cuts between shots |
| backgroundUrls | string[] | — | Background / scene reference images (motion clone only, ≤10) |
Request Example
curl -X POST https://api.cqtai.com/api/cqt/generator/viralclone \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"model": "viral-clone-pro",
"cloneMode": "motion",
"videoUrls": [
"https://example.com/dance.mp4"
],
"duration": 12,
"resolution": "720P",
"personaImages": [
"https://example.com/person.png"
],
"outfitUrls": [
"https://example.com/outfit-1.png"
],
"backgroundUrls": [
"https://example.com/background.png"
],
"prompt": "Change the outfit to a black leather jacket"
}'
# -> { "code":200, "data":"<taskId>" }Response Example
{
"code": 200,
"msg": "success",
"data": {
"id": "<taskId>",
"status": "succeeded",
"resultUrl": "https://.../clone.mp4",
"errorMsg": null,
"createTime": "2026-11-18 10:00:00",
"completeTime": "2026-11-18 10:05:00"
}
}⏳ File links are kept for 15 days and then deleted automatically. Please download and re-host your files in time.
Response Fields
| Field | Type | Description |
|---|---|---|
| code | number | 200 means success |
| data.id | string | Task ID (taskId) |
| data.status | string | queued / running / succeeded / failed |
| data.resultUrl | string | Result video URL on our CDN (long-lived); null until done or on failure |
| data.errorMsg | string | null | Failure reason; null on success |