Video edit: create an edit task from a video + reference images + instruction
curl --request POST \
--url https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-DashScope-Async: <x-dashscope-async>' \
--data @- <<EOF
{
"model": "wan2.7-videoedit",
"input": {
"prompt": "Replace the girl's outfit in the video with the outfit in the image",
"media": [
{
"type": "video",
"url": "https://your-cdn.com/source.mp4"
},
{
"type": "reference_image",
"url": "https://your-cdn.com/new-clothes.png"
}
]
}
}
EOFimport requests
url = "https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis"
payload = {
"model": "wan2.7-videoedit",
"input": {
"prompt": "Replace the girl's outfit in the video with the outfit in the image",
"media": [
{
"type": "video",
"url": "https://your-cdn.com/source.mp4"
},
{
"type": "reference_image",
"url": "https://your-cdn.com/new-clothes.png"
}
]
}
}
headers = {
"X-DashScope-Async": "<x-dashscope-async>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-DashScope-Async': '<x-dashscope-async>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'wan2.7-videoedit',
input: {
prompt: 'Replace the girl\'s outfit in the video with the outfit in the image',
media: [
{type: 'video', url: 'https://your-cdn.com/source.mp4'},
{type: 'reference_image', url: 'https://your-cdn.com/new-clothes.png'}
]
}
})
};
fetch('https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'wan2.7-videoedit',
'input' => [
'prompt' => 'Replace the girl\'s outfit in the video with the outfit in the image',
'media' => [
[
'type' => 'video',
'url' => 'https://your-cdn.com/source.mp4'
],
[
'type' => 'reference_image',
'url' => 'https://your-cdn.com/new-clothes.png'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"X-DashScope-Async: <x-dashscope-async>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis"
payload := strings.NewReader("{\n \"model\": \"wan2.7-videoedit\",\n \"input\": {\n \"prompt\": \"Replace the girl's outfit in the video with the outfit in the image\",\n \"media\": [\n {\n \"type\": \"video\",\n \"url\": \"https://your-cdn.com/source.mp4\"\n },\n {\n \"type\": \"reference_image\",\n \"url\": \"https://your-cdn.com/new-clothes.png\"\n }\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-DashScope-Async", "<x-dashscope-async>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis")
.header("X-DashScope-Async", "<x-dashscope-async>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"wan2.7-videoedit\",\n \"input\": {\n \"prompt\": \"Replace the girl's outfit in the video with the outfit in the image\",\n \"media\": [\n {\n \"type\": \"video\",\n \"url\": \"https://your-cdn.com/source.mp4\"\n },\n {\n \"type\": \"reference_image\",\n \"url\": \"https://your-cdn.com/new-clothes.png\"\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-DashScope-Async"] = '<x-dashscope-async>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"wan2.7-videoedit\",\n \"input\": {\n \"prompt\": \"Replace the girl's outfit in the video with the outfit in the image\",\n \"media\": [\n {\n \"type\": \"video\",\n \"url\": \"https://your-cdn.com/source.mp4\"\n },\n {\n \"type\": \"reference_image\",\n \"url\": \"https://your-cdn.com/new-clothes.png\"\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"output": {
"task_id": "3b216861-6a5f-441d-a438-602ab2c0d103",
"task_status": "PENDING"
},
"request_id": "..."
}Wan2.7 Video Generation (Alibaba)
Wan2.7 Video Edit API Reference
Wan2.7-videoedit video edit API reference and live playground: input video + reference images + natural-language instruction for local/global edits like outfit swap and background swap.
POST
/
wan
/
api
/
v1
/
services
/
aigc
/
video-generation
/
video-synthesis
Video edit: create an edit task from a video + reference images + instruction
curl --request POST \
--url https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-DashScope-Async: <x-dashscope-async>' \
--data @- <<EOF
{
"model": "wan2.7-videoedit",
"input": {
"prompt": "Replace the girl's outfit in the video with the outfit in the image",
"media": [
{
"type": "video",
"url": "https://your-cdn.com/source.mp4"
},
{
"type": "reference_image",
"url": "https://your-cdn.com/new-clothes.png"
}
]
}
}
EOFimport requests
url = "https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis"
payload = {
"model": "wan2.7-videoedit",
"input": {
"prompt": "Replace the girl's outfit in the video with the outfit in the image",
"media": [
{
"type": "video",
"url": "https://your-cdn.com/source.mp4"
},
{
"type": "reference_image",
"url": "https://your-cdn.com/new-clothes.png"
}
]
}
}
headers = {
"X-DashScope-Async": "<x-dashscope-async>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-DashScope-Async': '<x-dashscope-async>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'wan2.7-videoedit',
input: {
prompt: 'Replace the girl\'s outfit in the video with the outfit in the image',
media: [
{type: 'video', url: 'https://your-cdn.com/source.mp4'},
{type: 'reference_image', url: 'https://your-cdn.com/new-clothes.png'}
]
}
})
};
fetch('https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'wan2.7-videoedit',
'input' => [
'prompt' => 'Replace the girl\'s outfit in the video with the outfit in the image',
'media' => [
[
'type' => 'video',
'url' => 'https://your-cdn.com/source.mp4'
],
[
'type' => 'reference_image',
'url' => 'https://your-cdn.com/new-clothes.png'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"X-DashScope-Async: <x-dashscope-async>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis"
payload := strings.NewReader("{\n \"model\": \"wan2.7-videoedit\",\n \"input\": {\n \"prompt\": \"Replace the girl's outfit in the video with the outfit in the image\",\n \"media\": [\n {\n \"type\": \"video\",\n \"url\": \"https://your-cdn.com/source.mp4\"\n },\n {\n \"type\": \"reference_image\",\n \"url\": \"https://your-cdn.com/new-clothes.png\"\n }\n ]\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-DashScope-Async", "<x-dashscope-async>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis")
.header("X-DashScope-Async", "<x-dashscope-async>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"wan2.7-videoedit\",\n \"input\": {\n \"prompt\": \"Replace the girl's outfit in the video with the outfit in the image\",\n \"media\": [\n {\n \"type\": \"video\",\n \"url\": \"https://your-cdn.com/source.mp4\"\n },\n {\n \"type\": \"reference_image\",\n \"url\": \"https://your-cdn.com/new-clothes.png\"\n }\n ]\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-DashScope-Async"] = '<x-dashscope-async>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"wan2.7-videoedit\",\n \"input\": {\n \"prompt\": \"Replace the girl's outfit in the video with the outfit in the image\",\n \"media\": [\n {\n \"type\": \"video\",\n \"url\": \"https://your-cdn.com/source.mp4\"\n },\n {\n \"type\": \"reference_image\",\n \"url\": \"https://your-cdn.com/new-clothes.png\"\n }\n ]\n }\n}"
response = http.request(request)
puts response.read_body{
"output": {
"task_id": "3b216861-6a5f-441d-a438-602ab2c0d103",
"task_status": "PENDING"
},
"request_id": "..."
}The Playground on the right lets you debug directly: put
Bearer sk-your-api-key in Authorization, fill in model / input.media / parameters, and send the request. A successful submission returns a task_id; see below for polling and download.This page is the creation endpoint for
wan2.7-videoedit (video edit): give a video + 1-5 reference images + a natural-language edit instruction to edit video elements, such as swapping outfits or backgrounds. Note the model name has no hyphen (videoedit). For the full async flow, see the Wan Overview.input.mediamust contain both avideo(the video being edited) and at least onereference_image(the reference asset, ≤5).- The model name is
wan2.7-videoedit(no hyphen), different from HappyHorse’shappyhorse-1.0-video-edit(with hyphens), so don’t mix them up. - Creation requests go to
/wan/api/v1/...withX-DashScope-Async: enable; do not use/v1/videos.
Code examples
curl -X POST "https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis" \
-H "X-DashScope-Async: enable" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.7-videoedit",
"input": {
"prompt": "Replace the girl's outfit in the video with the outfit in the image",
"media": [
{"type": "video", "url": "https://your-cdn.com/source.mp4"},
{"type": "reference_image", "url": "https://your-cdn.com/new-clothes.png"}
]
},
"parameters": {"resolution": "720P", "prompt_extend": true, "watermark": true}
}'
import requests
url = "https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis"
headers = {
"Authorization": "Bearer sk-your-api-key",
"Content-Type": "application/json",
"X-DashScope-Async": "enable",
}
body = {
"model": "wan2.7-videoedit",
"input": {
"prompt": "Replace the girl's outfit in the video with the outfit in the image",
"media": [
{"type": "video", "url": "https://your-cdn.com/source.mp4"},
{"type": "reference_image", "url": "https://your-cdn.com/new-clothes.png"},
],
},
"parameters": {"resolution": "720P", "prompt_extend": True, "watermark": True},
}
resp = requests.post(url, json=body, headers=headers, timeout=30)
print("task_id:", resp.json()["output"]["task_id"])
import requests
# Up to 5 reference_image for finer local/global edits
body = {
"model": "wan2.7-videoedit",
"input": {
"prompt": "Replace the background in the video with the seaside in image 1, and change the character's outfit to image 2",
"media": [
{"type": "video", "url": "https://your-cdn.com/source.mp4"},
{"type": "reference_image", "url": "https://your-cdn.com/beach.png"},
{"type": "reference_image", "url": "https://your-cdn.com/outfit.png"},
],
},
"parameters": {"resolution": "720P", "prompt_extend": True},
}
resp = requests.post(
"https://api.apiyi.com/wan/api/v1/services/aigc/video-generation/video-synthesis",
json=body,
headers={"Authorization": "Bearer sk-your-api-key", "Content-Type": "application/json",
"X-DashScope-Async": "enable"},
timeout=30,
)
print(resp.json()["output"]["task_id"])
Parameter and media quick reference
| Parameter | Type | Required | Default | Notes |
|---|---|---|---|---|
model | string | ✓ | — | Fixed wan2.7-videoedit |
input.prompt | string | ✓ | — | Natural-language edit instruction |
input.media | array | ✓ | — | See the media table below |
parameters.resolution | string | 720P | 720P / 1080P | |
parameters.prompt_extend | bool | true | Smart rewriting | |
parameters.watermark | bool | false | ”AI generated” watermark |
media[] values
type | Required | Count | Notes |
|---|---|---|---|
video | ✓ | 1 | The source video being edited |
reference_image | ✓ | 1-5 | Reference asset (new outfit, new background, etc.) |
The video edit output duration follows the input video, not the
duration parameter, so this capability usually does not pass duration.Response format
{
"output": { "task_id": "3b216861-6a5f-441d-a438-602ab2c0d103", "task_status": "PENDING" },
"request_id": "..."
}
Check status and download
Once you have thetask_id, follow these three steps to poll status and download the mp4:
- Poll
GET /v1/tasks/{task_id}(withAuthorization; the query does not need theX-DashScope-Asyncheader), every 5-10 seconds (not < 3 seconds), untilstatusbecomescompleted. - Status values:
submitted(queued) /in_progress(generating;progressoften sitting at 30% is normal) /completed(success) /failed(checkerror). - Download: GET the
result_urlfrom the response directly, without theAuthorizationheader (it is an OSS signed direct link — sending Auth returns 403);result_urlexpires in 24 hours by default, so save it promptly.
curl "https://api.apiyi.com/v1/tasks/3b216861-6a5f-441d-a438-602ab2c0d103" \
-H "Authorization: Bearer sk-your-api-key"
{
"status": "completed",
"progress": 100,
"result_url": "https://dashscope-result-xxx.oss-cn-beijing.aliyuncs.com/xxx.mp4?Expires=...&Signature=...",
"task_id": "3b216861-6a5f-441d-a438-602ab2c0d103"
}
# result_url is an OSS signed direct link — do NOT send the Authorization header (it returns 403)
curl -L -o out.mp4 "https://dashscope-result-xxx.oss-cn-beijing.aliyuncs.com/xxx.mp4?Expires=...&Signature=..."
TASK_ID="3b216861-6a5f-441d-a438-602ab2c0d103"
URL=$(curl -s "https://api.apiyi.com/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer sk-your-api-key" | jq -r '.result_url')
curl -L -o out.mp4 "$URL" # no Authorization
The above is the quick check/download path for “already have a task_id”. For the full polling loop (with timeout fallback) and Python client, see Wan Overview · Async call flow.
Authorizations
The API Key obtained from the APIYI console
Headers
Async processing switch; must be set to enable
Available options:
enable Body
application/json
Was this page helpful?
⌘I