POST
https://api.nexscope.ai/api/skill-api/v1/skills/wan-3-video-generation/runRun this API
Send a JSON request to execute this API and receive the documented response payload.
Endpoint
| Method | POST |
| Path | https://api.nexscope.ai/api/skill-api/v1/skills/wan-3-video-generation/run |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
videoTime | integer | required | Video duration in seconds. Available options
Example: 5 |
prompt | string | required | Video generation prompt describing motion, subject consistency, camera movement, and the ecommerce scene. Maximum 10000 characters. Example: Keep the product consistent while the camera slowly orbits and highlights material details. |
promptOptimizer | boolean | optional | Whether Nexscope should optimize the video prompt before generation. Defaults to false. Example: false |
isPro | boolean | optional | Whether to use the model's professional generation mode when supported. Defaults to false. Example: false |
resolution | string | required | Output resolution. Available options
Example: 480p |
imageUrl | string | conditional | Public URL of a first-frame or primary reference image. Example: https://example.com/source-image.jpg |
imageList | array | conditional | Public reference image URLs. Provide 1 to 10 images. Example: [
"https://example.com/product.jpg",
"https://example.com/ref-2.jpg"
] |
video | array | conditional | Optional public reference-video URL list. Reference-video mode cannot be combined with image references or a final-frame image. Example: [
"https://example.com/reference-video.mp4"
] |
audio | array | optional | Optional mp3/wav reference audio URLs, <=15 MB each. Up to 5 clips, each 1..15s and total <=15s. Requires an image or reference video. Describe how the audio should influence the video in prompt. Example: [] |
aspectRatio | string | optional | Target video aspect ratio supported by this model. Available options
Example: 16:9 |
lastFrameImageUrl | string | optional | Optional public URL of the final-frame image. Use imageUrl for the first frame; do not combine first-and-last-frame mode with imageList or video. Example: https://example.com/last-frame.jpg |
Code example
{
"imageUrl": "https://example.com/source-image.jpg",
"prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
"resolution": "480p",
"videoTime": 5
}Response example
Platform response envelope. code 0 indicates success or acceptance; data contains the business result.
{
"code": 0,
"cost": "-1",
"data": {
"result": null,
"status": "PENDING",
"taskId": "example-task"
},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
}Response fields
| Name | Type | Required | Description |
|---|---|---|---|
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
data | any | required | Data value used by this API operation. |
msg | string | null | required | Msg value used by this API operation. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
traceId | string | null | required | Trace id value used by this API operation. |
ts | string | required | Epoch milliseconds. |
Any of option 1 — requires taskId, status, result
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.result | any | required | Result value used by this API operation. |
data.status | string | required | Status value used by this API operation. Allowed: PENDING, RUNNING, SUCCEEDED, FAILED, TIMEOUT |
data.taskId | string | required | Task id value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.result | object | required | Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt. |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.result | null | required | Result value used by this API operation. |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
Responses
| Code | Description |
|---|---|
| 200 | HTTP request completed. Check JSON code; only 0 indicates business success or acceptance. |
| 400 | Request JSON or required API parameters are invalid. |
| 401 | API key is missing, invalid, or cannot be matched to a user. |
| 5xx | API execution or upstream service failed. |
Data source, freshness, and limitations
Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.