Mode video sampel Seedance 2.5 kini tersedia di APIYI: panduan pemanggilan dari video sampel 480p hingga video final 1080p dalam 2 langkah

Catatan penulis: Artikel ini menjelaskan cara menggunakan mode sampel Seedance 2.5 dalam dua tahap. Buat sampel 480p dengan biaya rendah, lalu setelah hasilnya sesuai, buat video final 1080p. Artikel ini juga menyertakan contoh permintaan yang bisa langsung dijalankan.

Saat membuat video dengan AI, masalah yang paling sering terjadi adalah langsung membuat video final beresolusi tinggi, tetapi hasil komposisi, pergerakan kamera, atau aksi subjeknya kurang sesuai. Akibatnya, video harus dibuat ulang dan waktu serta biaya pun terbuang. Pada 25 Oktober 2026, dokumentasi APIYI menambahkan panduan lengkap untuk mode sampel Seedance 2.5 (Draft Mode). Dengan mode ini, Anda bisa memvalidasi ide terlebih dahulu menggunakan sampel 480p. Jika hasilnya memuaskan, gunakan ID tugas sampel untuk membuat video final 1080p.

Ini bukan API baru yang berdiri sendiri. Mode sampel menggunakan antarmuka tugas asinkron Seedance yang sudah ada. Anda hanya perlu menambahkan draft: true ke isi permintaan atau merujuk ID tugas sampel pada tahap kedua. Jika proyek Anda sudah terhubung ke Seedance, perubahan yang diperlukan sangat sedikit.

Manfaat utama: Setelah membaca artikel ini, Anda akan memahami alur pemanggilan mode sampel Seedance 2.5 dalam dua tahap, parameter penting, aturan penagihan, dan batasan penggunaannya. Anda juga bisa mengintegrasikan alur kerja “lihat sampel dulu, lalu buat video final” ke pipeline produksi video Anda.

Poin Utama Mode Sampel Seedance 2.5

Berdasarkan dokumentasi APIYI, informasi utama tentang mode sampel Seedance 2.5 dapat dirangkum dalam tabel berikut:

Mengapa Mode Sampel Seedance 2.5 Layak Digunakan

Ada perbedaan yang jelas antara pembuatan video dan pembuatan teks: proses sekali pembuatan video memakan waktu dan biaya lebih besar, serta hasilnya lebih acak. Meski petunjuk ditulis dengan sangat terperinci, pemahaman model tentang ritme kamera dan gerakan subjek bisa saja berbeda dari yang diharapkan. Jika setiap kali langsung membuat video 1080p, hasil yang tidak memuaskan berarti biaya pembuatan video final terbuang.

Mode sampel membagi proses menjadi dua tahap: “uji pengambilan gambar” dan “pengambilan gambar resmi”. Sampel 480p cukup untuk menilai subjek dalam gambar, arah pergerakan kamera, dan suasana keseluruhan. Setelah hasilnya dipastikan sesuai, sampel tersebut dapat digunakan untuk membuat video final 1080p. Bagi tim yang memproduksi video pendek, materi iklan, atau pratinjau storyboard secara massal, cara ini dapat mengurangi jumlah hasil yang tidak terpakai secara signifikan.

Hubungan antara Dua Tahap Mode Sampel Seedance 2.5

Perlu diperhatikan bahwa video final bukan sekadar sampel yang diperbesar. Tahap kedua merupakan tugas pembuatan baru yang menggunakan draft_task.id untuk merujuk tugas sampel, mewarisi pengaturan terkait dari tahap sampel, lalu menghasilkan video 1080p. Untuk mengetahui parameter yang diwarisi dan parameter yang tidak dapat diubah pada tahap kedua, lihat bagian “Pewarisan dan Batasan Parameter” dalam dokumentasi APIYI.

Panduan Cepat Mode Draf Seedance 2.5

Sebelum mulai, buat kunci API di konsol APIYI apiyi.com, lalu atur sebagai variabel lingkungan APIYI_API_KEY. Semua contoh di bawah membaca kunci dari variabel lingkungan agar kunci tidak perlu ditulis langsung di kode.

Langkah 1: Buat Draf 480p

Berikut permintaan paling sederhana untuk membuat tugas draf. Bagian pentingnya adalah "draft": true, dengan resolusi diatur ke 480p:

curl -X POST "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "Accept-Encoding: identity" \
  --data '{
    "model": "doubao-seedance-2-5-260628",
    "content": [
      {"type": "text", "text": "一只橘猫在窗边伸懒腰，阳光洒在木地板上，镜头缓慢推进"}
    ],
    "draft": true,
    "resolution": "480p",
    "ratio": "16:9",
    "duration": 4,
    "generate_audio": false
  }'

Antarmuka ini bekerja secara asinkron. Setelah tugas berhasil dibuat, sistem akan mengembalikan ID tugas. Simpan ID tersebut karena Anda akan menggunakannya untuk memeriksa hasil draf maupun membuat video final.

Penjelasan Parameter Permintaan Tahap Pertama

Header permintaan Accept-Encoding: identity digunakan untuk meminta server agar tidak mengompresi respons, sehingga beberapa klien dapat langsung mengurai hasilnya. Sebaiknya header ini tetap disertakan.

Tahap Kedua: Periksa Status Tugas Cuplikan

Setelah tugas cuplikan dibuat, statusnya perlu diperiksa secara berkala hingga berhasil dan alamat video tersedia. Pemeriksaan menggunakan antarmuka tugas asinkron yang sudah ada. Biasanya, permintaan GET dikirim ke alamat tugas dengan ID tugas. Untuk jalur dan kolom respons yang tepat, lihat dokumentasi APIYI:

curl -X GET "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks/${TASK_ID}" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Accept-Encoding: identity"

Sebaiknya atur jeda pemeriksaan antara 5–10 detik. Pemeriksaan yang terlalu sering tidak diperlukan dan justru dapat memicu pembatasan laju.

Langkah ketiga: Buat video final 1080p menggunakan ID tugas video pratinjau

Setelah hasil video pratinjau memuaskan, gunakan draft_task.id di dalam array content sebagai referensi tugas pratinjau, lalu atur resolusinya ke 1080p:

curl -X POST "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer ${APIYI_API_KEY}" \
  -H "Content-Type: application/json" \
  -H "Accept-Encoding: identity" \
  --data '{
    "model": "doubao-seedance-2-5-260628",
    "content": [
      {"type": "draft_task", "draft_task": {"id": "YOUR_DRAFT_TASK_ID"}}
    ],
    "resolution": "1080p"
  }'

Ganti YOUR_DRAFT_TASK_ID dengan ID tugas video pratinjau yang dikembalikan pada langkah pertama. Untuk nilai yang dapat digunakan pada kolom type di elemen content serta parameter opsional lainnya, periksa contoh permintaan dua tahap di dokumentasi. Pembuatan video final juga berjalan secara asinkron. Gunakan cara pada langkah kedua untuk memeriksa tugas dan mendapatkan video 1080p.

import os
import time
import requests

API_KEY = os.environ["APIYI_API_KEY"]
BASE_URL = "https://api.apiyi.com/seedance/api/v3/contents/generations/tasks"  # APIYI Seedance: endpoint tugas asinkron
MODEL = "doubao-seedance-2-5-260628"

HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
    "Accept-Encoding": "identity",
}


def create_task(payload: dict) -> str:
    """Buat tugas asinkron dan kembalikan ID tugas."""
    resp = requests.post(BASE_URL, headers=HEADERS, json=payload, timeout=60)
    resp.raise_for_status()
    data = resp.json()
    return data["id"]


def wait_task(task_id: str, interval: int = 8, timeout: int = 900) -> dict:
    """Periksa status tugas secara berkala hingga berhasil atau gagal."""
    start = time.time()
    while time.time() - start < timeout:
        resp = requests.get(f"{BASE_URL}/{task_id}", headers=HEADERS, timeout=30)
        resp.raise_for_status()
        data = resp.json()
        status = data.get("status")
        print(f"[{task_id}] status = {status}")
        if status == "succeeded":
            return data
        if status in ("failed", "cancelled", "expired"):
            raise RuntimeError(f"Tugas berakhir tanpa berhasil: {data}")
        time.sleep(interval)
    raise TimeoutError(f"Waktu tunggu untuk tugas {task_id} habis")


def generate_draft(prompt: str) -> str:
    """Tahap pertama: buat video pratinjau 480p."""
    payload = {
        "model": MODEL,
        "content": [{"type": "text", "text": prompt}],
        "draft": True,
        "resolution": "480p",
        "ratio": "16:9",
        "duration": 4,
        "generate_audio": False,
    }
    task_id = create_task(payload)
    result = wait_task(task_id)
    print("Hasil video pratinjau:", result.get("content"))
    return task_id


def generate_final(draft_task_id: str) -> dict:
    """Tahap kedua: buat video final 1080p menggunakan ID tugas video pratinjau."""
    payload = {
        "model": MODEL,
        "content": [
            {"type": "draft_task", "draft_task": {"id": draft_task_id}}
        ],
        "resolution": "1080p",
    }
    task_id = create_task(payload)
    return wait_task(task_id)


if __name__ == "__main__":
    draft_id = generate_draft("一只橘猫在窗边伸懒腰，阳光洒在木地板上，镜头缓慢推进")
    ok = input("样片是否满意？(y/n): ").strip().lower()
    if ok == "y":
        final = generate_final(draft_id)
        print("成片结果:", final.get("content"))
    else:
        print("请调整提示词后重新生成样片。")

🚀 Mulai cepat: Sebaiknya klaim kuota uji coba gratis untuk pengguna baru di APIYI apiyi.com. Sempurnakan petunjuk hingga hasil video pratinjau 480p konsisten, lalu buat video final 1080p secara massal. Platform ini menggunakan satu kunci API untuk penagihan, sehingga biaya pemanggilan untuk beberapa proyek video lebih mudah dikelola.

Perbandingan Mode Pratinjau dan Langsung Menghasilkan Video Final Seedance 2.5

Penggunaan mode pratinjau bergantung pada kebutuhan bisnis Anda terkait kepastian hasil dan kecepatan pengiriman. Tabel berikut membandingkan kedua cara pemanggilan:

Penjelasan Perbandingan Mode Pratinjau Seedance 2.5

Langsung menghasilkan video final unggul dari segi kesederhanaan alur: cukup satu permintaan untuk mendapatkan video akhir. Namun, jika subjek atau pergerakan kamera kurang sesuai, biaya dan waktu tunggu untuk seluruh video final 1080p akan terbuang. Sebaliknya, mode pratinjau menempatkan proses uji coba pada tahap resolusi rendah. Mode ini lebih cocok untuk proyek yang memerlukan beberapa kali penyesuaian petunjuk atau membutuhkan konfirmasi arah dari klien terlebih dahulu.

Jika templat petunjuk Anda sudah banyak diuji dan hasilnya relatif stabil, langsung menghasilkan video final juga merupakan pilihan yang masuk akal. Pendekatan yang praktis: gunakan mode pratinjau untuk ide dan templat baru, lalu gunakan pembuatan langsung untuk templat yang sudah matang. Kedua cara ini bisa diganti kapan saja melalui antarmuka asinkron yang sama.

💡 Saran pemilihan: Untuk membandingkan hasil nyata dari kedua cara, sebaiknya uji beberapa kelompok petunjuk bisnis Anda sendiri. Saat menggunakan APIYI apiyi.com, kedua mode memakai antarmuka dan kunci API yang sama. Untuk beralih, Anda hanya perlu mengubah parameter di isi permintaan.

Hal yang Perlu Diperhatikan Saat Mengintegrasikan Mode Cuplikan Seedance 2.5

Ada beberapa detail yang mudah terlewat saat mengintegrasikan mode cuplikan ke lingkungan produksi. Tabel berikut merangkum hal-hal yang perlu diperhatikan:

Saran Desain Alur Kerja Mode Cuplikan Seedance 2.5

Untuk kolaborasi tim, sebaiknya mode cuplikan dibagi menjadi alur tiga tahap: “pembuatan—peninjauan—persetujuan”. Setelah sistem membuat cuplikan secara massal, hasilnya dikirim kepada peninjau. ID tugas cuplikan yang disetujui masuk ke antrean pembuatan video final, sedangkan cuplikan yang ditolak dikembalikan ke tahap penyesuaian petunjuk beserta catatan revisinya. Dengan begitu, penilaian manual bisa difokuskan pada tahap cuplikan yang biayanya lebih rendah.

Untuk pipeline yang lebih otomatis, Anda juga bisa menggunakan Model Bahasa Besar multimodal pada tahap cuplikan untuk melakukan pemeriksaan awal, misalnya memastikan apakah subjek yang ditentukan muncul di dalam gambar atau apakah ada distorsi yang jelas. Setelah lolos pemeriksaan awal, hasilnya diteruskan kepada peninjau untuk dikonfirmasi. Cara ini dapat mengurangi beban peninjauan manual. Karena APIYI menyediakan antarmuka terpadu untuk berbagai model terkemuka, pembuatan video dan peninjauan multimodal dapat dilakukan menggunakan kunci API yang sama.

FAQ Umum

Poin Penting Mode Sampel Seedance 2.5

• Alur dua tahap: Kirim draft: true untuk membuat sampel 480p, lalu gunakan ID tugas tersebut untuk menghasilkan video final 1080p
• API tetap sama: Tetap menggunakan API tugas asinkron Seedance yang sudah ada, jadi perubahan pada proyek yang sudah terintegrasi sangat minim
• Kolom penting: Pada tahap pembuatan video final, gunakan content[].draft_task.id untuk merujuk ke tugas sampel
• Aturan biaya: Sampel dan video final dikenai biaya secara terpisah. Anda hanya perlu membayar biaya video final untuk sampel yang hasilnya memuaskan
• Batas waktu: ID tugas sampel berlaku selama 7 hari, jadi pastikan untuk meninjau dan menyetujuinya tepat waktu
• Skenario penggunaan: Mode ini paling bermanfaat untuk eksplorasi ide, persetujuan klien, dan penyaringan aset dalam jumlah besar
• Cara mencoba: Dapatkan kuota gratis di APIYI apiyi.com, lalu ikuti contoh di artikel ini untuk menjalankan seluruh alurnya

Kesimpulan

Poin utama mode sampel Seedance 2.5:

1. Uji dulu, baru buat versi final: Gunakan sampel 480p yang lebih hemat biaya untuk memvalidasi komposisi dan pergerakan kamera, sehingga mengurangi jumlah video 1080p yang tidak layak
2. Mudah diintegrasikan: Cukup tambahkan parameter draft dan referensi draft_task.id, lalu gunakan kembali API asinkron yang sudah ada
3. Perhatikan masa berlaku dan biaya: ID sampel berlaku selama 7 hari, dan sampel serta video final dikenai biaya secara terpisah

Jika proses pembuatan video Anda sering memerlukan penyesuaian petunjuk berulang kali, mode sampel layak segera diintegrasikan. Coba jalankan alur “sampel → video final” dengan beberapa petunjuk yang mewakili kebutuhan Anda. Setelah mengevaluasi hasil dan biayanya, barulah terapkan ke produksi massal.

Untuk menguji langsung mode sampel Seedance 2.5, Anda bisa menggunakan APIYI apiyi.com. Platform ini menyediakan API yang kompatibel dengan OpenAI, penagihan sesuai pemakaian, dan kuota uji coba gratis bagi pengguna baru.

📚 Referensi

1. Dokumentasi pembuatan video Seedance 2 APIYI – mode draf: Panduan resmi penggunaan mode draf Seedance 2.5
2. Tautan: docs.apiyi.com/api-capabilities/seedance2/video-generation#draft-mode

3. Keterangan: Mencakup contoh permintaan dua tahap, pewarisan dan batasan parameter, serta informasi biaya dan masa berlaku.

4. Pusat Dokumentasi APIYI: Dokumentasi antarmuka semua model di platform

5. Tautan: docs.apiyi.com
6. Keterangan: Berisi ringkasan pemilihan model Seedance dan cara menggunakan model lainnya.

Penulis: Tim Teknis APIYI
Diskusi teknis: Jika Anda mengalami kendala saat integrasi, silakan hubungi kami melalui situs APIYI di apiyi.com. Informasi lebih lanjut tersedia di Pusat Dokumentasi docs.apiyi.com.

Artikel terkait

• Praktik Langsung SeeDance2.5 untuk Pembuatan/Pengeditan Video dengan Wajah: 3 Langkah Memasukkan Materi Orang Nyata ke Pustaka dan Menggunakan Model Secara Patuh: Jelaskan dengan gamblang alur yang benar untuk pembuatan dan pengeditan video berwajah menggunakan SeeDance2.5: daftarkan materi orang sungguhan, dapatkan Asset ID, gunakan asset:// sebagai referensi saat melakukan pemanggilan, serta jelaskan apakah “menutupi wajah” diperlukan dan mengapa pengunggahan langsung video yang menampilkan wajah diblokir.