<!-- Canonical URL: https://ask.atlascloud.ai/id/seedance-2-5-api-quickstart-first-video-atlas-cloud -->

# Seedance 2.5 API Panduan Cepat: Hasilkan Video Pertama Anda dengan Atlas Cloud

> Luncurkan integrasi video Seedance yang berfungsi hari ini di Atlas Cloud dengan satu kunci API dan dua panggilan REST, lalu ganti dengan Seedance 2.5 saat peluncuran dengan mengubah satu string model.

Anda telah membaca [pengumuman Seedance 2.5](https://www.atlascloud.ai/models/seedance-2.5?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud), membuat sketsa fitur produk seputar klip yang dihasilkan selama 30 detik, dan sekarang ingin menulis kode. Kemudian Anda menemui hambatan yang dialami setiap pengembang dengan model yang baru diumumkan: halaman kemampuan sudah aktif, tetapi *endpoint* yang benar-benar dapat Anda panggil dari aplikasi Anda adalah pertanyaan yang sama sekali berbeda.

Berikut adalah versi jujur dari situasi ini, dan panduan memulai cepat yang menghormatinya. Atlas Cloud telah menerbitkan halaman keluarga [Seedance](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) 2.5 yang berkomitmen untuk akses Hari-0 pada *endpoint* terpadu yang sama yang sudah melayani [Seedance 2.0](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) dan 1.5. Pada saat penulisan, daftar tersebut ditandai *Coming Soon* dan belum ada harga Atlas Cloud untuk Seedance 2.5 yang dipublikasikan. Apa artinya secara praktis adalah kabar baik: integrasi yang Anda bangun hari ini terhadap tingkatan Seedance yang *live* adalah integrasi yang sama yang akan Anda jalankan saat peluncuran 2.5. Satu-satunya hal yang berubah adalah string model.

Jadi, panduan memulai cepat ini melakukan dua tugas. Ia menghasilkan video nyata dari *endpoint* nyata hari ini, dan ia menyusun kode serta *prompt* Anda sehingga peningkatan hanyalah perubahan satu baris.

## Apa yang sebenarnya dikirimkan dalam Seedance 2.5

Menurut halaman resmi Seedance 2.5 dari ByteDance, ini adalah model generasi bersama audio-video generasi berikutnya yang dibangun untuk bercerita selama 30 detik dengan kontrol referensi yang presisi dan pengeditan yang kuat. Klaim konkret yang layak untuk dirancang:

* Hingga 30 detik dalam satu generasi, dengan opsi untuk memperpanjang dua kali untuk cerita yang lebih panjang dan lebih lengkap
* Gerakan yang lebih halus dan lebih konsisten, dengan visual yang lebih realistis
* Pemahaman video referensi yang lebih presisi, menangkap niat, pembingkaian, dan bahasa sinematik daripada sekadar mentransfer gerakan
* Pengeditan yang lebih andal di berbagai permintaan pengeditan audio dan visual
* Kontrol model putih dan pengeditan layar hijau, plus gerakan kamera profesional dan pemblokiran kinerja, yang ditujukan untuk alur kerja produksi yang kompleks

Perhatikan apa yang tidak ada dalam daftar itu: tidak ada tabel tolok ukur, tidak ada tangga resolusi, tidak ada jumlah aset referensi. Apa pun yang Anda lihat di sepanjang garis itu adalah kemasan pemasaran seseorang, bukan lembar spesifikasi resmi. Bangunlah berdasarkan klaim di atas.

## Langkah 1: dapatkan kunci dari konsol

Masuk ke console.atlascloud.ai dan buat kunci API. Tidak ada deposit, tidak ada komitmen minimum, dan tidak ada daftar tunggu, jadi kunci tersebut dapat langsung digunakan dengan sistem *pay-as-you-go*. Satu kunci mencakup seluruh katalog lebih dari 300 model di seluruh teks, gambar, dan video, pada satu akun penagihan, yang merupakan bagian yang penting untuk panduan memulai cepat ini: kunci yang Anda buat sekarang adalah kunci yang sama yang akan memanggil Seedance 2.5.

Simpan sebagai variabel lingkungan, jangan pernah di dalam kode sumber. `ATLASCLOUD_API_KEY` adalah nama yang tepat.

## Langkah 2: kirimkan pekerjaan video

Pembuatan video di Atlas Cloud adalah panggilan REST asinkron dua langkah, bukan penyelesaian obrolan. Anda *POST* pekerjaan dan mendapatkan ID prediksi, lalu Anda melakukan *polling* pada ID tersebut hingga *render* selesai. Klien HTTP apa pun bisa digunakan, jadi tidak ada SDK vendor yang perlu diinstal dan tidak ada skema otentikasi baru yang perlu dipelajari: itu adalah *bearer token* pada kunci yang baru saja Anda buat.

```python
import os, time, requests

KEY  = os.environ["ATLASCLOUD_API_KEY"]
BASE = "https://api.atlascloud.ai/api/v1/model"
HEAD = {"Authorization": "Bearer " + KEY, "Content-Type": "application/json"}

job = requests.post(f"{BASE}/generateVideo", headers=HEAD, json={
    "model": "bytedance/seedance-2.0/text-to-video",
    "prompt": "Handheld, subject-following medium shot of a courier weaving through a night market, "
              "neon reflections on wet asphalt, slight lag on turns.",
    "duration": 5,
    "resolution": "720p",
    "ratio": "adaptive",
    "bitrate_mode": "standard",
    "generate_audio": True,
    "watermark": False,
}).json()

prediction_id = job["data"]["id"]
```

Responsnya kembali sebagai `{"code": 200, "data": {"id": "...", "status": "processing"}}`. Perhatikan bahwa `model` adalah bidang string biasa. Detail ini adalah keseluruhan cerita peningkatan untuk artikel ini, dan Langkah 6 akan kembali ke sana.

## Langkah 3: polling hingga *render* selesai

Klip 5 detik bukanlah respons instan, jadi perlakukan *render* sebagai pekerjaan dengan siklus hidup daripada panggilan pemblokiran. Lakukan *polling* pada *endpoint* prediksi hingga `status` mencapai nilai terminal.

```python
while True:
    r = requests.get(f"{BASE}/prediction/{prediction_id}", headers=HEAD).json()
    status = r["data"]["status"]
    if status in ("completed", "succeeded", "failed"):
        break
    time.sleep(3)

print(status, r["data"])   # saat berhasil, payload membawa URL output
```

Dua hal yang layak dibangun sekarang daripada nanti. Beri batas atas pada *loop* polling sehingga pekerjaan yang macet tidak dapat menggantung *request handler*, dan simpan ID prediksi sebelum Anda mulai *polling* sehingga pekerja yang crash dapat melanjutkan daripada membayar *render* dua kali. Kedua kebiasaan itu tetap tidak berubah saat beralih ke 2.5.

Jika fitur Anda bekerja dari gambar referensi atau referensi subjek alih-alih teks murni, alur yang sama berlaku dengan varian model yang berbeda, `bytedance/seedance-2.0/image-to-video` atau `bytedance/seedance-2.0/reference-to-video`. Aset referensi subjek diunggah satu kali melalui `uploadMedia` dan kemudian diteruskan sebagai `asset://<id>` di bidang gambar, sehingga karakter atau produk yang berulang tidak perlu diunggah ulang pada setiap panggilan.

## Langkah 4: pilih tingkatan Seedance yang *live* dan ketahui biaya per detik

Atlas Cloud menagih video per detik durasi output. Itu adalah aritmatika yang bisa Anda lakukan di kepala sebelum menulis kode apa pun. Tiga tingkatan Seedance *live* saat ini:

| Model | Model ID | Harga Atlas Cloud | Catatan |
|---|---|---|---|
| Seedance 2.0 | `bytedance/seedance-2.0/text-to-video` | $0,112/dtk | Tingkatan unggulan *live*, kunci instan, tanpa daftar tunggu |
| [Seedance 2.0 Fast](https://www.atlascloud.ai/models/bytedance/seedance-2.0-fast/text-to-video?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-2.0-fast/text-to-video` | $0,09/dtk | Varian lebih cepat dari keluarga yang sama |
| [Seedance 2.0 Mini](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-2.0-mini/text-to-video` | $0,056/dtk | Tingkatan Seedance 2.0 *live* termurah, juga *image-to-video* dan *reference-to-video* |
| [Seedance 1.5 Pro](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-v1.5-pro/text-to-video` | $0,047/dtk, atau $0,018/dtk pada varian Fast | Audio sinkron asli, *lip sync* multibahasa, klip 4 hingga 12 detik |

Sebagai orientasi, model video lain pada kunci yang sama berjalan di kisaran yang sebanding: Grok Imagine Video v1.5 seharga $0,080/dtk, [Wan 2.7](https://www.atlascloud.ai/models/alibaba/wan-2.7?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) seharga $0,100/dtk, [Kling](https://www.atlascloud.ai/models/kling-v3?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) V3.0 Turbo seharga $0,112 standar dan $0,095 diskon, MiniMax H3 seharga $0,14/dtk.

Yang mana yang akan dibangun tergantung pada apa yang akan dilakukan fitur 2.5 Anda pada akhirnya. Jika audio sangat penting untuk output, Seedance 1.5 Pro adalah tingkatan yang sudah memiliki audio sinkron asli dan *lip sync* multibahasa, sehingga *pipeline* Anda belajar menangani trek audio sejak hari pertama. Jika Anda mengulangi struktur *prompt* dan menginginkan biaya terendah per eksperimen, Seedance 2.0 Mini seharga $0,056/dtk adalah *sandbox* yang jelas. Jika Anda menginginkan sesuatu yang paling mendekati *render* generasi saat ini tingkat produksi, Seedance 2.0 seharga $0,112/dtk adalah pilihan langsung, dengan varian Fast seharga $0,09/dtk jika *throughput* lebih penting daripada peningkatan kualitas terakhir.

## Langkah 5: periksa harga *live* di *Playground* sebelum Anda membelanjakan

Sebelum panggilan berbayar pertama Anda, buka model di Atlas Cloud Playground. Setiap model menampilkan harga per-model *live* di samping tombol *Run*. Ini lebih penting daripada kedengarannya: diskon promosi datang dan pergi, dan angka di samping tombol *Run* adalah angka yang akan benar-benar ditagih. Jalankan satu generasi di *Playground*, konfirmasi bahwa outputnya adalah apa yang dibutuhkan fitur Anda, lalu pindahkan pengaturan ke dalam kode.

Model per-detik-pada-output juga membuat percakapan anggaran Anda menjadi sepele. Klip 10 detik di Seedance 2.0 Mini adalah 10 × $0,056. Tidak ada kalkulator, tidak ada perkiraan token, dan tidak ada langkah rekonsiliasi *post-hoc*.

Itu perlu dibandingkan dengan bagaimana saluran ByteDance resmi menagih Seedance. Di Volcano Engine Ark di Tiongkok dan BytePlus ModelArk secara internasional, penagihan berbasis token: perkiraan konsumsi token adalah (durasi video input + durasi video output) × lebar output × tinggi output × *frame rate* output / 1024, dikalikan dengan harga unit token, dengan penggunaan aktual yang berwenang dari bidang `usage.completion_tokens` dalam respons API. Untuk seri Seedance 2.0 dan Seedance 2.5, ketika inputnya menyertakan video, berlaku batas minimum konsumsi token, dan batas tersebut tergantung pada resolusi, rasio aspek, dan durasi output. ByteDance menerbitkan kalkulator harga ditambah tabel token minimum untuk alasan ini.

Kedua model itu sah. Tetapi jika Anda menganggarkan *render* 30 detik, per-detik-pada-durasi-output adalah aritmatika mental dan token-dengan-batas membutuhkan *spreadsheet*.

## Langkah 6: tulis deskripsi bidikan seperti sudah 2.5

Ini adalah bagian dari panduan memulai cepat yang ditransfer dengan sempurna, karena keahlian *prompt* tidak memiliki versi. Dua klaim kemampuan 2.5 harus mengubah cara Anda menulis hari ini.

**Kontrol referensi yang presisi.** Klaim ByteDance adalah bahwa 2.5 membaca video referensi untuk niat, pembingkaian, dan bahasa sinematiknya, melampaui transfer gerakan. Implikasi *prompt*-nya adalah bahwa aset referensi Anda berhenti menjadi template gerakan dan mulai menjadi ringkasan arahan. Jadi berhentilah menulis *prompt* yang hanya mendeskripsikan subjek, dan mulailah menyebutkan tata bahasa yang ingin Anda bawa: nuansa lensa, pembingkaian, tempo potongan, apakah kamera memimpin atau mengikuti subjek. Tulislah "handheld, subject-following medium shot, slight lag on turns" alih-alih "person walking, cinematic".

**Tiga puluh detik dalam satu generasi.** Klip 5 detik adalah satu bidikan. Tiga puluh detik adalah adegan dengan struktur, dan 2.5 mendukung perpanjangan dua kali di atasnya. Jadi tulislah deskripsi bidikan dengan struktur ketukan daripada satu deskripsi statis: ketukan pembuka, perubahan (belokan, pintu masuk, pengungkapan), dan resolusi. Sebutkan gerakan kamera dan pemblokiran kinerja secara eksplisit, karena itulah kontrol yang tepat yang dituju 2.5. Di mana subjek berdiri, ke mana mereka bergerak, apa yang dilakukan kamera saat mereka bergerak.

Kedua kebiasaan itu membuahkan hasil pada tingkatan *live* sekarang. Keduanya adalah kebiasaan yang tepat yang dihargai 2.5.

## Langkah 7: rencanakan pertukaran

Susun kode Anda sehingga pengenal model adalah konfigurasi, bukan literal. Satu konstanta, dibaca dari lingkungan atau konfigurasi:

```python
SEEDANCE_MODEL = os.environ.get("SEEDANCE_MODEL", "bytedance/seedance-2.0/text-to-video")
```

Kemudian berikan `SEEDANCE_MODEL` di mana Langkah 2 melakukan *hardcode* string. Karena `model` adalah bidang string JSON tunggal dalam isi `generateVideo`, peningkatan pada peluncuran 2.5 benar-benar hanya satu variabel lingkungan. Bukan metafora untuk perubahan kecil, secara harfiah satu nilai.

Jangan pernah melakukan *hardcode* pengenal Seedance 2.5 hari ini, karena belum ada ID model Seedance 2.5 Atlas Cloud yang ada. Ambil ID *live* yang tepat dari katalog di atlascloud.ai/models daripada menyalinnya dari artikel, termasuk artikel ini, karena varian baru ditambahkan dari waktu ke waktu. Ketika 2.5 diluncurkan berdasarkan komitmen Hari-0, pekerjaan di pihak Anda adalah satu variabel itu, ditambah melihat-lihat harga di samping tombol *Run* dan membaca ulang parameter permintaan baru apa pun, karena model 30 detik dengan dukungan perpanjangan kemungkinan akan menerima bidang yang tidak dimiliki isi 2.0.

Sementara itu, jika Anda membutuhkan Seedance 2.5 hari ini daripada saat peluncuran Atlas Cloud, jawaban jujurnya adalah saluran ByteDance resmi: Volcano Engine Ark di Tiongkok dan BytePlus ModelArk secara internasional. Di antara agregator, beberapa berada dalam keadaan *prelaunch* atau komitmen Hari-0 yang sama.

## FAQ

T: Dapatkah saya memanggil Seedance 2.5 di Atlas Cloud sekarang?
J: Tidak. Halaman keluarga Seedance 2.5 di Atlas Cloud ditandai *Coming Soon* dengan komitmen akses Hari-0 pada *endpoint* terpadu yang sama yang sudah melayani Seedance 2.0 dan 1.5. Belum ada ID model dan harga yang dipublikasikan untuk itu.

T: Berapa biaya Seedance di Atlas Cloud hari ini?
J: Seedance 2.0 adalah $0,112/dtk, Seedance 2.0 Fast adalah $0,09/dtk, Seedance 2.0 Mini adalah $0,056/dtk, dan Seedance 1.5 Pro adalah $0,047/dtk atau $0,018/dtk pada varian Fast-nya. Penagihan adalah per detik durasi output, dan harga *live* ditampilkan di samping tombol *Run* di *Playground*.

T: Apakah saya memerlukan SDK khusus untuk video di Atlas Cloud?
J: Tidak. Video adalah alur REST biasa: `POST /api/v1/model/generateVideo` untuk mengirimkan pekerjaan, lalu `GET /api/v1/model/prediction/{id}` untuk melakukan *polling*, keduanya diautentikasi dengan *bearer token* pada kunci Atlas Cloud Anda. Klien HTTP apa pun bisa digunakan. Perhatikan bahwa video tidak melalui *endpoint* obrolan yang kompatibel dengan OpenAI yang digunakan katalog teks, jadi jangan berharap `chat.completions` untuk merender klip. Parameter permintaan per-model didokumentasikan di atlascloud.ai/docs.

T: Apakah ada deposit atau komitmen minimum untuk memulai?
J: Tidak. Atlas Cloud adalah *pay-as-you-go* tanpa deposit, tanpa komitmen minimum, dan tanpa daftar tunggu, dan kunci dari console.atlascloud.ai dapat langsung digunakan.

T: Tingkatan *live* mana yang harus saya prototipe jika saya menargetkan 2.5?
J: Seedance 2.0 Mini seharga $0,056/dtk untuk iterasi *prompt* murah, Seedance 1.5 Pro jika *pipeline* Anda perlu menangani trek audio sinkron asli, dan Seedance 2.0 seharga $0,112/dtk untuk *render* produksi generasi saat ini yang paling mendekati.

## Intinya

Atlas Cloud menjalankan Seedance 2.0, Seedance 2.0 Fast, Seedance 2.0 Mini, dan Seedance 1.5 Pro hari ini pada satu kunci API dengan penagihan per detik pada durasi output, sertifikasi SOC II, kepatuhan HIPAA, dan enkripsi saat istirahat dan dalam perjalanan, dan telah menerbitkan komitmen Hari-0 untuk melayani Seedance 2.5 pada *endpoint* terpadu yang sama saat dikirimkan.

Untuk panduan implementasi terkait, lihat [API gambar, video, dan LLM terbaru yang tersedia sekarang](https://ask.atlascloud.ai/latest-image-video-llm-apis-available-now) dan [memperkirakan kapasitas, latensi, dan biaya inferensi AI](https://ask.atlascloud.ai/estimate-ai-inference-capacity-latency-cost).