CQTAI
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

UsageMethodPath
Submit taskPOST/api/cqt/generator/viralclone
Query ResultGET/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).

modelUsageMaterialsDuration (sec)Resolutions
viral-clone-flashAdvanced: balanced speed and price (default tier)1 reference video · ≤10 product images2~15720P / 1080P
viral-clone-proPro: higher quality and fidelity, longer videos and the adaptive ratio1 reference video · ≤10 product images4~30720P / 1080P

Request Parameters

ParamTypeRequiredDescription
modelstringRequiredviral-clone-flash (advanced) / viral-clone-pro (pro)
cloneModestring—Clone type; motion on this page (defaults to script when omitted)
videoUrlsstring[]RequiredViral reference video URL, exactly 1 (must be publicly accessible)
durationnumberRequiredUse the reference video length (seconds, rounded up): the result follows the reference video; this is used for billing only. flash ≤15, pro ≤30
resolutionstring—720P (default) / 1080P
aspectRatiostring—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
promptstring—Extra requirements (optional), e.g. scene, mood, selling points
imageUrlsstring[]—Product image URLs (optional, ≤10); omit for non-commerce videos
productNamestring—Product name (optional)
productDescriptionstring—Selling-point description (optional)
personaImagesstring[]—Person reference images (optional, ≤10) to set the on-screen person
personaGenderstring—Model gender: male / female / any
personaAgestring—Age group: teenager / youth / middle_aged / senior
personaEthnicitystring—Appearance: caucasian / asian / latino / african / middle_eastern
personaBodyTypestring—Body type: slim / standard / athletic / chubby
outfitUrlsstring[]—Outfit reference images (motion clone only, ≤10). With several outfits they are applied in order as the reference video cuts between shots
backgroundUrlsstring[]—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

FieldTypeDescription
codenumber200 means success
data.idstringTask ID (taskId)
data.statusstringqueued / running / succeeded / failed
data.resultUrlstringResult video URL on our CDN (long-lived); null until done or on failure
data.errorMsgstring | nullFailure reason; null on success