MiniMax-M3.1-Flash and DeepSeek-V4.1-Flash-1017 are now live on CometAPI →
guide/Riset CometAPI

Cara Menggunakan API Wan 2.7: Panduan Lengkap untuk Pengembang

Pelajari cara menggunakan API Wan 2.7 melalui CometAPI untuk pembuatan teks-ke-video dan gambar-ke-video, dengan contoh, harga, perbandingan, dan praktik terbaik.

CometAPI
Mia MarenTim riset model AI dan API
Diperbarui Sep 3, 2026 19 menit baca
Cara Menggunakan API Wan 2.7: Panduan Lengkap untuk Pengembang
Gunakan pola ini

Lakukan API call pertama.

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_COMETAPI_KEY",
    base_url="https://api.cometapi.com/v1",
)

response = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[{"role": "user", "content": "Build this workflow."}],
)

print(response.choices[0].message.content)

Jawaban Singkat

Wan 2.7 adalah suite multimodal pembuatan video milik Alibaba untuk alur kerja teks-ke-video, gambar-ke-video, generasi berbasis referensi, dan pengeditan. Melalui Wan 2.7 di CometAPI, pengembang menggunakan model ID wan2.7 dengan endpoint asynchronous POST /v1/videos. Integrasi mencakup tiga tahap operasional: mengajukan tugas, melakukan polling terhadap video ID yang dikembalikan, dan mengunduh MP4 setelah selesai. Route live mendukung keluaran 720p dan 1080p serta mencantumkan harga per detik, sehingga durasi dan resolusi menentukan estimasi biaya pembuatan. Mulailah dengan permintaan teks-ke-video 5 detik 720p, validasi alur kerja, lalu tambahkan referensi gambar atau resolusi lebih tinggi hanya setelah rute dasar berjalan.

Penting: Panduan ini mencakup Wan 2.7 Video melalui CometAPI. Ini tidak menjelaskan model pembuatan gambar Wan yang terpisah, sehingga spesifikasi khusus gambar seperti output still-image 4K tidak dianggap sebagai kapabilitas Wan 2.7 Video.

Poin Penting

  • CometAPI mengekspos Wan 2.7 melalui endpoint video asynchronous bergaya OpenAI, bukan respons chat synchronous.
  • Route menggunakan model ID wan2.7 dan POST /v1/videos.
  • Integrasi lengkap harus menyimpan video ID yang dikembalikan, melakukan polling ke endpoint status, menangani kegagalan terminal, dan mengunduh MP4 hanya setelah sukses.
  • API native Wan 2.7 teks-ke-video Alibaba mendukung 720P dan 1080P dengan durasi 2–15 detik; route CometAPI menggunakan nama field tersendiri.
  • Alur kerja gambar-ke-video, frame pertama/terakhir, dan kelanjutan ada di keluarga model native Alibaba, namun field lanjutan yang tersedia melalui route terpadu harus diverifikasi terhadap dokumentasi route live.
  • Bukti benchmark publik paling kuat untuk video-ke-video: Wan 2.7 menempati posisi teratas kategori Design Arena. Hasil itu tidak boleh digeneralisasi untuk setiap tugas teks-ke-video atau gambar-ke-video.
  • Metrik produksi paling berguna adalah biaya per klip yang diterima, bukan hanya harga per detik yang dihasilkan.

Apa itu Wan 2.7?

Penjelasan Wan 2.7 untuk Pengembang

Wan 2.7 bukan sekadar checkpoint prompt-ke-video. Alibaba menggambarkan keluarga video empat bagian yang mencakup Wan2.7-t2v, Wan2.7-i2v, Wan2.7-r2v dan Wan2.7-videoedit. Bersama-sama, varian tersebut mencakup generasi dari teks, animasi dari gambar, kontrol subjek atau gaya berbasis referensi, dan transformasi video yang ada. Ini penting untuk desain aplikasi: klip pemasaran sederhana mungkin hanya menggunakan teks-ke-video, sementara pipeline produksi yang konsisten karakter mungkin membutuhkan input referensi, frame jangkar, panduan audio, dan pengeditan iteratif.

Di CometAPI, route sengaja menyederhanakan penamaan spesifik penyedia menjadi model ID pelanggan wan2.7. Kapabilitas generasi yang mendasarinya tetap Wan 2.7, tetapi autentikasi, path endpoint, dan nama parameter berbeda dari API native Alibaba Cloud.

Spesifikasi Teknis Wan 2.7

SpesifikasiWan 2.7 Video
PenyediaAlibaba / Wan
CometAPI model IDwan2.7
ID native teks-ke-videowan2.7-t2v, wan2.7-t2v-2026-06-12
ID native gambar-ke-videowan2.7-i2v-2026-04-25
Input utamaTeks; gambar, audio atau video dalam alur kerja yang didukung
Output utamaVideo yang dihasilkan dengan perilaku audio yang didukung
ModeT2V, I2V, R2V, pengeditan video, frame pertama/terakhir, lanjutan
Resolusi720P dan 1080P
Durasi T2V2–15 detik; default 5 detik
Rasio aspek T2V16:9, 9:16, 1:1, 4:3, 3:4
Batas prompt5.000 karakter untuk T2V Wan 2.7 native
Batas negative prompt500 karakter
Format dan batas audioWAV/MP3; 2–30 detik; hingga 15 MB
InvocationAsynchronous
Arsitektur / jumlah parameterTidak dikonfirmasi secara komprehensif dalam dokumentasi resmi

Batas spesifikasi: Beberapa halaman katalog mendeskripsikan arsitektur atau jumlah parameter, tetapi dokumentasi API video resmi Alibaba tidak mempublikasikan spesifikasi arsitektur lengkap untuk setiap varian Wan 2.7. Perumusan editorial yang lebih aman adalah bahwa jumlah parameter dan arsitektur lengkap tidak diungkapkan secara komprehensif.

Apa yang Dapat Dilakukan Wan 2.7?

Teks-ke-video dengan prompt multi-shot bertiming.

Wan 2.7 dapat menafsirkan perubahan shot yang ditulis langsung ke dalam prompt. Pengembang dapat menggambarkan Shot 1, Shot 2, dan Shot 3 dengan rentang waktu alih-alih bergantung pada field kontrol shot terpisah. Ini membuat prompt menjadi storyboard yang ringkas.

Kontrol frame pertama dan terakhir.

Alur kerja gambar-ke-video native menerima media frame pertama dan frame terakhir sehingga model dapat menyintesis gerakan antara dua jangkar visual. Ini berguna untuk transisi produk, perubahan pose, dan morphing adegan.

Kelanjutan video.

Input native bertipe first_clip mengkondisikan bagian video berikutnya. Dalam alur kerja ini, durasi harus ditafsirkan sesuai aturan tugas penyedia, sehingga aplikasi tidak boleh berasumsi bahwa durasi selalu berarti hanya segmen yang baru dihasilkan.

Generasi dipandu audio.

Alibaba mendokumentasikan audio sebagai sumber pemandu timing dan perilaku lip-sync. Tanpa aset audio yang diunggah, model dapat menghasilkan musik latar atau efek suara yang cocok. Audio yang lebih panjang dari video yang diminta akan dipangkas; audio yang lebih pendek membuat sisa video tanpa suara.

Perpanjangan prompt, negative prompt, dan watermarking.

API native mendukung penulisan ulang prompt, negative prompt, dan opsi watermark buatan AI. Kontrol ini membantu tim menstandarkan kualitas prompt dan perilaku provenance, meskipun field CometAPI terpadu mungkin tidak dipetakan satu per satu.

Apa Kata Benchmark Publik Tentang Wan 2.7?

Model video tidak memiliki satu benchmark yang diterima secara universal setara dengan skor MMLU atau SWE-bench milik LLM. Untuk Wan 2.7, sinyal eksternal paling jelas yang dipublikasikan adalah bahwa model ini menempati peringkat pertama kategori video-to-video di Design Arena. Gambar peringkat publikasi resmi menunjukkan Wan 2.7 pada Elo 1335 di snapshot tersebut. Ini mendukung klaim preferensi transformasi dan pengeditan video; ini tidak membuktikan kepemimpinan universal dalam teks-ke-video, gambar-ke-video, kualitas audio, atau latensi.

BuktiHasil publikCara menginterpretasikannya
Design Arena video-to-videoPeringkat pertama; Elo 1335 di gambarBukti kuat untuk preferensi V2V
Spesifikasi API resmi720P/1080P; 2–15 detik untuk T2VFleksibilitas produksi, bukan peringkat
Skor T2V terstandarTidak diungkapkan publikGunakan uji A/B internal
Skor I2V terstandarTidak diungkapkan publikGunakan uji A/B internal
Benchmark latensi atau success-rateTidak distandardisasi publikUkur pada route yang dipilih

Kesimpulan Benchmark

  • Gunakan hasil Design Arena sebagai bukti daya saing video-to-video, bukan klaim menyeluruh di setiap mode.
  • Jangan menggunakan ulang angka benchmark Wan 2.1 sebagai hasil Wan 2.7.
  • Untuk seleksi produksi, uji prompt, aset sumber, resolusi, durasi, dan kondisi audio yang sama di berbagai model.
  • Lacak tingkat penerimaan oleh manusia, stabilitas gerakan, pelestarian identitas, latensi, tingkat kegagalan, dan biaya per klip yang diterima.

Mengapa Menggunakan Wan 2.7 melalui CometAPI?

API Video Terpadu

CometAPI mengekspos model melalui siklus hidup video asynchronous yang umum. Halaman model Wan 2.7 saat ini mempublikasikan model ID pelanggan, harga route, dan pola create-poll-download yang berfungsi. Ini mengurangi jumlah kode integrasi spesifik penyedia saat suatu produk perlu menguji atau merutekan antara beberapa model video.

POST /v1/videos GET  /v1/videos/{video_id} GET  /v1/videos/{video_id}/content

Cara Menggunakan API Wan 2.7: Panduan Lengkap untuk Pengembang

Lifecycle create-poll-download CometAPI untuk pembuatan video asynchronous. Sumber endpoint: Dokumentasi API CometAPI**.

  • Satu API key untuk beberapa model video yang didukung.
  • Pola konsisten untuk pembuatan tugas, pengambilan status, dan pengunduhan file.
  • Visibilitas penggunaan dan penagihan terpusat.
  • Lebih sedikit kode aplikasi yang terikat pada autentikasi dan skema respons satu penyedia.
  • A/B testing lebih cepat karena pemilihan model dapat diubah tanpa mengganti seluruh siklus tugas.

Catatan Kompatibilitas yang Diperlukan

Kompatibilitas route: Skema /v1/videos terpadu CometAPI tidak selalu mengekspos setiap field dalam API T2V, I2V, R2V, dan pengeditan video native Alibaba Cloud. Teks-ke-video dan gambar-ke-video dasar adalah titik awal teraman. Sebelum mengirimkan kontrol frame pertama/terakhir, input multi-referensi, pemanduan audio, atau pengeditan video, verifikasi field route live dan batas media yang tepat.

Persiapan Sebelum Memulai

Buat Akun CometAPI dan API Key

Buat atau masuk ke akun CometAPI, lalu buat API key. Simpan di variabel lingkungan. Jangan hard-code key di source control, kode browser, atau aplikasi mobile.

export COMETAPI_KEY="your_api_key"$env:COMETAPI_KEY="your_api_key"

Ketahui Model ID dan Endpoint

Model ID: wan2.7 Create endpoint: POST https://api.cometapi.com/v1/videos Status endpoint: GET https://api.cometapi.com/v1/videos/{video_id} Download endpoint: GET https://api.cometapi.com/v1/videos/{video_id}/content

Instal Paket Python

python -m pip install --upgrade requests

Contoh menggunakan permintaan HTTP mentah karena multipart form data, polling status, dan unduhan biner lebih mudah dipahami tanpa abstraksi SDK tambahan.

Cara Menggunakan API Wan 2.7 dengan CometAPI

Langkah 1: Buat Tugas Teks-ke-Video

Kirim permintaan multipart dengan model, prompt, durasi, dan ukuran. Contoh 5 detik 720p ini adalah cara paling minim risiko untuk memvalidasi kredensial, routing, dan pembuatan tugas.

curl https://api.cometapi.com/v1/videos \  -H "Authorization: Bearer $COMETAPI_KEY" \  -F "model=wan2.7" \  -F "prompt=A cinematic tracking shot of a futuristic train crossing a snowy mountain valley at sunrise, smooth camera motion, realistic light." \  -F "seconds=5" \  -F "size=1280x720"The response should include a task identifier under id or task_id. Log the full response during integration because providers and route versions may wrap status data differently.{  "id": "video_task_id",  "status": "queued",  "progress": 0 }

Langkah 2: Polling Status Video

Gunakan ID yang dikembalikan di endpoint status. Polling setiap 10–15 detik umumnya lebih tepat daripada loop ketat untuk tugas video yang intensif komputasi.

curl https://api.cometapi.com/v1/videos/{video_id} \  -H "Authorization: Bearer $COMETAPI_KEY"{  "id": "video_task_id",  "status": "in_progress",  "progress": 45 }

Aplikasi Anda harus memperlakukan completed atau success sebagai status terminal sukses dan failed, error, atau FAILURE sebagai status terminal gagal. Simpan payload kegagalan lengkap untuk diagnosis.

Langkah 3: Unduh MP4 yang Selesai

Unduh hanya setelah tugas mencapai status terminal yang sukses. Menyimpan respons dari tugas yang belum selesai dapat membuat file kosong atau dokumen error dengan ekstensi MP4.

curl https://api.cometapi.com/v1/videos/{video_id}/content \  -H "Authorization: Bearer $COMETAPI_KEY" \  --output wan2_7_output.mp4

Langkah 4: Hasilkan Video dari Gambar

Untuk gambar-ke-video, unggah referensi sebagai multipart form data dan gunakan prompt yang menggambarkan pergerakan, perilaku kamera, dan perubahan temporal yang diinginkan. Route terpadu umumnya menggunakan input_reference. Konfirmasikan aturan ukuran file, format, dan jumlah gambar saat ini sebelum produksi.

curl https://api.cometapi.com/v1/videos \  -H "Authorization: Bearer $COMETAPI_KEY" \  -F "model=wan2.7" \  -F "prompt=The camera slowly pushes forward while the subject turns toward the warm window light; preserve identity, clothing and background composition." \  -F "input_reference=@reference.png" \  -F "seconds=5" \  -F "size=1280x720"

Tip prompt gambar: Jangan menghabiskan sebagian besar prompt untuk mendeskripsikan ulang konten statis yang sudah terlihat dalam referensi. Gunakan anggaran prompt untuk gerakan, arah kamera, timing, perubahan, dan batasan.

Langkah 5: Bangun Alur Kerja Python Lengkap

Program berikut memvalidasi API key, mengajukan tugas, menormalisasi respons status terbungkus, menerapkan waktu tunggu maksimum, menangani kegagalan terminal, dan mengunduh file yang selesai.

import os import time from pathlib import Path​ import requests​ API_KEY = os.environ.get("COMETAPI_KEY") BASE_URL = "https://api.cometapi.com/v1" POLL_INTERVAL = 12 MAX_WAIT_SECONDS = 900​ if not API_KEY:    raise RuntimeError("Set COMETAPI_KEY before running this script.")​ headers = {"Authorization": f"Bearer {API_KEY}"}​ def parse_task_data(payload):    return payload.get("data") or payload​ # 1. Submit the generation task. submit = requests.post(    f"{BASE_URL}/videos",    headers=headers,    files={        "model": (None, "wan2.7"),        "prompt": (            None,            "A cinematic tracking shot of a futuristic train "            "crossing a snowy mountain valley at sunrise."        ),        "seconds": (None, "5"),        "size": (None, "1280x720"),    },    timeout=60, ) submit.raise_for_status() submit_payload = submit.json() video_id = submit_payload.get("id") or submit_payload.get("task_id")​ if not video_id:    raise RuntimeError(f"No video ID in response: {submit_payload}")​ print(f"Created video task: {video_id}")​ # 2. Poll until a terminal state or timeout. deadline = time.monotonic() + MAX_WAIT_SECONDS while time.monotonic() < deadline:    response = requests.get(        f"{BASE_URL}/videos/{video_id}",        headers=headers,        timeout=30,    )    response.raise_for_status()    payload = response.json()    data = parse_task_data(payload)    status = str(data.get("status", "unknown"))    progress = data.get("progress", "unknown")    print(f"status={status}, progress={progress}")​    if status in {"completed", "success"} or progress in {100, "100", "100%"}:        break    if status in {"failed", "error", "FAILURE"}:        raise RuntimeError(f"Video generation failed: {payload}")​    time.sleep(POLL_INTERVAL) else:    raise TimeoutError(f"Task {video_id} exceeded {MAX_WAIT_SECONDS}s")​ # 3. Download the completed MP4. video = requests.get(    f"{BASE_URL}/videos/{video_id}/content",    headers=headers,    timeout=180, ) video.raise_for_status()​ output = Path("output") / f"{video_id}.mp4" output.parent.mkdir(parents=True, exist_ok=True) output.write_bytes(video.content)​ if output.stat().st_size == 0:    raise RuntimeError("Downloaded file is empty.")​ print(f"Saved {output} ({output.stat().st_size} bytes)")

Langkah 6: Panggil Wan 2.7 dengan JavaScript

Contoh Node.js berikut menggunakan fetch dan FormData bawaan. Gunakan Node.js 18 atau lebih baru; contoh menulis hasil dengan node:fs/promises.

import { mkdir, writeFile } from "node:fs/promises";​ const apiKey = process.env.COMETAPI_KEY; const baseUrl = "https://api.cometapi.com/v1"; const pollIntervalMs = 12_000; const maxWaitMs = 15 * 60 * 1000;​ if (!apiKey) throw new Error("Set COMETAPI_KEY first.");​ const headers = { Authorization: `Bearer ${apiKey}` }; const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));​ const form = new FormData(); form.append("model", "wan2.7"); form.append(  "prompt",  "A cinematic tracking shot of a futuristic train crossing " +    "a snowy mountain valley at sunrise." ); form.append("seconds", "5"); form.append("size", "1280x720");​ const submitResponse = await fetch(`${baseUrl}/videos`, {  method: "POST",  headers,  body: form, }); if (!submitResponse.ok) throw new Error(await submitResponse.text());​ const submitPayload = await submitResponse.json(); const videoId = submitPayload.id || submitPayload.task_id; if (!videoId) throw new Error(`No video ID: ${JSON.stringify(submitPayload)}`);​ const deadline = Date.now() + maxWaitMs; while (Date.now() < deadline) {  const statusResponse = await fetch(`${baseUrl}/videos/${videoId}`, { headers });  if (!statusResponse.ok) throw new Error(await statusResponse.text());​  const payload = await statusResponse.json();  const data = payload.data || payload;  const status = String(data.status || "unknown");  const progress = data.progress ?? "unknown";  console.log({ status, progress });​  if (["completed", "success"].includes(status) || [100, "100", "100%"].includes(progress)) {    break;  }  if (["failed", "error", "FAILURE"].includes(status)) {    throw new Error(`Generation failed: ${JSON.stringify(payload)}`);  }  await sleep(pollIntervalMs); }​ if (Date.now() >= deadline) throw new Error(`Task ${videoId} timed out.`);​ const videoResponse = await fetch(`${baseUrl}/videos/${videoId}/content`, { headers }); if (!videoResponse.ok) throw new Error(await videoResponse.text());​ await mkdir("output", { recursive: true }); const outputPath = `output/${videoId}.mp4`; await writeFile(outputPath, Buffer.from(await videoResponse.arrayBuffer())); console.log(`Saved ${outputPath}`);

Parameter API Wan 2.7

ParameterTipeWajibContohTujuan
modelstringYawan2.7Memilih route
promptstringYaScene descriptionMendefinisikan konten, gerakan, gaya
secondsintegerTidak5Mengontrol durasi dan biaya
sizestringTidak1280x720Mengontrol resolusi / rasio aspek
input_referencefileI2Vreference.pngMemberikan gambar sumber
AuthorizationheaderYaBearer tokenMengautentikasi permintaan

Pemetaan Parameter CometAPI dan Native Alibaba

KonsepCometAPIAPI native Alibaba
Modelwan2.7wan2.7-t2v atau wan2.7-i2v-*
Durasisecondsduration
Resolusisizeresolution plus ratio
Gambar referensiinput_referencemedia[].type=first_frame
Identitas tugasid atau task_idoutput.task_id
Status tugasGET /v1/videos/{id}Endpoint query tugas penyedia
Hasil binerGET /v1/videos/{id}/contentURL hasil sementara / respons penyedia

Pemetaan ini menjelaskan mengapa contoh yang disalin dari Alibaba Cloud tidak dapat ditempel begitu saja ke CometAPI. Kapabilitas model terkait, tetapi lapisan akses dan skema berbeda.

Cara Menulis Prompt Wan 2.7 yang Lebih Baik: Contoh

Prompt video yang praktis mendefinisikan apa yang harus tetap stabil dan apa yang harus berubah seiring waktu. Gunakan struktur ini:

Subject + action + environment + camera movement + lighting + visual style + timeline + audio direction + constraints

Prompt Single-Shot

A red vintage roadster drives along a wet coastal highway at blue hour. The camera tracks low beside the front wheel, then rises smoothly to reveal ocean cliffs. Realistic reflections, restrained motion blur, cinematic 35mm look, no text or logos.

Prompt Multi-Shot

Create a cinematic detective sequence with consistent character identity. Shot 1 [0-2s]: a rain-soaked city street at night, neon reflected in puddles. Shot 2 [2-4s]: the detective enters an old building; slow handheld follow shot. Shot 3 [4-5s]: close-up of a clue under a narrow flashlight beam. Preserve the same coat, face and lighting palette across all shots. No captions.

Prompt Gambar-ke-Video

Preserve the subject's face, clothing and background layout. The subject looks up, turns slightly toward the window and takes one step forward. Slow camera push-in, warm light gradually increases, natural hair and fabric motion, no new objects.

Panduan Negative Prompt

Gunakan negative prompt untuk menekan mode kegagalan yang berulang alih-alih menggambarkan adegan yang diinginkan untuk kedua kalinya. Daftar ringkas seperti low resolution, deformed hands, duplicated limbs, flicker, unstable face, unreadable text, dan watermark biasanya lebih berguna daripada paragraf panjang yang kontradiktif.

Berapa Biaya API Wan 2.7?

Route CometAPI saat ini mencantumkan Wan 2.7 sebesar $0,08 per detik untuk 720p dan $0,12 per detik untuk 1080p. Estimasi biaya karenanya merupakan fungsi langsung dari durasi yang dihasilkan dan resolusi yang dipilih.

ResolusiHarga / detik5 detik10 detik15 detik
720p$0.08$0.40$0.80$1.20
1080p$0.12$0.60$1.20$1.80
Estimated video cost = price per second x generated duration in seconds

Sumber data: Harga model live CometAPI**.

Interpretasi harga: Jangan mengklaim bahwa route agregator lebih murah daripada Alibaba Cloud tanpa membandingkan region, varian model, resolusi, durasi, mode audio, dan unit penagihan yang sama. Harga per detik yang jelas dari CometAPI dan penagihan terpadu adalah keunggulan integrasi; keunggulan harga penyedia memerlukan perbandingan dengan basis yang setara.

Klip 1080p yang gagal tinjauan kreatif lebih mahal daripada harga generasi yang tertera karena tim harus membuat ulang. Untuk perencanaan produksi, bagi total pengeluaran dengan jumlah klip yang diterima tanpa pengerjaan ulang.

Wan 2.7 vs Seedance 2.5 vs Vidu Q3 vs Veo 3.1

Alternatif paling berguna di platform yang sama adalah Seedance 2.5, Vidu Q3 dan Veo 3.1. Tabel di bawah membandingkan kecocokan alur kerja alih-alih menyatakan pemenang universal. Fitur route dapat berubah, jadi verifikasi input lanjutan sebelum produksi.

DimensiWan 2.7Seedance 2.5Vidu Q3Veo 3.1
Posisi utamaSuite multimodal yang dapat dikontrolCerita lebih panjang dan generasi kaya referensiPembuatan cerita cepatVideo sinematik dengan audio native
Teks-ke-videoYaYaYaYa
Gambar-ke-videoYaYaYaYa
Kontrol frame pertama/terakhirDukungan keluarga nativeBergantung routeDidukungDidukung di alur tertentu
Kelanjutan videoDukungan keluarga nativeBerorientasi pengeditanBergantung routeAlur perpanjangan
AudioPanduan input + BGM/SFX otomatisAudio-video gabunganAudio tersinkronisasi nativeAudio tersinkronisasi native
Durasi route umum2–15 dtk T2V native4–30 dtk route terdaftar1–16 dtk route terdaftarMode resmi 4/6/8 dtk
Resolusi maksimum umum1080pBergantung route1080p1080p; varian lain dapat berbeda
Kecocokan terbaikAlur produksi terkontrolStorytelling multi-shot lebih panjangIterasi naratif cepatShot sinematik kelas atas

Hasil Perbandingan

  • Pilih Wan 2.7 saat kontrol frame pertama/terakhir, kelanjutan, panduan audio, dan alur kerja yang dapat dikontrol luas lebih penting daripada panjang klip maksimum.
  • Pilih Seedance 2.5 saat storytelling multi-shot lebih panjang dan pekerjaan kreatif kaya referensi menjadi prioritas.
  • Pilih Vidu Q3 saat iterasi naratif cepat, audio tersinkronisasi, dan alur kerja berorientasi kreator menjadi pusat.
  • Pilih Veo 3.1 saat kualitas sinematik, realisme visual, dan audio terintegrasi sepadan dengan biaya route yang lebih tinggi.
  • Jangan memilih pemenang dari spesifikasi saja. Gunakan set prompt dan aset tetap, lalu bandingkan tingkat output yang diterima dan total biaya produksi.

Praktik Terbaik Produksi

Siklus Tugas dan Keandalan

  • Simpan task ID segera setelah pembuatan tugas.
  • Gunakan strategi idempoten di aplikasi Anda agar retry klien tidak membuat tugas berbayar duplikat.
  • Lakukan polling dengan interval 10–15 detik dan waktu tunggu maksimum alih-alih loop tak terbatas.
  • Bedakan kegagalan HTTP sementara dari kegagalan generasi yang dinyatakan penyedia.
  • Gunakan exponential backoff untuk error jaringan atau rate-limit, tetapi jangan retry membabi buta untuk kegagalan kebijakan konten.
  • Tandai pekerjaan selesai hanya setelah output diunduh dan divalidasi tidak kosong.
  • Jangan bergantung permanen pada URL sementara penyedia; salin output yang diterima ke penyimpanan yang Anda kontrol jika diizinkan.

Kontrol Kualitas dan Biaya

  • Prototipkan prompt pada 720p dan durasi pendek sebelum menghasilkan master 1080p.
  • Simpan prompt, negative prompt, model ID, route, resolusi, durasi, task ID, dan hash output bersama untuk reprodusibilitas.
  • Bangun rubric review untuk kepatuhan prompt, gerakan, konsistensi temporal, identitas, tangan, artefak teks, audio, dan keamanan.
  • Ukur biaya per output yang diterima, bukan hanya biaya per permintaan.
  • Pertahankan set prompt regresi kecil dan jalankan ulang sebelum beralih versi route atau penyedia model.

Keamanan dan Tata Kelola

  • Simpan API key di server dan rotasi saat dugaan terekspos.
  • Validasi unggahan gambar dan video sebelum diteruskan ke route generasi.
  • Terapkan kontrol persetujuan, kemiripan, dan kekayaan intelektual untuk media referensi.
  • Tambahkan tinjauan manusia untuk iklan, berita, politik, medis, atau penggunaan berdampak tinggi lainnya.
  • Pertahankan metadata provenance dan terapkan kebijakan watermarking atau pengungkapan yang diwajibkan yurisdiksi dan platform Anda.

Error Umum dan Troubleshooting

Error atau gejalaPenyebab yang mungkinPerbaikan yang direkomendasikan
401 UnauthorizedKey hilang, tidak valid, atau dicabutPeriksa Bearer token dan variabel lingkungan
400 Bad RequestField, ukuran, atau durasi tidak didukungMulai dari contoh di halaman model lalu tambahkan field satu per satu
Tidak ada task IDWrapper respons tak terdugaCatat respons lengkap dan periksa data, id, dan task_id
Lama di status queuedBeban atau kapasitas penyediaLanjutkan polling terbatas; jangan menggandakan tugas
Generation failedMedia, prompt, kebijakan, atau error penyediaPeriksa payload terminal sebelum memutuskan untuk retry
MP4 kosongDiunduh sebelum selesai atau menyimpan body errorPeriksa status dan Content-Type sebelum menulis file
Referensi ditolakFormat, dimensi, ukuran, atau jumlah mediaKonversi ke PNG/JPEG dan ikuti batas route live
Biaya tak terdugaDurasi panjang, resolusi tinggi, atau retryPrototipkan pada 720p dan lacak tingkat output yang diterima
Hasil tidak konsistenGenerasi stokastik atau prompt gerakan kaburTentukan timing dan batasan; bandingkan beberapa kandidat

Rekomendasi Akhir

Nilai praktis Wan 2.7 adalah luasnya alur kerja video yang dapat dikontrol: teks-ke-video, animasi gambar, frame jangkar, kelanjutan, generasi berbasis referensi, dan perilaku sadar audio. Melalui CometAPI, jalur tercepat adalah memvalidasi permintaan 5 detik 720p dengan endpoint asynchronous terpadu, lalu menambahkan input gambar dan output 1080p setelah pembuatan tugas, polling, dan pengunduhan andal.

Untuk produksi, pertahankan fitur native lanjutan di balik pemeriksaan kapabilitas eksplisit karena skema terpadu CometAPI mungkin tidak mengekspos setiap field Alibaba. Bandingkan Wan 2.7 dengan alternatif menggunakan prompt dan aset yang sama, dan pilih route yang menghasilkan biaya terendah per video yang disetujui, bukan harga headline terendah.

FAQ

Apa itu API Wan 2.7?

Ini adalah keluarga pembuatan video multimodal yang dapat diakses melalui API yang mencakup teks-ke-video, gambar-ke-video, alur kerja berbasis referensi, dan pengeditan video. CometAPI mengekspos route pelanggan melalui model ID wan2.7.

Apa model ID Wan 2.7 di CometAPI?

Gunakan wan2.7. Jangan menggantinya dengan identifier native Alibaba seperti wan2.7-t2v kecuali Anda memanggil Alibaba Cloud langsung.

Endpoint mana yang membuat video Wan 2.7?

Kirim permintaan multipart POST ke https://api.cometapi.com/v1/videos. Lalu query /v1/videos/{video_id} dan unduh dari /v1/videos/{video_id}/content.

Apakah Wan 2.7 mendukung teks-ke-video dan gambar-ke-video?

Ya. Keduanya adalah kapabilitas yang terdaftar. Gambar-ke-video menambahkan gambar referensi dan harus menggunakan persyaratan field multipart route saat ini.

Resolusi apa yang didukung Wan 2.7?

Route video Wan 2.7 yang dipublikasikan mendukung 720p dan 1080p. Dokumentasi teks-ke-video native juga mencantumkan dimensi output spesifik rasio aspek untuk kedua tingkat tersebut.

Seberapa panjang video Wan 2.7?

API teks-ke-video native Wan 2.7 Alibaba mengizinkan durasi integer 2 hingga 15 detik dengan default 5 detik. Gunakan nilai yang didokumentasikan untuk route CometAPI spesifik yang Anda panggil.

Apakah Wan 2.7 menghasilkan audio?

Alibaba mendokumentasikan generasi yang dipandu audio dan musik latar atau efek suara yang cocok secara otomatis saat audio dihilangkan. Field audio yang tepat yang diekspos melalui route terpadu harus diverifikasi sebelum produksi.

Bisakah Wan 2.7 menggunakan frame pertama dan terakhir?

Keluarga gambar-ke-video native mendukung alur kerja frame pertama dan frame pertama plus terakhir. Konfirmasikan field route terpadu yang sesuai sebelum mengandalkannya di CometAPI.

Apakah API Wan 2.7 synchronous atau asynchronous?

Asynchronous. Pembuatan tugas mengembalikan ID; aplikasi Anda harus melakukan polling status dan mengunduh hasil setelah selesai.

Berapa biaya Wan 2.7 di CometAPI?

Route yang dipublikasikan mencantumkan $0,08 per detik untuk 720p dan $0,12 per detik untuk 1080p. Klip 5 detik diperkirakan masing-masing $0,40 atau $0,60.

Haruskah saya menggunakan Wan 2.7, Seedance 2.5, Vidu Q3, atau Veo 3.1?

Gunakan Wan 2.7 untuk kontrol luas, Seedance 2.5 untuk storytelling panjang kaya referensi, Vidu Q3 untuk iterasi naratif cepat, dan Veo 3.1 untuk output sinematik premium. Validasi pilihan dengan uji A/B terkontrol.

Bisakah Wan 2.7 melanjutkan video yang ada?

Ya dalam keluarga model native melalui alur kerja first_clip. Ketersediaan dan pemetaan parameter pada route CometAPI terpadu harus diperiksa.

Lanjut belajar

Hubungkan artikel ini ke keputusan berikutnya.

Lihat semua topik
Dipublikasikan pada Aug 31, 2026
Terakhir diperbarui Sep 3, 2026
19 tampilan
Ditinjau untuk kejelasan, atribusi sumber, dan terminologi API terkini.

Baca Selengkapnya