IMPORTANT ASYNCHRONOUS TASK WORKFLOW

  1. Call this MCP generation tool once and read taskId from structuredContent.
  2. Do not call the generation tool again while the task is PENDING or RUNNING.
  3. Wait at least 5 seconds, then call nexscope_media_task_result with skillSlug set to ai-video-reclone-api, the exact taskId, and the same bearer API key. While the task remains PENDING or RUNNING, use 5, 10, 20, and 30-second progressive backoff. Never query more often than once every 5 seconds.
  4. Stop querying when the task succeeds or fails. On success, return the final Nexscope resource URLs and the returned count as the actual charged credits.
  5. Never invent a taskId and never expose internal provider names or provider resource URLs.

Multimodal AI

AI Video Reclone API MCP Tool

Generate a product marketing video using a reference video, reference images, country, language, duration, and resolution.

MCP tool name
nexscope_ai_video_reclone_api
Equivalent REST API path
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/ai-video-reclone-api/run
JSON-RPC method
tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "ai-video-reclone-api-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_ai_video_reclone_api",
    "arguments": {
      "refVideoUrl": "https://example.com/reference-video.mp4",
      "refImageList": [
        "https://example.com/product.jpg"
      ],
      "videoType": "product",
      "duration": 15,
      "resolution": "720p",
      "saleCountry": "US",
      "targetLanguage": "en",
      "ratio": "9:16",
      "productInfo": {
        "title": "Phone case",
        "sellingPoints": [
          "shockproof",
          "slim"
        ]
      },
      "prompt": "highlight the slim protective design"
    }
  }
}
REST API equivalent
POST https://claw-callback.nexscope.ai/api/skill-api/v1/skills/ai-video-reclone-api/run
Canonical detail URL
https://www.nexscope.ai/mcp-map/ai-video-reclone-api

Asynchronous task workflow

This capability uses a create-and-query flow. Creating the task and retrieving its final generated resources are two connected requests.

  1. 1. Create onceCall the MCP tool once and keep the returned taskId.
  2. 2. Query with backoffCall nexscope_media_task_result with this skill slug and task ID. Wait at least 5 seconds first; while pending or running, back off at 5, 10, 20, then 30-second intervals.
  3. 3. Use final resultStop at a terminal status. Successful results contain Nexscope resource URLs and the actual charged-credit count.
MCP task result call
{
  "jsonrpc": "2.0",
  "id": "ai-video-reclone-api-result-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_media_task_result",
    "arguments": {
      "skillSlug": "ai-video-reclone-api",
      "taskId": "TASK_ID_FROM_THE_GENERATION_RESULT"
    }
  }
}
REST fallback
GET https://claw-callback.nexscope.ai/api/skill-api/v1/skills/ai-video-reclone-api/tasks/{taskId}

Arguments

NameTypeRequiredMeaning
refVideoUrlstringrequired
Public URL of the reference video.
Example: https://example.com/reference-video.mp4
refImageListarrayrequired
Public image URLs for product or visual references.
Example: [ "https://example.com/product.jpg" ]
videoTypestringrequired
Video type supported by the upstream API.
Example: product
durationintegerrequired
Target video duration in seconds.
Example: 15
resolutionstringrequired
Target video resolution preset.
Example: 720p
saleCountrystringrequired
Target sale country code.
Example: US
targetLanguagestringrequired
Target language code.
Example: en
ratiostringoptional
Target video aspect ratio.
Example: 9:16
productInfoobjectoptional
Optional product metadata object.
Example: { "title": "Phone case", "sellingPoints": [ "shockproof", "slim" ] }
promptstringoptional
Optional creative direction prompt.
Example: highlight the slim protective design

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredMeaning
taskIdstringrequired
Nexscope asynchronous task id used to query the generation result.
Example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2
statusstringrequired
Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT.
Example: PENDING
messagestringoptional
User-facing task state message.
Example: The task has been created. Use taskId to query the result.
errcodeintegeroptional
Upstream status code returned by the provider.
Example: {}
errmsgstringoptional
Upstream status message returned by the provider.
Example: {}
codestringoptional
Provider-specific status code.
Example: {}
msgstringoptional
Provider-specific status message.
Example: {}
typestringoptional
Provider-specific render or payload type.
Example: {}
titlestringoptional
Provider-specific response title.
Example: {}
sourceTypestringoptional
Provider-specific source platform type.
Example: {}
sourceToolstringoptional
Provider-specific source tool name.
Example: {}
costTokenintegeroptional
Token cost reported by the upstream provider.
Example: {}
costTimeintegeroptional
Execution time reported by the upstream provider.
Example: {}
pageintegeroptional
Current page returned by the upstream provider.
Example: {}
pageSizeintegeroptional
Page size returned by the upstream provider.
Example: {}
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: {}
totalPageintegeroptional
Total page count returned by the upstream provider.
Example: {}
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: {}

Examples

Example arguments

{
  "refVideoUrl": "https://example.com/reference-video.mp4",
  "refImageList": [
    "https://example.com/product.jpg"
  ],
  "videoType": "product",
  "duration": 15,
  "resolution": "720p",
  "saleCountry": "US",
  "targetLanguage": "en",
  "ratio": "9:16",
  "productInfo": {
    "title": "Phone case",
    "sellingPoints": [
      "shockproof",
      "slim"
    ]
  },
  "prompt": "highlight the slim protective design"
}

Example structuredContent

{
  "taskId": "6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2",
  "status": "PENDING",
  "message": "The task has been created. Use taskId to query the result."
}