Video Editing
Edit an existing video with style transfer, local replacement, and similar operations, optionally with 0–5 reference images. Output duration follows the input video (max 15 seconds). Supports up to 1080P resolution. This is an async task-based API: submit a request to receive a task_id, poll for status, then download the video when complete.
Base URL
https://api.autorouter.top— Production
Authentication
BearerAuth: http (bearer)
Authenticate using a Bearer Token.
Format: Authorization: Bearer sk-xxxxxx
Endpoints
POST /api/v1/services/aigc/video-generation/video-synthesis
Create Video Editing Task
Create a video editing task from an existing video.
The request header must include X-DashScope-Async: enable.
Request Body
Content-Type: application/json
Example:
{
"model": "happyhorse-1.0-video-edit",
"input": {
"prompt": "Make the horse-headed character in the video wear the striped sweater from the image",
"media": [
{
"type": "video",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260409/dozxak/Wan_Video_Edit_33_1.mp4"
},
{
"type": "reference_image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260415/hynnff/wan-video-edit-clothes.webp"
}
]
},
"parameters": {
"resolution": "720P"
}
}Properties:
| Name | Type | Required | Description |
|---|---|---|---|
model | string | Yes | Model name. Fixed value: happyhorse-1.0-video-edit |
input | object | Yes | Basic input such as the video to edit, reference images, and prompt |
input.prompt | string | Yes | Text prompt describing the editing intent (e.g. style transfer, local replacement). Supports any language. Maximum 5,000 non-Chinese characters or 2,500 Chinese characters; excess is truncated automatically |
input.media | array | Yes | Media list. Must contain exactly one element with type video. May optionally include 0–5 elements with type reference_image |
input.media[].type | string | Yes | Media type. Available values: video (video to edit; required, exactly one), reference_image (optional, 0–5) |
input.media[].url | string | Yes | Media URL. Video (type=video): Publicly accessible HTTP/HTTPS link (e.g. https://xxx/xxx.mp4). Limits: MP4/MOV (H.264 recommended); duration 3–60 seconds; long side ≤ 4096 px, short side ≥ 360 px; aspect ratio 1:2.5–2.5:1; max 100MB; frame rate > 8fps. Output duration is 3–15 seconds: if input ≤ 15s, output matches input; if input exceeds 15s, only the first 15 seconds are used. Reference image (type=reference_image): Public HTTP/HTTPS link, or Base64 string (data:{MIME_type};base64,{base64_data}). Limits: JPEG/JPG/PNG/WEBP; width and height ≥ 300 px; aspect ratio 1:2.5–2.5:1; max 20MB |
parameters | object | No | Video editing parameters such as resolution |
parameters.resolution | string | No | Output video resolution tier. Available values: 1080P (default), 720P |
parameters.watermark | boolean | No | Whether to add a watermark (fixed text "Happy Horse" in the bottom-right corner). true (default) adds it; false does not |
parameters.audio_setting | string | No | Controls video audio. Available values: auto (default, model-controlled audio), origin (keep the original audio from the input video) |
parameters.seed | integer | No | Random seed in [0, 2147483647]. Auto-generated if omitted. A fixed seed improves reproducibility but does not guarantee identical results |
Responses
200: Task created successfully
Content-Type: application/json
400: Bad request / invalid parameters
Content-Type: application/json
429: Rate limit exceeded
Content-Type: application/json
Request Example
curl -X POST "https://api.autorouter.top/api/v1/services/aigc/video-generation/video-synthesis" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxxxxx" \
-H "X-DashScope-Async: enable" \
-d '{
"model": "happyhorse-1.0-video-edit",
"input": {
"prompt": "Make the horse-headed character in the video wear the striped sweater from the image",
"media": [
{
"type": "video",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260409/dozxak/Wan_Video_Edit_33_1.mp4"
},
{
"type": "reference_image",
"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260415/hynnff/wan-video-edit-clothes.webp"
}
]
},
"parameters": {
"resolution": "720P"
}
}'Response Example
{
"output": {
"task_status": "PENDING",
"task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
},
"request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}Response fields:
| Name | Type | Description |
|---|---|---|
output | object | Task output |
output.task_id | string | Task ID for status queries. Valid for 24 hours |
output.task_status | string | Task status. Enum: PENDING (queued), RUNNING (processing), SUCCEEDED (success), FAILED (failed), CANCELED (canceled), UNKNOWN (missing or unknown) |
request_id | string | Unique request ID for tracing and troubleshooting |
code | string | Error code. Returned only when the request fails |
message | string | Error message. Returned only when the request fails |
GET /api/v1/tasks/{task_id}
Query Task Result by ID
Query task status and result using the task_id returned when creating the task. Queries are valid for 24 hours.
Headers
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | Request authentication. Format: Bearer sk-xxxxxx |
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
task_id | string | Yes | Task ID |
Responses
200: Task queried successfully
Content-Type: application/json
400: Bad request / invalid parameters
Content-Type: application/json
429: Rate limit exceeded
Content-Type: application/json
Request Example
curl -X GET "https://api.autorouter.top/api/v1/tasks/{task_id}" \
-H "Authorization: Bearer sk-xxxxxx"Response Example
{
"request_id": "99243b47-ec5f-9413-9993-xxxxxx",
"output": {
"task_id": "4673458e-28be-4a05-bf2a-xxxxxx",
"task_status": "SUCCEEDED",
"submit_time": "2026-04-20 17:55:17.075",
"scheduled_time": "2026-04-20 17:55:17.129",
"end_time": "2026-04-20 17:56:36.658",
"orig_prompt": "Make the horse-headed character in the video wear the striped sweater from the image",
"video_url": "https://dashscope-result.oss-cn-beijing.aliyuncs.com/xxx.mp4?Expires=xxx"
},
"usage": {
"duration": 5,
"input_video_duration": 5,
"output_video_duration": 5,
"video_count": 1,
"SR": 720
}
}Response fields:
| Name | Type | Description |
|---|---|---|
output | object | Task output |
output.task_id | string | Task ID. Valid for queries for 24 hours |
output.task_status | string | Task status. Enum: PENDING (queued), RUNNING (processing), SUCCEEDED (success), FAILED (failed), CANCELED (canceled), UNKNOWN (missing or unknown). Typical poll flow: PENDING → RUNNING → SUCCEEDED / FAILED |
output.submit_time | string | Task submission time, format YYYY-MM-DD HH:mm:ss.SSS |
output.scheduled_time | string | Task execution time, format YYYY-MM-DD HH:mm:ss.SSS |
output.end_time | string | Task completion time, format YYYY-MM-DD HH:mm:ss.SSS |
output.video_url | string | Video download URL. Returned only when task_status is SUCCEEDED. Link valid for 24 hours; video is MP4 (H.264) |
output.orig_prompt | string | Original prompt, corresponding to the request prompt |
output.code | string | Error code. Returned only when the task fails |
output.message | string | Error message. Returned only when the task fails |
usage | object | Output statistics. Returned only on success |
usage.input_video_duration | integer | Input video duration in seconds |
usage.output_video_duration | integer | Output video duration in seconds |
usage.duration | integer | Total video duration used for billing, equal to input_video_duration + output_video_duration |
usage.SR | integer | Output video resolution tier |
usage.video_count | integer | Number of output videos. Always 1 |
request_id | string | Unique request ID for tracing and troubleshooting |
Error Handling
HTTP 400 Parameter Errors (pre-submit validation, no billing)
AutoRouter validates required fields before submitting upstream:
| Scenario | Response |
|---|---|
Missing input.prompt | {"code":"InvalidParameter","message":"...","request_id":"..."} |
Missing input.media or video | {"code":"InvalidParameter","message":"...","request_id":"..."} |
| Unknown model | {"code":"InvalidParameter","message":"unknown model: ...","request_id":"..."} |
HTTP 401 / 403 Auth Errors
401 Unauthorized: API Key invalid or expired403 Forbidden: API Key has no access to this model (check token's model allowlist)
HTTP 402 Insufficient Balance
Returns insufficient user quota. Top up at the AutoRouter console.
Task FAILED Status
The task was accepted but upstream generation failed (output.task_status == "FAILED"). See output.code / output.message for details:
| Reason | Suggested Action |
|---|---|
| Content moderation | Adjust prompt to avoid sensitive content |
| Missing video to edit | media must contain exactly one type: video element |
| Invalid reference image count | Reference images: 0–5 type: reference_image |
| Media URL unreachable | Ensure the URL is publicly accessible and not expired |
| Media file violates specs | See video / image limits in Request Body |
| Illegal parameter combo | Follow the Request Body specification |
When a task enters FAILED, AutoRouter automatically refunds the billed quota. Check refund records in the logs page.
Reference-to-Video
Generate video from 1–9 reference images, referencing them in the prompt with [Image N]. Supports up to 15 seconds and 1080P resolution. This is an async task-based API: submit a request to receive a task_id, poll for status, then download the video when complete.
Text-to-Video
Generate video from a text prompt, with optional native audio. Supports 720p / 1080p resolution and 5 or 10 second duration. This is an async task-based API: submit a request to receive a task id, poll for status, then download the video when complete. Only Kling 2.6 is supported.