CQTAI
Viral Clone · Video

Script cloneNEW

📌 What is this: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.
💡 When to use:Commerce short videos: you found a viral clip and want the same script with your own product.

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; script on this page (defaults to script when omitted)
videoUrlsstring[]RequiredViral reference video URL, exactly 1 (must be publicly accessible)
imageUrlsstring[]RequiredProduct image URLs, 1-10 images
durationnumberRequiredOutput length in seconds: flash 2-15, pro 4-30. Also the billed seconds
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
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
languagestring—Voice-over language (script clone only): zh / en / ja / ko / es / pt / de / fr / it / pl / instrumental (no voice-over)
marketstring—Target market (script clone only), affects localization: north_america / europe / china / japan / korea / sea / brazil

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-flash",
    "cloneMode": "script",
    "videoUrls": [
      "https://example.com/viral.mp4"
    ],
    "imageUrls": [
      "https://example.com/product-1.png",
      "https://example.com/product-2.png"
    ],
    "productName": "Ice-silk white dress",
    "productDescription": "Cooling ice-silk fabric, quick-dry and breathable",
    "duration": 10,
    "resolution": "720P",
    "aspectRatio": "9:16",
    "language": "en",
    "market": "north_america",
    "personaGender": "female",
    "personaAge": "youth",
    "prompt": "Show the product in a sunny park"
  }'
# -> { "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