Menggunakan model referensi-ke-video Wan - Alibaba Cloud Model Studio

Wan-R2V menerima input multimodal (teks, gambar, video, dan audio) untuk menghasilkan video performa. Gunakan prompt untuk menjadikan orang atau objek sebagai karakter utama.

Tautan cepat: Referensi API | Panduan prompt

Mulai

Prompt input: Video 1 masuk dari sisi kiri jauh frame. Lalu shot berpindah ke close-up Gambar 1. Video 1 bersandar pada dinding berkarat di sisi kanan dari Gambar 2. Mendengar langkah kaki, ia perlahan memutar kepalanya. Setelah melihat Gambar 1, Video 1 berkata, "Mengapa kamu masih datang?" Gambar 1 menjawab, "Mari kita bicara."

Video masukan (Video 1)

Personas

Gambar input (Gambar 1)

Karakter referensi

Gambar input (Gambar 2)

Latar belakang referensi

Video output (multi-shot, dengan audio)

Suara referensi input:

wan-r2v-boy-en

Suara referensi input:

wan-r2v-bg-en

Sebelum memulai, dapatkan Kunci API dan tetapkan sebagai Variabel lingkungan. Untuk menggunakan SDK, instal SDK DashScope.

SDK Python

Penting

Pastikan versi SDK Python DashScope Anda minimal 1.25.16 sebelum menjalankan kode berikut.

Versi lama mungkin memicu error seperti "url error, please check url!". Lihat 安装SDK.

# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# Berikut adalah URL untuk wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah. Untuk informasi lebih lanjut, lihat https://www.alibabacloud.com/help/en/model-studio/wan-video-to-video-api-reference
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# Jika Anda belum menyetel variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx"
# Kunci API berbeda-beda tergantung wilayah. Untuk informasi lebih lanjut, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

media = [
    {
        "type": "reference_video",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/pfgcuv/wan-r2v-girl-en.mp4",
        "reference_voice": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/exiikq/wan-r2v-girl-demo-voice-en.mp3"
    },
    {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/skhalj/wan-r2v-boy-en.jpg",
        "reference_voice": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/pqxdoi/wan-r2v-boy-voice-en.mp3"
    },
    {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/vyqjxd/wan-r2v-bg-en.jpg"
    }
]

print('please wait...')
rsp = VideoSynthesis.call(
    api_key=api_key,
    model="wan2.7-r2v-2026-06-12",
    media=media,
    resolution="720P",
    ratio="16:9",
    duration=10,
    prompt_extend=False,
    watermark=True,
    prompt="Video 1 masuk dari sisi kiri jauh frame. Lalu shot berpindah ke close-up Gambar 1. Video 1 bersandar pada dinding berkarat di sisi kanan dari Gambar 2. Mendengar langkah kaki, ia perlahan memutar kepalanya. Setelah melihat Gambar 1, Video 1 berkata, \"Mengapa kamu masih datang?\" Gambar 1 menjawab, \"Mari kita bicara.\"",
)
print(rsp)
if rsp.status_code == HTTPStatus.OK:
    print("video_url:", rsp.output.video_url)
else:
    print('Gagal, status_code: %s, code: %s, message: %s' % (rsp.status_code, rsp.code, rsp.message))

SDK Java

Penting

Pastikan versi SDK Java DashScope Anda minimal 2.22.14, lalu jalankan kode berikut.

Versi lama mungkin memicu error seperti "url error, please check url!". Lihat 安装SDK.

// Copyright (c) Alibaba, Inc. and its affiliates.

import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;

import java.util.ArrayList;
import java.util.List;

public class Ref2Video {

    static {
        // Berikut adalah URL untuk wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah. Untuk informasi lebih lanjut, lihat https://www.alibabacloud.com/help/en/model-studio/wan-video-to-video-api-reference
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // Jika Anda belum menyetel variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: apiKey="sk-xxx"
    // Kunci API berbeda-beda tergantung wilayah. Untuk informasi lebih lanjut, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void ref2video() throws ApiException, NoApiKeyException, InputRequiredException {
        VideoSynthesis vs = new VideoSynthesis();
        final String prompt = "Video 1 masuk dari sisi kiri jauh frame. Lalu shot berpindah ke close-up Gambar 1. Video 1 bersandar pada dinding berkarat di sisi kanan dari Gambar 2. Mendengar langkah kaki, ia perlahan memutar kepalanya. Setelah melihat Gambar 1, Video 1 berkata, \"Mengapa kamu masih datang?\" Gambar 1 menjawab, \"Mari kita bicara.\"";
        List<VideoSynthesisParam.Media> media = new ArrayList<VideoSynthesisParam.Media>(){{
            add(VideoSynthesisParam.Media.builder()
                    .url("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/pfgcuv/wan-r2v-girl-en.mp4")
                    .type("reference_video")
                    .referenceVoice("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/exiikq/wan-r2v-girl-demo-voice-en.mp3")
                    .build());
            add(VideoSynthesisParam.Media.builder()
                    .url("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/skhalj/wan-r2v-boy-en.jpg")
                    .type("reference_image")
                    .referenceVoice("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/pqxdoi/wan-r2v-boy-voice-en.mp3")
                    .build());
            add(VideoSynthesisParam.Media.builder()
                    .url("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/vyqjxd/wan-r2v-bg-en.jpg")
                    .type("reference_image")
                    .build());
        }};
        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .apiKey(apiKey)
                        .model("wan2.7-r2v-2026-06-12")
                        .prompt(prompt)
                        .media(media)
                        .watermark(true)
                        .duration(10)
                        .resolution("720P")
                        .ratio("16:9")
                        .promptExtend(false)
                        .build();
        System.out.println("please wait...");
        VideoSynthesisResult result = vs.call(param);
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        try {
            ref2video();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}

curl

Langkah 1: Buat tugas dan dapatkan ID tugas

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan2.7-r2v-2026-06-12",
    "input": {
        "prompt": "Video 1 masuk dari sisi kiri jauh frame. Lalu shot berpindah ke close-up Gambar 1. Video 1 bersandar pada dinding berkarat di sisi kanan dari Gambar 2. Mendengar langkah kaki, ia perlahan memutar kepalanya. Setelah melihat Gambar 1, Video 1 berkata, \"Mengapa kamu masih datang?\" Gambar 1 menjawab, \"Mari kita bicara.\" ",
        "media": [
            {
                "type": "reference_video",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/pfgcuv/wan-r2v-girl-en.mp4",
                "reference_voice": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/exiikq/wan-r2v-girl-demo-voice-en.mp3"
            },
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/skhalj/wan-r2v-boy-en.jpg",
                "reference_voice": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/pqxdoi/wan-r2v-boy-voice-en.mp3"
            },
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/vyqjxd/wan-r2v-bg-en.jpg"
            }
        ]
    },
    "parameters": {
        "resolution": "720P",
        "ratio": "16:9",
        "duration": 10,
        "prompt_extend": false,
        "watermark": true
    }
}'

Langkah 2: Ambil hasil menggunakan ID tugas

Ganti {task_id} dengan nilai task_id yang dikembalikan oleh panggilan API sebelumnya. task_id berlaku untuk kueri selama 24 jam.

curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Ketersediaan

Model yang didukung berbeda-beda tergantung wilayah. Sumber daya diisolasi antar-wilayah. Untuk model yang didukung di setiap wilayah, lihat Konsol Model Studio.
Saat melakukan panggilan, pastikan model, URL titik akhir, dan Kunci API Anda semuanya berasal dari wilayah yang sama. Panggilan lintas-wilayah akan gagal.

Catatan

Kode contoh dalam topik ini berlaku untuk wilayah Singapura. Jika Anda menggunakan wilayah lain, lihat Referensi API.

Kemampuan inti (wan2.7)

Referensi gambar tunggal (gambar multi-panel)

Model yang didukung: seri wan2.7.

Deskripsi: Anda dapat menginput gambar multi-panel (storyboard). Model secara otomatis mendeteksi tata letak multi-panel dan menghasilkan video dengan karakter, adegan, dan shot yang konsisten. Anda hanya dapat menginput satu gambar multi-panel dalam satu waktu.

Parameter:

media.type: Atur ke reference_image.
media.url: URL atau string yang dienkripsi Base64 dari gambar multi-panel.
prompt: Jika Anda hanya menyediakan satu gambar atau video referensi, gunakan "reference image" atau "reference video".

Prompt input: Reference image, gaya film animasi petualangan 3D, karakter chibi dengan tekstur detail, gerakan halus, dan warna cerah. Pertahankan konsistensi karakter dan adegan hutan. Jangan tambahkan teks. Suasana: Petualang, riang, misterius, imajinatif. Karakter: Penjelajah laki-laki: topi bulat, ransel, jubah pendek. Teman: robot kecil terbang berbodi bulat dengan mata bercahaya biru. Adegan: Hutan fantasi dengan akar pohon raksasa, jamur, tanaman merambat, pintu masuk gua harta karun, dan sinar matahari. Storyboard: 1. Wide shot: Pohon tinggi dan sinar cahaya bersilangan di hutan fantasi misterius dan terang. 2. Medium shot: Anak laki-laki mendorong tanaman merambat untuk menjelajah. 3. Medium shot: Robot kecil terbang di sampingnya, memindai ke depan dengan cahaya biru. 4. Close-up: Peta harta karun tua terbuka di tangan anak laki-laki. 5. Close-up: Ia menunjukkan ekspresi bersemangat, matanya berbinar. 6. Action shot: Keduanya melompati akar pohon dan sungai, melanjutkan lebih dalam ke hutan. 7. Medium shot: Peti harta karun berlumut terungkap di balik tanaman merambat. 8. Close-up: Cahaya emas bersinar dari tepi peti harta karun. 9. Final shot: Anak laki-laki dan robot kecil berdiri di depan peti harta karun, saling memandang dengan terkejut, penuh petualangan.
Gambar multi-panel input	Video output

SDK Python

Pastikan SDK Python DashScope Anda menggunakan versi 1.25.16 atau yang lebih baru. Lihat Instal SDK.

# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# Ini adalah URL untuk wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah. Untuk mendapatkan URL, lihat https://www.alibabacloud.com/help/en/model-studio/wan-video-to-video-api-reference
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx"
# Kunci API berbeda-beda tergantung wilayah. Untuk mendapatkan Kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

media = [
    {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260403/wgjaxy/banana_storyboard_00000020.png"
    }
]


def sample_sync_call():
    print('----sync call, please wait a moment----')
    rsp = VideoSynthesis.call(
        api_key=api_key,
        model="wan2.7-r2v-2026-06-12",
        media=media,
        resolution="720P",
        ratio="16:9",
        duration=10,
        prompt_extend=False,
        watermark=True,
        prompt="Reference image, gaya film animasi petualangan 3D, karakter chibi dengan tekstur detail, gerakan halus, dan warna cerah. Pertahankan konsistensi karakter dan adegan hutan. Jangan tambahkan teks. Suasana: Petualang, riang, misterius, imajinatif. Karakter: Penjelajah laki-laki: topi bulat, ransel, jubah pendek. Teman: robot kecil terbang berbodi bulat dengan mata bercahaya biru. Adegan: Hutan fantasi dengan akar pohon raksasa, jamur, tanaman merambat, pintu masuk gua harta karun, dan sinar matahari. Storyboard: 1. Wide shot: Pohon tinggi dan sinar cahaya bersilangan di hutan fantasi misterius dan terang. 2. Medium shot: Anak laki-laki mendorong tanaman merambat untuk menjelajah. 3. Medium shot: Robot kecil terbang di sampingnya, memindai ke depan dengan cahaya biru. 4. Close-up: Peta harta karun tua terbuka di tangan anak laki-laki. 5. Close-up: Ia menunjukkan ekspresi bersemangat, matanya berbinar. 6. Action shot: Keduanya melompati akar pohon dan sungai, melanjutkan lebih dalam ke hutan. 7. Medium shot: Peti harta karun berlumut terungkap di balik tanaman merambat. 8. Close-up: Cahaya emas bersinar dari tepi peti harta karun. 9. Final shot: Anak laki-laki dan robot kecil berdiri di depan peti harta karun, saling memandang dengan terkejut, penuh petualangan.",
    )
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('Gagal, status_code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))


if __name__ == '__main__':
    sample_sync_call()

SDK Java

Pastikan SDK Java DashScope Anda menggunakan versi 2.22.14 atau yang lebih baru. Lihat Instal SDK.

// Copyright (c) Alibaba, Inc. and its affiliates.

import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;

import java.util.ArrayList;
import java.util.List;

public class Ref2Video {

    static {
        // Ini adalah URL untuk wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah. Untuk mendapatkan URL, lihat https://www.alibabacloud.com/help/en/model-studio/wan-video-to-video-api-reference
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: apiKey="sk-xxx"
    // Kunci API berbeda-beda tergantung wilayah. Untuk mendapatkan Kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void syncCall() {
        VideoSynthesis videoSynthesis = new VideoSynthesis();
        final String prompt = "Reference image, gaya film animasi petualangan 3D, karakter chibi dengan tekstur detail, gerakan halus, dan warna cerah. Pertahankan konsistensi karakter dan adegan hutan. Jangan tambahkan teks. Suasana: Petualang, riang, misterius, imajinatif. Karakter: Penjelajah laki-laki: topi bulat, ransel, jubah pendek. Teman: robot kecil terbang berbodi bulat dengan mata bercahaya biru. Adegan: Hutan fantasi dengan akar pohon raksasa, jamur, tanaman merambat, pintu masuk gua harta karun, dan sinar matahari. Storyboard: 1. Wide shot: Pohon tinggi dan sinar cahaya bersilangan di hutan fantasi misterius dan terang. 2. Medium shot: Anak laki-laki mendorong tanaman merambat untuk menjelajah. 3. Medium shot: Robot kecil terbang di sampingnya, memindai ke depan dengan cahaya biru. 4. Close-up: Peta harta karun tua terbuka di tangan anak laki-laki. 5. Close-up: Ia menunjukkan ekspresi bersemangat, matanya berbinar. 6. Action shot: Keduanya melompati akar pohon dan sungai, melanjutkan lebih dalam ke hutan. 7. Medium shot: Peti harta karun berlumut terungkap di balik tanaman merambat. 8. Close-up: Cahaya emas bersinar dari tepi peti harta karun. 9. Final shot: Anak laki-laki dan robot kecil berdiri di depan peti harta karun, saling memandang dengan terkejut, penuh petualangan.";
        List<VideoSynthesisParam.Media> media = new ArrayList<VideoSynthesisParam.Media>(){{
            add(VideoSynthesisParam.Media.builder()
                    .url("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260403/wgjaxy/banana_storyboard_00000020.png")
                    .type("reference_image")
                    .build());
        }};
        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .apiKey(apiKey)
                        .model("wan2.7-r2v-2026-06-12")
                        .prompt(prompt)
                        .media(media)
                        .watermark(true)
                        .duration(10)
                        .resolution("720P")
                        .ratio("16:9")
                        .promptExtend(false)
                        .build();
        VideoSynthesisResult result = null;
        try {
            System.out.println("---sync call, please wait a moment----");
            result = videoSynthesis.call(param);
        } catch (ApiException | NoApiKeyException e){
            throw new RuntimeException(e.getMessage());
        } catch (InputRequiredException e) {
            throw new RuntimeException(e);
        }
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        syncCall();
    }
}

curl

Langkah 1: Buat tugas dan dapatkan ID tugas

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan2.7-r2v-2026-06-12",
    "input": {
        "prompt": "Reference image, gaya film animasi petualangan 3D, karakter chibi dengan tekstur detail, gerakan halus, dan warna cerah. Pertahankan konsistensi karakter dan adegan hutan. Jangan tambahkan teks. Suasana: Petualang, riang, misterius, imajinatif. Karakter: Penjelajah laki-laki: topi bulat, ransel, jubah pendek. Teman: robot kecil terbang berbodi bulat dengan mata bercahaya biru. Adegan: Hutan fantasi dengan akar pohon raksasa, jamur, tanaman merambat, pintu masuk gua harta karun, dan sinar matahari. Storyboard: 1. Wide shot: Pohon tinggi dan sinar cahaya bersilangan di hutan fantasi misterius dan terang. 2. Medium shot: Anak laki-laki mendorong tanaman merambat untuk menjelajah. 3. Medium shot: Robot kecil terbang di sampingnya, memindai ke depan dengan cahaya biru. 4. Close-up: Peta harta karun tua terbuka di tangan anak laki-laki. 5. Close-up: Ia menunjukkan ekspresi bersemangat, matanya berbinar. 6. Action shot: Keduanya melompati akar pohon dan sungai, melanjutkan lebih dalam ke hutan. 7. Medium shot: Peti harta karun berlumut terungkap di balik tanaman merambat. 8. Close-up: Cahaya emas bersinar dari tepi peti harta karun. 9. Final shot: Anak laki-laki dan robot kecil berdiri di depan peti harta karun, saling memandang dengan terkejut, penuh petualangan.",
        "media": [
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260403/wgjaxy/banana_storyboard_00000020.png"
            }
        ]
    },
    "parameters": {
        "resolution": "720P",
        "ratio": "16:9",
        "duration": 10,
        "prompt_extend": false,
        "watermark": true
    }
}'

Langkah 2: Ambil hasil menggunakan ID tugas

Ganti {task_id} dengan nilai task_id yang dikembalikan oleh panggilan API sebelumnya. task_id berlaku untuk kueri selama 24 jam.

curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Referensi multi-entitas dan kustomisasi suara

Model yang didukung: seri wan2.7.

Deskripsi: Anda dapat menginput beberapa gambar dan video referensi sebagai materi entitas. Anda juga dapat menentukan suara unik untuk setiap entitas guna mengaktifkan interaksi multi-karakter dan diferensiasi suara.

Parameter:

media: Array materi referensi.
- media.type: Mendukung reference_image dan reference_video. Jumlah total gambar dan video referensi tidak boleh melebihi 5.
- media.url: URL materi. Gambar juga mendukung string yang dienkripsi Base64.
- media.reference_voice (opsional): URL audio untuk menentukan suara entitas. Gunakan ini bersama reference_image atau reference_video.
  
  Logika audio: Jika reference_video berisi audio dan reference_voice tidak ditentukan, audio video asli digunakan secara default. Jika keduanya disediakan, reference_voice menggantikan audio video asli.
prompt: Rujuk materi referensi dalam prompt sesuai aturan berikut:
- Gunakan pengenal seperti Gambar 1, Gambar 2 untuk aset reference_image dan Video 1, Video 2 untuk aset reference_video.
- Urutan referensi materi ditentukan oleh array media. Gambar dan video dihitung secara terpisah.

Video masukan (Video 1)

Karakter referensi

Gambar input (Gambar 1)

Personas

Gambar input (Gambar 2)

Latar belakang referensi

Video output (multi-shot, dengan audio)

Suara referensi input:

wan-r2v-boy-en

Suara referensi input:

wan-r2v-bg-en

SDK Python

Pastikan SDK Python DashScope Anda menggunakan versi 1.25.16 atau yang lebih baru. Lihat Instal SDK.

# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# Ini adalah URL untuk wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah. Untuk mendapatkan URL, lihat https://www.alibabacloud.com/help/en/model-studio/wan-video-to-video-api-reference
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx"
# Kunci API berbeda-beda tergantung wilayah. Untuk mendapatkan Kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

media = [
    {
        "type": "reference_video",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/pfgcuv/wan-r2v-girl-en.mp4",
        "reference_voice": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/exiikq/wan-r2v-girl-demo-voice-en.mp3"
    },
    {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/skhalj/wan-r2v-boy-en.jpg",
        "reference_voice": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/pqxdoi/wan-r2v-boy-voice-en.mp3"
    },
    {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/vyqjxd/wan-r2v-bg-en.jpg"
    }
]


def sample_sync_call():
    print('----sync call, please wait a moment----')
    rsp = VideoSynthesis.call(
        api_key=api_key,
        model="wan2.7-r2v-2026-06-12",
        media=media,
        resolution="720P",
        ratio="16:9",
        duration=10,
        prompt_extend=False,
        watermark=True,
        prompt="Video 1 masuk dari sisi kiri jauh frame. Lalu shot berpindah ke close-up Gambar 1. Video 1 bersandar pada dinding berkarat di sisi kanan dari Gambar 2. Mendengar langkah kaki, ia perlahan memutar kepalanya. Setelah melihat Gambar 1, Video 1 berkata, \"Mengapa kamu masih datang?\" Gambar 1 menjawab, \"Mari kita bicara.\"",
    )
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('Gagal, status_code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))


if __name__ == '__main__':
    sample_sync_call()

SDK Java

Pastikan SDK Java DashScope Anda menggunakan versi 2.22.14 atau yang lebih baru. Lihat Pemasangan SDK.

// Copyright (c) Alibaba, Inc. and its affiliates.

import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;

import java.util.ArrayList;
import java.util.List;

public class Ref2Video {

    static {
        // Ini adalah URL untuk wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah. Untuk mendapatkan URL, lihat https://www.alibabacloud.com/help/en/model-studio/wan-video-to-video-api-reference
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: apiKey="sk-xxx"
    // Kunci API berbeda-beda tergantung wilayah. Untuk mendapatkan Kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void syncCall() {
        VideoSynthesis videoSynthesis = new VideoSynthesis();
        final String prompt = "Video 1 masuk dari sisi kiri jauh frame. Lalu shot berpindah ke close-up Gambar 1. Video 1 bersandar pada dinding berkarat di sisi kanan dari Gambar 2. Mendengar langkah kaki, ia perlahan memutar kepalanya. Setelah melihat Gambar 1, Video 1 berkata, \"Mengapa kamu masih datang?\" Gambar 1 menjawab, \"Mari kita bicara.\"";
        List<VideoSynthesisParam.Media> media = new ArrayList<VideoSynthesisParam.Media>(){{
            add(VideoSynthesisParam.Media.builder()
                    .url("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/pfgcuv/wan-r2v-girl-en.mp4")
                    .type("reference_video")
                    .referenceVoice("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/exiikq/wan-r2v-girl-demo-voice-en.mp3")
                    .build());
            add(VideoSynthesisParam.Media.builder()
                    .url("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/skhalj/wan-r2v-boy-en.jpg")
                    .type("reference_image")
                    .referenceVoice("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/pqxdoi/wan-r2v-boy-voice-en.mp3")
                    .build());
            add(VideoSynthesisParam.Media.builder()
                    .url("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/vyqjxd/wan-r2v-bg-en.jpg")
                    .type("reference_image")
                    .build());
        }};
        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .apiKey(apiKey)
                        .model("wan2.7-r2v-2026-06-12")
                        .prompt(prompt)
                        .media(media)
                        .watermark(true)
                        .duration(10)
                        .resolution("720P")
                        .ratio("16:9")
                        .promptExtend(false)
                        .build();
        VideoSynthesisResult result = null;
        try {
            System.out.println("---sync call, please wait a moment----");
            result = videoSynthesis.call(param);
        } catch (ApiException | NoApiKeyException e){
            throw new RuntimeException(e.getMessage());
        } catch (InputRequiredException e) {
            throw new RuntimeException(e);
        }
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        syncCall();
    }
}

curl

Langkah 1: Buat tugas dan dapatkan ID tugas

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan2.7-r2v-2026-06-12",
    "input": {
        "prompt": "Video 1 masuk dari sisi kiri jauh frame. Lalu shot berpindah ke close-up Gambar 1. Video 1 bersandar pada dinding berkarat di sisi kanan dari Gambar 2. Mendengar langkah kaki, ia perlahan memutar kepalanya. Setelah melihat Gambar 1, Video 1 berkata, \"Mengapa kamu masih datang?\" Gambar 1 menjawab, \"Mari kita bicara.\" ",
        "media": [
            {
                "type": "reference_video",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/pfgcuv/wan-r2v-girl-en.mp4",
                "reference_voice": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/exiikq/wan-r2v-girl-demo-voice-en.mp3"
            },
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/skhalj/wan-r2v-boy-en.jpg",
                "reference_voice": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/pqxdoi/wan-r2v-boy-voice-en.mp3"
            },
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260416/vyqjxd/wan-r2v-bg-en.jpg"
            }
        ]
    },
    "parameters": {
        "resolution": "720P",
        "ratio": "16:9",
        "duration": 10,
        "prompt_extend": false,
        "watermark": true
    }
}'

Langkah 2: Ambil hasil menggunakan ID tugas

Ganti {task_id} dengan nilai task_id yang dikembalikan oleh panggilan API sebelumnya. task_id berlaku untuk kueri selama 24 jam.

curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Referensi multi-entitas dan kontrol frame pertama

Model yang didukung: seri wan2.7.

Deskripsi: Fitur ini menambahkan kontrol frame pertama ke fitur referensi entitas, sehingga memberi Anda lebih banyak kendali atas pencampuran aliran dan konten video.

Parameter:

media: Array materi referensi.
- media.type: Mendukung first_frame, reference_image, dan reference_video.
  
  Anda dapat menyediakan maksimal satu gambar frame pertama. Anda harus menyediakan minimal satu gambar atau video referensi. Jumlah total gambar dan video referensi tidak boleh melebihi 5.
- media.url: URL materi. Gambar juga mendukung string yang dienkripsi Base64.
prompt: Rujuk materi referensi dalam prompt sesuai aturan berikut:
- Gunakan "Gambar 1, Gambar 2" untuk merujuk aset reference_image dan "Video 1, Video 2" untuk merujuk aset reference_video.
- Urutan referensi materi ditentukan oleh array media. Gambar dan video dihitung secara terpisah.
- Anda tidak perlu merujuk frame pertama dalam prompt.

Prompt input: Shot overhead planet biru. Kamera secara bertahap memperbesar ke close-up Gambar 1 di planet tersebut. Ia memegang Gambar 2 dan memakannya, sambil berkata, "Mengapa tidak ada yang datang bermain denganku?"

Masukkan frame pertama

Frame pertama referensi

Gambar input (Gambar 1)

Entitas referensi

Gambar input (Gambar 2)

Objek referensi

Video output

Video dihasilkan dengan rasio aspek frame pertama

wan2

SDK Python

Pastikan SDK Python DashScope Anda berada pada versi 1.25.16 atau yang lebih baru. Lihat Instal SDK.

# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# Ini adalah URL untuk wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah. Untuk mendapatkan URL, lihat https://www.alibabacloud.com/help/en/model-studio/wan-video-to-video-api-reference
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx"
# Kunci API berbeda-beda tergantung wilayah. Untuk mendapatkan Kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
api_key = os.getenv("DASHSCOPE_API_KEY")

media = [
    {
        "type": "first_frame",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/ixwovg/wan2.7-r2v-first-frame.webp"
    },
    {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/fkltfw/wan2.7-r2v-image-qq.webp"
    },
    {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/kxkbsv/wan2.7-r2v-image-ob.webp"
    }
]


def sample_sync_call():
    print('----sync call, please wait a moment----')
    rsp = VideoSynthesis.call(
        api_key=api_key,
        model="wan2.7-r2v-2026-06-12",
        media=media,
        resolution="720P",
        duration=10,
        prompt_extend=False,
        watermark=True,
        prompt="Shot overhead menangkap planet biru. Kamera secara bertahap memperbesar ke permukaan dan berpindah ke close-up Gambar 1, yang memegang Gambar 2 dan memakannya sambil berkata: Mengapa tidak ada yang datang mengajakku jalan-jalan?",
    )
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('Gagal, status_code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))


if __name__ == '__main__':
    sample_sync_call()

SDK Java

Pastikan SDK Java DashScope yang Anda gunakan adalah versi 2.22.14 atau lebih baru. Lihat Instalasi SDK.

// Copyright (c) Alibaba, Inc. and its affiliates.

import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;

import java.util.ArrayList;
import java.util.List;

public class Ref2Video {

    static {
        // Ini adalah URL untuk wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL berbeda-beda tergantung wilayah. Untuk mendapatkan URL, lihat https://www.alibabacloud.com/help/en/model-studio/wan-video-to-video-api-reference
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: apiKey="sk-xxx"
    // Kunci API berbeda-beda tergantung wilayah. Untuk mendapatkan Kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void syncCall() {
        VideoSynthesis videoSynthesis = new VideoSynthesis();
        final String prompt = "Shot overhead menangkap planet biru. Kamera secara bertahap memperbesar ke permukaan dan berpindah ke close-up Gambar 1, yang memegang Gambar 2 dan memakannya sambil berkata: Mengapa tidak ada yang datang mengajakku jalan-jalan?";
        List<VideoSynthesisParam.Media> media = new ArrayList<VideoSynthesisParam.Media>(){{
            add(VideoSynthesisParam.Media.builder()
                    .url("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/ixwovg/wan2.7-r2v-first-frame.webp")
                    .type("first_frame")
                    .build());
            add(VideoSynthesisParam.Media.builder()
                    .url("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/fkltfw/wan2.7-r2v-image-qq.webp")
                    .type("reference_image")
                    .build());
            add(VideoSynthesisParam.Media.builder()
                    .url("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/kxkbsv/wan2.7-r2v-image-ob.webp")
                    .type("reference_image")
                    .build());
        }};
        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .apiKey(apiKey)
                        .model("wan2.7-r2v-2026-06-12")
                        .prompt(prompt)
                        .media(media)
                        .watermark(true)
                        .duration(10)
                        .resolution("720P")
                        .promptExtend(false)
                        .build();
        VideoSynthesisResult result = null;
        try {
            System.out.println("---sync call, please wait a moment----");
            result = videoSynthesis.call(param);
        } catch (ApiException | NoApiKeyException e){
            throw new RuntimeException(e.getMessage());
        } catch (InputRequiredException e) {
            throw new RuntimeException(e);
        }
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        syncCall();
    }
}

curl

Langkah 1: Buat tugas dan dapatkan ID tugas

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan2.7-r2v-2026-06-12",
    "input": {
        "prompt": "Shot overhead menangkap planet biru. Kamera secara bertahap memperbesar ke permukaan dan berpindah ke close-up Gambar 1, yang memegang Gambar 2 dan memakannya sambil berkata: Mengapa tidak ada yang datang mengajakku jalan-jalan?",
        "media": [
            {
                "type": "first_frame",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/ixwovg/wan2.7-r2v-first-frame.webp"
            },
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/fkltfw/wan2.7-r2v-image-qq.webp"
            },
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260414/kxkbsv/wan2.7-r2v-image-ob.webp"
            }
        ]
    },
    "parameters": {
        "resolution": "720P",
        "duration": 10,
        "prompt_extend": false,
        "watermark": true
    }
}'

Langkah 2: Ambil hasil menggunakan ID tugas

Ganti {task_id} dengan nilai task_id yang dikembalikan oleh panggilan API sebelumnya. task_id berlaku untuk kueri selama 24 jam.

curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Berikan referensi

seri wan2.7

Teruskan gambar, video, dan audio referensi ke array media.

Gambar input

Jumlah frame pertama: Maksimal satu frame pertama (media.type=first_frame) diperbolehkan.
Jumlah gambar referensi: Maksimal lima gambar referensi (media.type=reference_image) diperbolehkan. Jumlah total gambar dan video referensi tidak boleh melebihi 5.
Metode input:
- URL publik: Mendukung protokol HTTP atau HTTPS. Contoh: https://xxxx/xxx.png.
- String yang dienkripsi Base64: Gunakan format data:{MIME_type};base64,{base64_data}, di mana:
  - {base64_data}: String yang dienkripsi Base64 dari file gambar.
  - {MIME_type}: Ekstensi MIME (Multipurpose Internet Mail Extensions) dari gambar. Jenis harus sesuai dengan format file.
    
    Format gambar
    
    Jenis MIME
    
    JPEG
    
    image/jpeg
    
    JPG
    
    image/jpeg
    
    PNG
    
    image/png
    
    BMP
    
    image/bmp
    
    WEBP
    
    image/webp

Video input

Jumlah video referensi: Maksimal lima video referensi (media.type=reference_video) diperbolehkan. Jumlah total gambar dan video referensi tidak boleh melebihi 5.
Metode input:
- URL publik: Mendukung protokol HTTP atau HTTPS. Contoh: https://xxxx/xxx.mp4.

Audio input

Batasan: Suara referensi (media.reference_voice) hanya dapat digunakan dengan reference_image atau reference_video untuk menentukan suara bagi peran entitas yang sesuai.
Metode input:
- URL publik: Mendukung protokol HTTP atau HTTPS. Contoh: https://xxxx/xxx.mp3.

Video output

Jumlah video: 1.
Spesifikasi video: Formatnya MP4. Untuk spesifikasi detail, lihat Model yang didukung.
Periode validitas URL video: 24 jam.
Dimensi video:
- seri wan2.7: Parameter resolution mengontrol tingkat resolusi (720p atau 1080p), dan parameter ratio mengontrol rasio aspek (16:9, 9:16, 1:1, 4:3, atau 3:4).
  - Jika gambar frame pertama disediakan, parameter ratio diabaikan. Rasio aspek video output mendekati rasio aspek gambar frame pertama.
  - Jika gambar frame pertama tidak disediakan, rasio aspek ditentukan oleh parameter ratio. Default-nya 16:9.

Penagihan dan pembatasan laju

Untuk kuota gratis dan harga satuan, lihat Referensi-ke-video Wan.
Untuk pembatasan laju model, lihat Wan.
Rincian penagihan:
- Gambar input tidak dikenai biaya. Video input dan output ditagih berdasarkan durasi dalam detik.
- Panggilan model yang gagal atau kesalahan pemrosesan tidak dikenai biaya atau mengurangi kuota gratis pengguna baru.
Rumus penagihan: Total durasi yang ditagih (detik) = Durasi yang ditagih video input (detik) + Durasi video output (detik).
Model Seri Wan 2.7

Durasi yang ditagih video input: Maksimum 5 detik. Batas pemotongan per video = 5 detik ÷ Jumlah video referensi input (gambar referensi dan gambar frame pertama tidak dihitung). Setiap video ditagih berdasarkan min(durasi aktual, batas pemotongan). Durasi yang ditagih untuk beberapa video dijumlahkan.
- 1 video referensi: Batas pemotongan per video adalah 5 detik.
- 2 video referensi: Batas pemotongan per video adalah 2,5 detik.
- 3 video referensi: Batas pemotongan per video adalah 1,65 detik.
- 4 video referensi: Batas pemotongan per video adalah 1,25 detik.
- 5 video referensi: Batas pemotongan per video adalah 1 detik.
- Contoh: Jika input berupa 2 video referensi + 1 gambar, gambar tidak dihitung. Batas pemotongan dihitung berdasarkan 2 video referensi, yaitu 2,5 detik per video. Durasi input yang ditagih = min(durasi video 1, 2,5 detik) + min(durasi video 2, 2,5 detik).
Durasi yang ditagih video output: Durasi dalam detik dari video yang berhasil dihasilkan oleh model.
Model Seri Wan 2.6

Durasi yang ditagih video input: Maksimum 5 detik. Batas pemotongan per video = 5 detik ÷ Total jumlah materi referensi (gambar referensi + video referensi, tidak termasuk gambar frame pertama). Setiap video ditagih berdasarkan min(durasi aktual, batas pemotongan). Durasi yang ditagih untuk beberapa video dijumlahkan.
- 1 materi referensi: Batas pemotongan per video adalah 5 detik.
- 2 materi referensi: Batas pemotongan per video adalah 2,5 detik.
- 3 materi referensi: Batas pemotongan per video adalah 1,65 detik.
- 4 materi referensi: Batas pemotongan per video adalah 1,25 detik.
- 5 materi referensi: Batas pemotongan per video adalah 1 detik.
Lebih banyak contoh: Menghitung durasi yang ditagih video input
Input: 1 materi referensi (batas pemotongan per video: 5 detik)

Jika input berupa video: Durasi input yang ditagih = min(durasi video, 5 detik).

Jika input berupa gambar: Tidak dikenai biaya.

Input: 2 materi referensi (batas pemotongan per video: 2,5 detik)

Jika input berupa 1 video + 1 gambar: Durasi input yang ditagih = min(durasi video 1, 2,5 detik).

Jika input berupa 2 video: Durasi input yang ditagih = min(durasi video 1, 2,5 detik) + min(durasi video 2, 2,5 detik).

Input: 3 materi referensi (batas pemotongan per video: 1,65 detik)

Jika input berupa 1 video + 2 gambar: Durasi input yang ditagih = min(durasi video 1, 1,65 detik).

Jika input berupa 3 video: Durasi input yang ditagih = min(durasi video 1, 1,65 detik) + min(durasi video 2, 1,65 detik) + min(durasi video 3, 1,65 detik).

Input: 4 materi referensi (batas pemotongan per video: 1,25 detik)

Jika input berupa 2 video + 2 gambar: Durasi input yang ditagih = min(durasi video 1, 1,25 detik) + min(durasi video 2, 1,25 detik).

Jika input berupa 3 video + 1 gambar: Durasi input yang ditagih = min(durasi video 1, 1,25 detik) + min(durasi video 2, 1,25 detik) + min(durasi video 3, 1,25 detik).

Input: 5 materi referensi (batas pemotongan per video: 1 detik)

Jika input berupa 1 video + 4 gambar: Durasi input yang ditagih = min(durasi video 1, 1 detik).

Jika input berupa 3 video + 2 gambar: Durasi input yang ditagih = min(durasi video 1, 1 detik) + min(durasi video 2, 1 detik) + min(durasi video 3, 1 detik).
Durasi yang ditagih video output: Durasi dalam detik dari video yang berhasil dihasilkan oleh model.

Referensi API

Referensi API referensi-ke-video

FAQ

T: Bagaimana cara merujuk materi dalam prompt?

J: Metode referensi tergantung pada model dan fitur yang digunakan:

seri wan2.7

Gambar referensi diidentifikasi sebagai Gambar 1, Gambar 2, dan seterusnya. Video referensi diidentifikasi dengan cara serupa. Untuk prompt bahasa Inggris, gunakan pengenal seperti Image 1 dan Video 1.
Gambar dan video dihitung secara terpisah. Urutannya sesuai dengan urutan materi jenis yang sama dalam array media.
Jika Anda hanya memiliki satu gambar atau video referensi, Anda dapat menyederhanakan pengenal menjadi "reference image" atau "reference video".
Umumnya, Anda tidak perlu merujuk gambar frame pertama dalam prompt.

{
    "input": {
        "prompt": "Video 1 sedang bermain gitar, dan Gambar 1 memegang seikat bunga dan berjalan melewati Video 1.",
        "media": [
            {
                "type": "first_frame",
                "url":  "https://example.com/scene.jpg"
            },
            {
                "type": "reference_video",
                "url":  "https://example.com/girl.mp4"           // Video 1
            },
            {
                "type": "reference_image",
                "url": "https://example.com/boy.png"             // Gambar 1
            }
        ]
    }
}

T: Apakah reference_voice dapat digunakan dengan gambar frame pertama?

J: Hal ini tidak disarankan. Gunakan media.reference_voice dengan reference_image atau reference_video untuk menentukan timbre bagi entitas yang sesuai.

Format gambar	Jenis MIME
JPEG	image/jpeg
JPG	image/jpeg
PNG	image/png
BMP	image/bmp
WEBP	image/webp

Mulai

SDK Python

SDK Java

curl

Ketersediaan

Kemampuan inti (wan2.7)

Referensi gambar tunggal (gambar multi-panel)

SDK Python

SDK Java

curl

Referensi multi-entitas dan kustomisasi suara

SDK Python

SDK Java

curl

Referensi multi-entitas dan kontrol frame pertama

SDK Python

SDK Java

curl

Berikan referensi

seri wan2.7

Gambar input

Video input

Audio input

Video output

Penagihan dan pembatasan laju

Model Seri Wan 2.7

Model Seri Wan 2.6

Referensi API

FAQ

T: Bagaimana cara merujuk materi dalam prompt?

seri wan2.7

T: Apakah reference_voice dapat digunakan dengan gambar frame pertama?