Multimodal AI

AI Video Reclone API

Generate a product marketing video using a reference video, reference images, and model-specific generation settings.

post/api/skill-api/v1/skills/ai-video-reclone/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/ai-video-reclone/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

refVideoUrlstring required

Public URL of the reference video.

refImageListstring[] required

Public image URLs for product or visual references.

videoTypestring required

Video model. Supported values: seedance-2-0, seedance-2-0-fast, seedance-2-0-mini, seedance-2-5, or happyhorse-v2.

videoTimeinteger

Optional target video duration in seconds. Seedance 2.0, Fast, Mini, and HappyHorse V2 support any integer from 5 through 15; Seedance 2.5 supports 5, 10, 15, 20, 25, or 30.

resolutionstring required

Target video resolution supported by the selected model, such as 720p or 1080p.

aspectRatiostring

Target video aspect ratio supported by the selected model.

saleCountrystring required

Target market country code used to localize the recreated video.

targetLanguagestring required

Target spoken and on-screen language for the recreated video.

productInfostring

Concise product information used to guide the recreation. Maximum 2500 characters.

promptstring

Optional creative direction prompt.

Example request

{
  "refVideoUrl": "https://example.com/reference-video.mp4",
  "refImageList": [
    "https://example.com/product.jpg"
  ],
  "videoType": "seedance-2-0-fast",
  "videoTime": 10,
  "resolution": "720p",
  "aspectRatio": "9:16",
  "saleCountry": "US",
  "targetLanguage": "English",
  "productInfo": "Slim shockproof phone case with a clear finish.",
  "prompt": "highlight the slim protective design"
}

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.