Skip to main content

Image-to-video: frame pertama dan terakhir

Model image-to-video Wan menghasilkan video yang mulus dari gambar frame pertama, gambar frame terakhir, dan prompt teks opsional.

  • Spesifikasi video: Durasi tetap 5 detik dan resolusi kustom (480P/720P/1080P).
  • Kemampuan tambahan: Penulisan ulang prompt dan Watermark.
Tautan cepat: Referensi API | Panduan prompt

Mulai

PromptFrame pertamaFrame terakhirVideo output
A cute blue monster with a slightly sad expression stands in the rain. The camera slowly zooms in and stops on the moment it looks up at the sky.
image
image
Sebelum memanggil API: Dapatkan Kunci API, tetapkan sebagai Variabel lingkungan, dan instal SDK DashScope.
  • Python SDK
  • Java SDK
  • curl
Memerlukan SDK Python DashScope ≥ 1.25.8. Versi lama mungkin menampilkan error "url error, please check url!". Instal SDK.
import os
import dashscope
from dashscope.v2 import DashScopeError

# Berikut adalah konfigurasi untuk wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. Nilai region berbeda-beda untuk setiap wilayah. Untuk titik akhir setiap wilayah, lihat https://www.alibabacloud.com/help/model-studio/image-to-video-by-first-and-last-frame-api-reference
# Kunci API berbeda per wilayah. Dapatkan Kunci API Anda: https://www.alibabacloud.com/help/en/model-studio/get-api-key
client = dashscope.Client(
    api_key=os.getenv("DASHSCOPE_API_KEY", "YOUR_API_KEY"),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

print('please wait...')
# generate adalah panggilan satu langkah (kirim tugas dan tunggu hingga selesai) serta mengembalikan Job yang telah selesai
# first_frame_url / last_frame_url adalah bidang bagian input yang tidak termasuk dalam signature bernama, diteruskan melalui extra_input
try:
    job = client.videos.generate(model="wan2.2-kf2v-flash",
                                 prompt="A cute blue monster with a slightly sad expression stands in the rain. The camera slowly zooms in and stops on the moment it looks up at the sky.",
                                 extra_input={'first_frame_url': "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260126/ixdxvt/wan-kf2v-blue-1.png",
                                              'last_frame_url': "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260126/nhtdrc/wan-kf2v-blue-2.png"},
                                 duration=5,  # Tetap 5 detik. Jangan ubah.
                                 prompt_extend=True,
                                 watermark=True)
    print(job)
    print("video_url:", job.video_url)
except DashScopeError as e:
    print(f"HTTP status code: {e.status_code}")
    print(f"Error code: {e.code}")
    print(f"Error message: {e.message}")
    print("See the documentation: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")
Contoh output
video_url kedaluwarsa setelah 24 jam. Unduh video tersebut segera.
{
    "request_id": "c1209113-8437-424f-a386-xxxxxx",
    "output": {
        "task_id": "966cebcd-dedc-4962-af88-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx",
         ...
    },
    ...
}

Ketersediaan

  • Model yang didukung berbeda-beda per wilayah. Sumber daya terisolasi antar wilayah. Untuk model yang didukung di setiap wilayah, lihat Konsol Model Studio.
  • Saat melakukan pemanggilan, pastikan model, URL titik akhir, dan Kunci API Anda semuanya berasal dari wilayah yang sama. Pemanggilan lintas-wilayah akan gagal.
Kode contoh dalam topik ini berlaku untuk wilayah Singapura.

Kemampuan inti

Hasilkan video dari frame pertama dan terakhir

Model yang didukung: Semua model. Menghasilkan video yang mulus dari gambar frame pertama dan frame terakhir. Parameter:
  • first_frame_url: Wajib. Berikan gambar frame pertama.
  • last_frame_url: Wajib. Berikan gambar frame terakhir.
  • prompt: Opsional (disarankan). Mengontrol bagaimana video berubah seiring waktu.
PromptFrame pertamaFrame terakhirVideo keluaran
Realistic style. A curious black kitten looks up at the sky. The camera starts at eye level and gradually rises until it captures the kitten’s curious gaze from above.
首帧图像
尾帧图像
  • Python SDK
  • Java SDK
  • curl
Memerlukan SDK Python DashScope ≥ 1.25.8. Tingkatkan jika diperlukan.
import os
import dashscope
from dashscope.v2 import DashScopeError

# Berikut adalah konfigurasi untuk wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. Nilai region berbeda-beda untuk setiap wilayah. Untuk titik akhir setiap wilayah, lihat https://www.alibabacloud.com/help/model-studio/image-to-video-by-first-and-last-frame-api-reference
# Kunci API berbeda per wilayah. Dapatkan Kunci API Anda: https://www.alibabacloud.com/help/model-studio/get-api-key
client = dashscope.Client(
    api_key=os.getenv("DASHSCOPE_API_KEY", "YOUR_API_KEY"),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

def sample_async_call_kf2v():
    # Panggilan asinkron, yang mengembalikan task_id
    # first_frame_url / last_frame_url adalah bidang bagian input yang tidak termasuk dalam signature bernama, diteruskan melalui extra_input
    try:
        job = client.videos.jobs.create(model="wan2.2-kf2v-flash",
                                        prompt="Realistic style. A curious black kitten looks up at the sky. The camera starts at eye level and gradually rises until it captures the kitten’s curious gaze from above.",
                                        extra_input={'first_frame_url': "https://wanx.alicdn.com/material/20250318/first_frame.png",
                                                     'last_frame_url': "https://wanx.alicdn.com/material/20250318/last_frame.png"},
                                        duration=5,  # Tetap 5 detik. Jangan ubah.
                                        prompt_extend=True,
                                        watermark=True)
        print(job)
        print("task_id: %s" % job.task_id)
    except DashScopeError as e:
        print(f"HTTP status code: {e.status_code}")
        print(f"Error code: {e.code}")
        print(f"Error message: {e.message}")
        print("See the documentation: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")
        return

    # Tunggu hingga tugas asinkron selesai (polling dengan exponential backoff, total anggaran default 24 jam)
    try:
        done = client.videos.jobs.wait(job)
        print(done)
        print(done.video_url)
    except DashScopeError as e:
        print(f"HTTP status code: {e.status_code}")
        print(f"Error code: {e.code}")
        print(f"Error message: {e.message}")
        print("See the documentation: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")

if __name__ == '__main__':
    sample_async_call_kf2v()

Gambar input

  • Jumlah gambar: Satu gambar frame pertama dan satu gambar frame terakhir.
  • Metode input: URL gambar, jalur file lokal.

Metode 1: URL gambar (HTTP API dan SDK) Direkomendasikan

Persyaratan jalur berbeda-beda per bahasa:Python SDK: Mendukung jalur absolut dan relatif.

Sistem operasi

Input File Path

Contoh (jalur absolut)

Contoh (jalur relatif)

Linux / macOS

file://{jalur absolut atau relatif}

file:///home/images/test.png

file://./images/test.png

Windows

file://D:/images/test.png

file://./images/test.png

Java SDK: Hanya mendukung jalur absolut.

Sistem operasi

Input file path

Contoh (jalur absolut)

Linux / macOS

file://{jalur absolut}

file:///home/images/test.png

Windows

file:///{jalur absolut}

file:///D:/images/test.png

Kode contoh: Beberapa metode input gambar

Python SDK
import os
import dashscope
from dashscope.v2 import DashScopeError

# Berikut adalah konfigurasi untuk wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. Nilai region berbeda-beda untuk setiap wilayah.
client = dashscope.Client(
    # Jika variabel lingkungan tidak dikonfigurasi, ganti baris berikut dengan Kunci API Studio Model Anda: api_key="sk-xxx"
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

# ========== Metode input gambar (pilih salah satu) ==========
# [Metode 1] Gunakan URL gambar publik
first_frame_url = "https://wanx.alicdn.com/material/20250318/first_frame.png"
last_frame_url = "https://wanx.alicdn.com/material/20250318/last_frame.png"

# [Metode 2] Gunakan jalur file lokal (file:// + jalur file)
# Gunakan jalur absolut:
# first_frame_url = "file://" + "/path/to/your/first_frame.png"  # Linux/macOS
# last_frame_url = "file://" + "C:/path/to/your/last_frame.png"  # Windows
# Atau gunakan jalur relatif:
# first_frame_url = "file://" + "./first_frame.png"              # Gunakan jalur aktual Anda.
# last_frame_url = "file://" + "./last_frame.png"                # Gunakan jalur aktual Anda.

def sample_sync_call_kf2v():
    print('please wait...')
    # generate adalah panggilan satu langkah (kirim tugas dan tunggu hingga selesai) serta mengembalikan Job yang telah selesai
    # first_frame_url / last_frame_url adalah bidang bagian input yang tidak termasuk dalam signature bernama, diteruskan melalui extra_input
    try:
        job = client.videos.generate(model="wan2.2-kf2v-flash",
                                     prompt="Realistic style, a small black cat looks up at the sky curiously, the camera gradually rises from eye level, and finally captures its curious gaze from a top-down view.",
                                     extra_input={'first_frame_url': first_frame_url,
                                                  'last_frame_url': last_frame_url},
                                     resolution="720P",
                                     prompt_extend=True)
        print(job)
        print(job.video_url)
    except DashScopeError as e:
        print(f"HTTP status code: {e.status_code}")
        print(f"Error code: {e.code}")
        print(f"Error message: {e.message}")
        print("See the documentation: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")

if __name__ == '__main__':
    sample_sync_call_kf2v()

Video output

  • Jumlah video: Satu.
  • Spesifikasi: Spesifikasi berbeda-beda per model. Lihat Spesifikasi video.
  • Kedaluwarsa URL: 24 jam.
  • Dimensi: Ditentukan oleh gambar frame pertama dan pengaturan resolution.
    • Model mempertahankan rasio aspek frame pertama dan menskalakan jumlah piksel total ke target. Dimensi output disesuaikan secara otomatis agar dapat dibagi 16 (persyaratan encoding).
    • Contoh: Input 750×1000 (3:4) dengan resolution="720P" (target ≈920K piksel) mungkin menghasilkan output 816×1104 (rasio ≈0,739, ≈900K piksel, keduanya dapat dibagi 16).

Penagihan dan Pembatasan laju

  • Untuk detail kuota gratis dan harga, lihat Wanx-Image-to-Video-First-Last-Frame.
  • Untuk Pembatasan laju model, lihat seri Wanxiang.
  • Detail penagihan:
    • Input gratis. Penagihan output berdasarkan detik video yang berhasil dihasilkan.
    • Pemanggilan yang gagal tidak dikenai biaya dan tidak mengurangi kuota gratis.
    • Image-to-video juga mendukung rencana penghematan.

Referensi API

Image-to-video - frame pertama dan terakhir - Referensi API

FAQ

T: Bagaimana cara menghasilkan video dengan rasio aspek tertentu (seperti 3:4)?

J: API tidak mendukung kontrol rasio aspek langsung — hanya resolution. Parameter resolution mengontrol jumlah piksel, bukan rasio aspek. Model mempertahankan rasio aspek frame pertama (first_frame_url) dengan penyesuaian minor untuk encoding (dimensi harus kelipatan 16). Untuk video 3:4, unggah gambar frame pertama dengan rasio 3:4.
Contoh: Input 750×1000 (3:4) dengan resolution="720P" (target ≈920K piksel) mungkin menghasilkan output 816×1104 (rasio ≈0,739, ≈900K piksel, keduanya dapat dibagi 16).

T: Mengapa saya mendapatkan error “url error, please check url!” saat menjalankan kode SDK?

J: Pastikan versi SDK Anda memenuhi persyaratan minimum: SDK Python DashScope ≥ 1.25.8 atau SDK Java DashScope ≥ 2.22.6. Versi lama mungkin menampilkan error "url error, please check url!". Tingkatkan SDK.