https://api.nexscope.ai/video/seedance20VideoGenerationRun this API
Send a JSON request to execute this API and receive the documented response payload.
Endpoint
| Method | POST |
| Path | https://api.nexscope.ai/video/seedance20VideoGeneration |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
videoTime | integer | required | Video duration in seconds. Available options
Example: 10 |
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 | optional | Output resolution. Available options
Example: 720p |
imageUrl | string | optional | Public URL of a first-frame or primary reference image. Each image must be between 300 and 6000 pixels in both width and height. Example: https://example.com/source-image.jpg |
imageList | array | optional | Public reference image URLs. Provide 1 to 9 images. Each image must be between 300 and 6000 pixels in both width and height. Example: [
"https://example.com/product.jpg",
"https://example.com/ref-2.jpg"
] |
video | array | optional | 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. Seedance 2.0: up to 3 clips, each 2..15s and total <=15s; requires image/video. Seedance 2.5: up to 10 clips, each 2..30s and total <=30s; audio-only allowed. Example: [] |
aspectRatio | string | optional | Target video aspect ratio supported by this model. Available options
Example: 16:9 |
Code example
{
"imageUrl": "https://example.com/source-image.jpg",
"prompt": "Keep the product consistent while the camera slowly orbits and highlights material details.",
"resolution": "720p",
"videoTime": 10
}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. |
data.usage | object | optional | Actual credits charged for a completed successful task; omitted when unavailable. |
data.usage.chargedCredits | integer | required | Charged credits value used by this API operation. Minimum: 0 |
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. |