Catatan penulis: Tetapkan karakter dengan Nano Banana, buat gerakan berlatar layar hijau dengan Seedance, lalu gunakan alur pemrosesan aset dsh-pet untuk menghapus latar hingga transparan. Tiga langkah ini cukup untuk membuat hewan peliharaan animasi di desktop dengan karakter pilihanmu sendiri.
Hingga 22 Oktober 2026, proyek open source GitHub dsh-pet telah meraih 3.367 bintang. Proyek ini menghadirkan pelayan perempuan bergaya chibi berambut biru dengan latar transparan ke DeepSeek Harness (DSH) dan desktop kamu: ada animasi bernapas saat diam, tertidur secara acak, memantul saat diklik, serta terlempar saat diseret. Lebih dari seratus animasi bisa berpindah dengan mulus. Setelah melihatnya, banyak orang langsung bertanya: bisakah karakternya diganti dengan karakter sendiri? Artikel ini menawarkan tiga langkah: tetapkan karakter dengan Nano Banana + buat gerakan berlatar layar hijau dengan Seedance + hapus latar hingga transparan lewat alur pemrosesan aset.
Perlu diperjelas: ini bukan cara yang digunakan oleh penulis asli. README dsh-pet menyebutkan bahwa aset proyek aslinya dibuat dengan Doubao, dan semua gerakan diproses secara manual di Premiere. README tidak menyebut Nano Banana maupun versi model video tertentu; penulis asli tidak menggunakan model-model ini. Seedance dan Doubao sama-sama berasal dari ByteDance, sehingga pendekatan ini lebih dekat dengan cara penulis asli. Namun, kita tidak bisa menyatakan bahwa penulis asli menggunakan Seedance. Kombinasi dalam artikel ini adalah alternatif yang kami usulkan. Langkah yang diberi label “disarankan” belum diuji sepenuhnya.
- Tujuan: Membuat hewan peliharaan desktop dengan karakter rancangan sendiri dan latar transparan, lalu menjalankan animasinya di DSH dan desktop
- Perkiraan waktu: Sekitar setengah hari. Waktu untuk menghasilkan video 10 detik dengan Seedance bergantung pada kondisi sebenarnya; sebagian besar waktu biasanya dihabiskan untuk memilih hasil dan mencoba ulang
- Prasyarat: Aplikasi desktop DSH, token APIYI, serta Chrome / Edge / Firefox. Langkah penghapusan latar juga memerlukan Python 3 dan ffmpeg
- Tingkat kesulitan: Menengah ke bawah. Membuat gambar dan video, memasang plugin, serta mengatur ukuran bisa dilakukan lewat antarmuka grafis. Hanya langkah penghapusan latar yang memerlukan baris perintah
Manfaat utama: Setelah selesai, kamu akan mendapatkan sebuah paket pet berisi animasi webm transparan dengan karakter buatanmu sendiri, beserta file konfigurasinya. Setelah dipasang ke dsh-pet, karakter itu bisa diam, berbalik, dan berjalan di browser maupun desktop. Gambar dan video bisa dibuat menggunakan kunci APIYI yang sama.
Mari lihat karakter paus versi aslinya:
Respons saat diklik: melompat dengan gembira. Sumber: github.com/PC2005-cloud/dsh-pet, aset tidak boleh digunakan untuk tujuan komersial
Paus meniup gelembung. Sumber: github.com/PC2005-cloud/dsh-pet, aset tidak boleh digunakan untuk tujuan komersial
Poin utama hewan peliharaan desktop AI: tiga langkah, alat, dan model
dsh-pet memosisikan dirinya sebagai “paket tiga”: petunjuk (resep untuk membuat animasi dengan AI), rangkaian pembuatan aset (pipeline untuk mengubah video sumber menjadi animasi transparan), dan plugin (hewan peliharaan yang berjalan di DSH). Artikel ini hanya mengganti alat untuk proses pembuatan di bagian awal. Resep petunjuk, rangkaian aset, dan plugin tetap menggunakan versi asli dari repositori. Seedance dibuat oleh ByteDance dan tercantum dengan label “Sedang laris” di daftar model video APIYI.
| Langkah | Alat (utamakan antarmuka grafis) | Model |
|---|---|---|
| ① Menentukan karakter | APIYI Image Master | nano-banana-2 |
| ② Membuat gerakan berlatar hijau (uji coba) | Halaman web iCover AI | doubao-seedance-2-0-mini-260615 |
| ② Membuat gerakan berlatar hijau (lanjutan) | Halaman web iCover AI | doubao-seedance-2-0-fast-260128 |
| ② Membuat gerakan berlatar hijau (final) | Halaman web iCover AI | doubao-seedance-2-0-260128 (standar) |
| ② Membuat gerakan berlatar hijau (generasi terbaru) | Halaman web iCover AI | doubao-seedance-2-5-260628 |
| ③ Menghapus latar dan memasang hewan peliharaan | Skrip rangkaian aset repositori / Premiere + pengelolaan plugin DSH | Tidak ada |
Gunakan mini untuk uji coba, fast untuk tahap lanjutan, dan versi standar untuk hasil final. Generasi terbaru adalah 2.5. Ada juga spesifikasi uji coba yang lebih ringan: mini 480p, 4 detik.
Mengapa harus menggunakan latar hijau dan posisi berdiri yang tetap? Rangkaian aset mengandalkan warna hijau untuk penghapusan latar berbasis kroma dan posisi yang seragam untuk normalisasi. Jika posisi karakter bergeser sedikit saja di salah satu klip, hewan peliharaan akan terlihat “berpindah tempat” saat berganti gerakan. Karena itu, gambar berdiri berlatar hijau pada langkah ① dan awalan petunjuk pada langkah ② harus selalu menggunakan posisi yang sama.
3 Langkah Cepat Membuat AI Desktop Pet: Tentukan Karakter → Gerakan Latar Hijau → Desktop Pet Transparan
Langkah ①: Tentukan karakter dengan Nano Banana (lembar desain + gambar berdiri di latar hijau)
Pertama, buat token baru di dasbor APIYI apiyi.com. Pilih penagihan «utamakan bayar sesuai pemakaian», lalu centang grup default dan grup SeeDance2. Jika grup SeeDance2 tidak dicentang, pemanggilan Seedance akan menampilkan pesan «Model ini tidak memiliki saluran yang tersedia». Satu token yang mencakup grup default dan SeeDance2 bisa digunakan bersama Nano Banana. Setelah itu, buka APIYI Image Master di imagen.apiyi.com, simpan kunci API ini, lalu pilih model nano-banana-2. Nama tombol bisa berbeda—ikuti yang ditampilkan di halaman.
Pada langkah ini, buat dua gambar. Berikut saran untuk proses penyuntingannya:
- Gambar pertama: lembar desain karakter. Jelaskan penampilan karakter dalam petunjuk, seperti warna rambut, pakaian, dan aksesori khas. Minta tampilan depan, samping, dan belakang karakter yang sama disusun berdampingan dengan latar polos. Buat beberapa gambar, lalu pilih yang paling sesuai dengan tampilan yang diinginkan untuk dijadikan acuan.
- Gambar kedua: karakter berdiri menghadap depan dengan latar hijau, rasio 16:9. Unggah lembar desain sebagai gambar referensi, pilih rasio 16:9, lalu tulis petunjuk agar hanya ada satu karakter berdiri dengan pose standar menghadap depan, kedua tangan rileks di samping tubuh, latar berwarna hijau polos
#00FF00, tanpa bayangan, lantai, atau properti, dan karakter berada tepat di tengah secara horizontal. - Catatan desain (saran): Sebisa mungkin, hindari warna hijau pada karakter. Jika tidak, pakaian bisa ikut terhapus saat latar dihilangkan.
Kriteria pemeriksaan Langkah ①:
- Latar gambar benar-benar berwarna
#00FF00. Gunakan alat pemilih warna bawaan sistem untuk memeriksa beberapa titik pada latar; nilainya harus sama, tanpa gradasi atau bayangan. - Bagian atas kepala berada di sekitar 20% tinggi gambar, telapak kaki sekitar 85%, dan sisi kiri serta kanan karakter masing-masing sekitar 25% dan 75% lebar gambar.
- Gambar hanya menampilkan satu karakter berdiri menghadap depan. Sisakan ruang kosong minimal 10% di keempat sisi, dan pastikan rambut yang mencuat, ekor, serta ujung rok tidak terpotong.
Jika latar yang dibuat model bukan warna polos #00FF00, lanjutkan penyuntingan gambar tersebut di Image Master dan minta: «Ubah latar menjadi warna polos #00FF00». Kami belum menguji apakah cara ini selalu berhasil dalam sekali coba, jadi gunakan hasil pemeriksaan sebagai patokan.
Langkah ②: Buat video gerakan dengan latar hijau menggunakan Seedance
Untuk membuat video, gunakan iCover AI (icover.ai). Pilih Seedance di browser, unggah gambar, tempelkan petunjuk, lalu pilih durasi dan resolusi. Tidak perlu menulis kode. Keunggulan utama Seedance adalah fitur bingkai awal dan akhir: unggah 2 gambar sebagai bingkai awal dan bingkai akhir (role-nya first_frame / last_frame). Kita akan mengunggah gambar berdiri menghadap depan dengan latar hijau dari Langkah ① sebagai bingkai awal sekaligus bingkai akhir. Dengan begitu, posisi berdiri di awal dan akhir video akan sama, sehingga animasi bisa berulang tanpa jeda yang terlihat. Jika halaman menyediakan dua slot unggah untuk bingkai awal dan akhir, unggah gambar berdiri yang sama ke keduanya. Ikuti nama tombol yang ditampilkan di halaman.
Saat memilih model dan mengisi parameter, ingat beberapa hal berikut:
- Model: mini adalah doubao-seedance-2-0-mini-260615, fast adalah doubao-seedance-2-0-fast-260128, versi standar adalah doubao-seedance-2-0-260128, dan generasi terbaru adalah doubao-seedance-2-5-260628.
- Ketiga mode tidak bisa dipakai bersamaan: hanya pilih salah satu, yaitu bingkai awal dan akhir, hanya bingkai awal, atau beberapa gambar referensi. Kita menggunakan mode bingkai awal dan akhir.
- Rasio aspek mengikuti gambar bingkai awal: Karena itu, gambar berdiri dari Langkah ① harus berasio 16:9. Untuk mode bingkai awal dan akhir pada versi 2.5, rasio aspek harus diatur ke
adaptive. Jika menetapkan rasio secara manual, permintaan akan menghasilkan error 400. - Durasi: versi 2.0 mendukung durasi 4–15 detik. Gunakan durasi 10 detik dari resep aslinya. Jika durasi tidak diisi, versi 2.0 akan memakai 5 detik secara default, sedangkan versi 2.5 akan memilih durasi secara otomatis. Hasilnya mungkin dua kali lebih panjang dari perkiraan, jadi pilih 10 detik secara eksplisit.
- Resolusi: tersedia pilihan 480p, 720p, dan 1080p. Resolusi maksimal untuk mini dan fast adalah 720p. Karena ukuran pemutaran hewan peliharaan desktop hanya 640×360, disarankan mencoba dengan 480p, lalu menggunakan 720p untuk hasil akhir (saran editor).
- Audio: audio aktif secara default. Karena tidak diperlukan untuk hewan peliharaan desktop, atur
generate_audiokefalseuntuk menonaktifkannya.
Tulis petunjuk berdasarkan resep di prompts/桌面宠物 10 秒动作提示词.md dalam repositori dsh-pet. Setiap bagian terdiri dari awalan umum, lalu diikuti uraian gerakan per detik. Gunakan tabel berikut untuk memeriksa batasan pada awalan umum:
| Batasan | Ketentuan resep | Dampak jika tidak dipatuhi |
|---|---|---|
| Posisi | Bagian atas kepala sekitar 20%, telapak kaki sekitar 85%, sisi kiri dan kanan sekitar 25% dan 75%. Proporsi harus persis sama di setiap bagian. | Posisi hewan peliharaan akan melompat saat gerakan berganti. |
| Latar hijau | Rasio 16:9, warna #00FF00 polos, tanpa bayangan, benda lain, gradasi, atau bingkai. Nilai warna harus sama di setiap bagian. |
Tepi hasil penghapusan latar bisa tersisa atau bagian yang salah ikut terhapus. |
| Margin aman | Bagian tubuh dan semua properti atau efek harus berjarak ≥10% dari keempat tepi bingkai. | Bagian tepi animasi akan terpotong. |
| Titik jangkar | Posisi kedua telapak kaki harus tetap di tengah layar. Karakter hanya boleh berputar atau melompat di tempat. | Karakter bergeser dan posisinya tidak sejajar setelah dinormalisasi. |
| Bingkai awal dan akhir harus sama | Unggah gambar standar karakter berdiri menghadap depan yang sama sebagai bingkai awal dan akhir. Pada detik terakhir, karakter harus kembali sepenuhnya ke pose yang sama. | Animasi akan tersendat saat berulang. |
| Properti: tidak ada → muncul → tidak ada | Bingkai awal tanpa properti. Properti muncul saat gestur sihir membentuknya, lalu berubah menjadi titik cahaya dan menghilang sebelum animasi berakhir. | Properti akan tertinggal di bingkai awal atau akhir. |
| Benda besar | Letakkan properti besar tepat di depan atau di atas karakter. Jika tidak muat, perkecil menjadi versi chibi. Jangan sekali-kali menggeser karakter. | Karakter terdorong keluar dari posisi semula. |
Setiap bagian pada resep aslinya berdurasi 10 detik. Karena rentang durasi Seedance 2.0 adalah 4–15 detik, uraian per detiknya bisa langsung digunakan tanpa diatur ulang.
Pose idle Paus-chan versi asli, dengan posisi berdiri sebagai patokan standar. Sumber: github.com/PC2005-cloud/dsh-pet, materi ini dilarang untuk penggunaan komersial.
Hal penting terkait posisi:
- Puncak kepala berada sekitar 20% dari tinggi gambar, sedangkan telapak kaki sekitar 85%
- Tepi kiri dan kanan berada sekitar 25% dan 75%
- Sisakan ruang kosong 10% di keempat sisi
- Latar belakang berwarna hijau polos
#00FF00 - Posisi pijakan kedua kaki tidak pernah berubah
Perubahan properti dari “tidak ada → ada → tidak ada” paling mudah keliru. Perhatikan cara versi asli melakukannya:
Kubus Rubik muncul begitu saja, lalu menghilang setelah dimainkan. Awal dan akhir sama-sama menggunakan pose berdiri yang rapi. Sumber: github.com/PC2005-cloud/dsh-pet, materi ini dilarang untuk penggunaan komersial.
Ada beberapa hal yang perlu diwaspadai dalam alur Seedance ini. Tabel berikut dirangkum dari dokumentasi Seedance APIYI:
| Kendala | Keterangan di dokumentasi | Solusi |
|---|---|---|
| Grup SeeDance2 tidak dicentang | Muncul pesan “Model ini tidak memiliki saluran yang tersedia” | Centang grup default dan SeeDance2 pada token, lalu pilih penagihan berdasarkan penggunaan |
| Durasi tidak ditentukan secara eksplisit | Jika tidak dikirim, 2.0 secara default memilih 5 detik, sedangkan 2.5 memilih durasi secara cerdas dan bisa menggandakannya | Pilih 10 detik secara eksplisit |
| Rasio pada frame awal dan akhir 2.5 ditetapkan secara tetap | Rasio aspek harus adaptive, jika tidak akan muncul error 400 |
Dalam mode frame awal dan akhir, pilih rasio aspek adaptive |
| Tautan langsung kedaluwarsa setelah 24 jam | Tautan unduhan langsung hasil pembuatan hanya berlaku selama 24 jam | Unduh segera setelah status berubah menjadi succeeded |
| Audio disertakan secara default | Jika tidak dimatikan, akan ada trek audio yang tidak diperlukan | Jika tidak diperlukan, atur generate_audio ke false |
| Memilih 1080p untuk mini / fast | Resolusi maksimum kedua model ini adalah 720p. Permintaan akan gagal, tetapi biaya tidak dikenakan | Untuk 1080p, gunakan versi standar atau 2.5 |
| Mencampur mode | Mode frame awal dan akhir, frame awal saja, serta beberapa gambar referensi tidak bisa digunakan bersamaan | Gunakan satu mode saja setiap kali. Artikel ini menggunakan frame awal dan akhir |
Dua detail tambahan: tugas yang gagal bisa dicoba ulang; file MOV keluaran 2.5 tidak memiliki kanal transparan, jadi tetap perlu menghapus latar hijau pada langkah ③.
Urutan kerja yang disarankan: gunakan mini, 480p, dan 10 detik terlebih dahulu untuk membuat klip “idle”. Pastikan pose berdiri di awal dan akhir sama, serta posisinya tidak bergeser. Setelah itu, buat 12 gerakan dasar dan ambil masing-masing dua hasil untuk memilih yang terbaik. Terakhir, gunakan petunjuk yang sudah disetujui dengan resolusi 720p atau versi standar untuk menghasilkan materi final.
Kriteria penerimaan langkah ②:
- Dua frame pertama dan terakhir video sama-sama menampilkan pose berdiri menghadap depan yang standar, sesuai dengan pose pada gambar frame awal dan akhir yang dimasukkan
- Latar belakang tetap hijau polos sepanjang video, karakter tidak bergeser ke kiri atau kanan, dan properti tidak muncul di frame awal maupun akhir
- Simpan setiap gerakan sebagai file MP4 dengan nama gerakannya, misalnya
待机.mp4
🚀 Saran untuk mulai dengan cepat: Langkah ① dan ② bisa dilakukan dengan satu token saja. Cukup centang grup default dan SeeDance2. Jika nanti ingin beralih dari antarmuka grafis ke pembuatan massal lewat skrip, isi
base_urlpada antarmuka yang kompatibel dengan OpenAI menggunakanhttps://api.apiyi.com/v1. Skrip Seedance menggunakanPOST /seedance/api/v3/contents/generations/taskspada domain yang sama. Jangan gunakan/v1/videos, karena resolusinya tidak diteruskan sepenuhnya melalui jalur tersebut.
Langkah ③: Hapus latar, ubah menjadi WebM transparan, lalu pasang ke dsh-pet
Persiapan: instal plugin (antarmuka grafis). Buka aplikasi desktop DSH, lalu masuk ke halaman “Manajemen Plugin”. Ketik dsh-pet di kolom instalasi dan instal plugin. Setelah selesai, aplikasi desktop harus dibuka ulang agar plugin bisa digunakan. Secara default, peliharaan akan muncul di browser (pojok kanan atas) dan desktop sekaligus. Jika komputer belum memiliki Electron, plugin akan mengunduhnya secara otomatis di latar belakang. Prosesnya bisa memakan waktu mulai dari puluhan detik hingga beberapa menit. Jika peliharaan muncul dua kali, itu normal. Di halaman pengaturan, pilih “Browser saja” atau “Desktop saja” dari menu tarik-turun “Lokasi tampilan”.
Setelah terpasang, gadis paus akan muncul di antarmuka DeepSeek Harness. Sumber: github.com/PC2005-cloud/dsh-pet, materi dilarang digunakan untuk tujuan komersial
Apa yang akan dilakukannya setelah terpasang: Gadis paus versi asli akan berganti animasi mengikuti status DSH. Berikut empat contoh situasi:
Status bekerja: berpikir dengan gelembung. Sumber: github.com/PC2005-cloud/dsh-pet, materi dilarang digunakan untuk tujuan komersial
Menulis kode. Sumber: github.com/PC2005-cloud/dsh-pet, materi dilarang digunakan untuk tujuan komersial
Memakan Token. Sumber: github.com/PC2005-cloud/dsh-pet, materi dilarang digunakan untuk tujuan komersial
Terangkat saat diseret dengan mouse. Sumber: github.com/PC2005-cloud/dsh-pet, materi dilarang digunakan untuk tujuan komersial
Setelah pet pack untuk karakter buatan sendiri disiapkan, karakter itu juga bisa melakukan animasi yang sama, seperti diam dan terseret.
Metode penghapusan latar A (default, memerlukan baris perintah). Jalankan perintah berikut secara berurutan, persis seperti di repositori:
- Kloning repositori ke komputer lokal melalui terminal:
git clone https://github.com/PC2005-cloud/dsh-pet.git - Pastikan semua dependensi tersedia. README mensyaratkan Python 3, ffmpeg, numpy, dan scipy. Paket Python dapat dipasang dengan
pip install numpy scipy(tambahan dari editor). Skrip akan mengutamakan ffmpeg yang ada di direktori.tools/dalam ruang kerja. - Letakkan file mp4 pilihan dari langkah ② di direktori
video/yang ditentukan dalam alur aset. Lihat README repositori untuk mengetahui lokasi direktorinya. - Masuk ke direktori
scriptsdi repositori. Perintah pertama mengisi masker watermark dan menyimpan hasilnya kestep01/:python watermark_step01.py - Perintah kedua menghapus latar berdasarkan rona HSV layar hijau dan membuatnya transparan. Hasilnya disimpan ke
step02/:python chroma_step02.py - Perintah ketiga menormalkan ukuran menjadi 2160×1215 dan mengatur posisi karakter agar berdiri di tengah. Hasilnya disimpan ke
step03/:python normalize_step03.py - Perintah keempat mengonversi video menjadi varian pemutaran berukuran 640×360 dan menyimpan hasilnya ke
step04/:python encode_thumbs.py
Di macOS, perintahnya mungkin python3. Langkah penutup masker watermark awalnya ditujukan untuk materi proyek asli. Kami belum memastikan apakah langkah ini bisa dilewati untuk materi Seedance, jadi sebaiknya tetap jalankan.
Rute B untuk keying (keying manual di Premiere): Semua langkah yang dilakukan penulis asli menggunakan rute ini. Lakukan keying secara manual di Premiere, lalu ekspor sebagai .mov transparan dengan alpha (misalnya ProRes 4444 with Alpha). Simpan file di pr/ dengan nama yang sama seperti nama aksinya, lalu jalankan python pr_import_step02.py untuk menggantikan hasil keying otomatis. Setelah itu, lanjutkan ke langkah 3 dan 4 di atas. Rute B mengganti proses keying yang paling rentan bermasalah dengan proses manual. Namun, menurut README, proses impor, normalisasi, dan transkode tetap dilakukan oleh skrip. Kami belum memastikan apakah seluruh proses bisa dilakukan tanpa menyentuh command line.
Masukkan ke pet pack (gunakan rute ini untuk karakter buatan sendiri). Contoh nama jenis: xiaoju.
- Buat folder: Buat folder
petdi$DSH_HOME/dsh-pet/, lalu buat folderxiaoju-animationdi dalampet. Salin semua file webm daristep04/ke folder tersebut.$DSH_HOMEadalah direktori data DSH. Lokasi default-nya belum kami pastikan, jadi gunakan lokasi DSH di komputer Anda. - Buat file: Buat
xiaoju-config.jsondi dalampet. Awalan namanya harus cocok dengan nama folder animasi. - Kolom
pets: Berupa array, setiap elemennya adalah satu instance. Isi dengan"id": "xiaoju-1"(tidak boleh sama denganmainmilik pet utama),"size": 462,"balanceEnabled": false,"display": "both", dan"position": { "corner": "top-right", "marginX": 24, "marginY": 100 }. - Kolom
animations: Kolomidle,turn,drag,clicks,moves,categories, daneventswajib diisi. Nilainya adalah nama animasi, dan setiap animasi harus memiliki file dengan nama yang sama. Contohnya,"idle": "待机"akan mencari file待机.webm. - Kolom
animationWeights: Semua kolom juga wajib diisi; nilainya tidak akan mengikuti pengaturan global. Sebagai acuan, gunakan nilai default: idle 10 / turn 5 / move 5, ditambah bobot kategori.
Struktur konfigurasinya sama dengan main-config.jsonc. Cara paling aman adalah menyalin struktur assets/config.jsonc dari dalam paket, lalu hanya mengubah nama animasi dan id. Materi hanya akan dicari di direktorinya sendiri. Jika tidak ditemukan, hasilnya 404; materi milik pet utama tidak akan digunakan.
Atur ukuran dan posisi: Lebar pet utama bisa diubah di halaman pengaturan, pada bagian “Konfigurasi pet desktop” (tinggi = lebar × 9/16). Di sana, Anda juga bisa mengatur posisi di salah satu dari empat sudut dan marginnya. Klik “Simpan” agar perubahan langsung diterapkan. Perlu diperhatikan, pet berbasis file tidak ditampilkan di halaman pengaturan. Untuk mengubah ukuran dan posisi pet pack, edit size dan position di xiaoju-config.json, lalu segarkan halaman agar perubahan terlihat.
Kriteria penerimaan langkah ③:
- Setiap aksi di
step04/memiliki satu file webm. - Tampil transparan, bukan berlatar hitam, saat dilihat di Chrome / Edge / Firefox. Jika file langsung diseret ke tab, halaman pemutar di beberapa browser mungkin berlatar gelap. Cara paling andal untuk memeriksanya adalah memasangnya sebagai pet desktop dan memastikan halaman web atau desktop di belakangnya terlihat di sekeliling pet.
- Posisi pet tidak bergeser saat berganti aksi, dan transisi dari akhir ke awal saat animasi berulang berjalan mulus.
Pemecahan Masalah AI Pet Desktop: Gangguan Umum dan Kapan Sebaiknya Tidak Menggunakannya
Tabel Pemecahan Masalah AI Pet Desktop
| Gejala | Penyebab | Solusi |
|---|---|---|
| Area transparan berubah menjadi latar hitam | Safari / WKWebView tidak mendukung alpha pada webm | Gunakan Chrome / Edge / Firefox. Untuk pet desktop versi asli macOS, gunakan file .mov di assets-mov pada bagian Release, lalu letakkan di main-animation/mov/ |
| Tepi objek masih kehijauan atau properti ikut terhapus | HSV otomatis bisa menyisakan tepi atau salah menghapus bagian yang rumit dan objek pihak ketiga; karakter juga mungkin memiliki bagian berwarna hijau | Gunakan rute B untuk aksi tersebut. Saat mendesain ulang, hindari warna hijau |
| Pet desktop berpindah posisi saat berganti aksi | Posisi atau ukuran karakter berbeda-beda di setiap segmen | Buat ulang segmen yang perbedaannya terlalu besar; pastikan normalize_step03 sudah dijalankan; samakan prefiks persis tanpa perubahan |
| Muncul pesan “Model ini tidak memiliki kanal yang tersedia” | Grup SeeDance2 belum dicentang untuk token | Di pengaturan token, centang grup default dan SeeDance2 |
| Video hanya berdurasi 5 detik atau durasinya menjadi dua kali lipat | Durasi tidak ditetapkan secara eksplisit; versi 2.0 menggunakan durasi default 5 detik, sedangkan versi 2.5 memilih durasi secara cerdas | Pilih durasi 10 detik secara eksplisit |
| Versi 2.5 menampilkan error 400 saat membuat video dengan frame awal dan akhir | Rasio aspek dikunci ke rasio tetap | Ubah rasio aspek menjadi adaptive |
| Frame awal dan akhir tidak cocok sehingga loop tersendat | Gambar yang diunggah untuk frame awal dan akhir berbeda, atau mode frame awal dan akhir tidak digunakan | Unggah gambar berdiri yang sama di kedua kolom. Jika masih tidak cocok, buat ulang—kalau gagal, buat ulang lagi |
| Tautan unduhan tidak bisa dibuka | Tautan langsung kedaluwarsa setelah 24 jam | Segera unduh dan simpan setelah status berubah menjadi succeeded |
| Model mini / fast error saat memilih 1080p | Resolusi maksimum kedua model ini adalah 720p | Kembali ke 720p. Error ini tidak dikenai biaya |
| Pet desktop tidak muncul atau aset menampilkan 404 | Konfigurasi tidak valid, direktori -animation tidak ada, id bentrok dengan pet utama, atau nama animasi tidak cocok dengan nama file |
Periksa semua poin tersebut dan lihat pesan error di konsol DSH |
| Gelembung saldo menampilkan “Penyedia layanan saat ini tidak mendukung pemeriksaan saldo” | APIYI belum terdaftar sebagai penyedia layanan saldo di dsh-pet | Ini normal; saldo APIYI tidak akan ditampilkan. Jika tidak ingin melihatnya, nonaktifkan opsi saldo |
Kapan Sebaiknya Tidak Menggunakannya
Membuat karakter sendiri bukan selalu pilihan terbaik. Sebaiknya pilih cara lain dalam situasi berikut:
- Hanya ingin pet desktop maid yang sudah jadi: Cukup pasang
dsh-petmelalui pengelola plugin. Anda tidak perlu membuat aset sendiri. - Untuk penggunaan komersial: Aset, petunjuk, dan video sumber dari pembuat aslinya tidak boleh digunakan secara komersial atau dijual. Anda juga perlu memastikan hak cipta karakter buatan sendiri, terutama jika desainnya merujuk pada IP yang sudah ada.
- Ingin menerbitkan karya turunan: Untuk karya turunan, modifikasi, atau perubahan tampilan, sertakan alamat GitHub pembuat asli
github.com/PC2005-cloud/dsh-petdi setiap materi pengenalan, pameran, atau distribusi.
FAQ Umum tentang Desktop Pet AI
Q1: Apakah kreator asli dsh-pet menggunakan Nano Banana dan Seedance?
Tidak. README menyebutkan bahwa materi proyek aslinya dibuat dengan Doubao dan semua gerakan dipisahkan dari latar secara manual menggunakan Premiere. Nano Banana tidak disebutkan, begitu juga versi model video yang digunakan. Seedance dan Doubao sama-sama berasal dari ByteDance, jadi alurnya lebih mendekati yang digunakan kreator asli. Namun, README tidak menyebutkan versi spesifik, jadi kita tidak bisa memastikan bahwa kreator asli menggunakan Seedance. Nano Banana dan Seedance adalah alternatif yang ditawarkan dalam artikel ini, sedangkan resep petunjuk dan alur materi tetap mengikuti isi repositori.
Q2: Gambar apa yang perlu diunggah sebagai frame awal dan akhir?
Unggah gambar berdiri menghadap depan dengan latar hijau berasio 16:9 dari langkah ① sebagai frame awal sekaligus frame akhir. Dengan begitu, video dimulai dan diakhiri dengan pose berdiri yang sama sehingga animasinya bisa tersambung mulus. Mode frame awal dan akhir, hanya frame awal, dan beberapa gambar referensi tidak bisa digunakan bersamaan—pilih salah satu saja. Rasio aspek mengikuti gambar frame awal. Untuk Seedance 2.5, jika menggunakan frame awal dan akhir, rasio aspek harus diatur ke `adaptive`; jika tidak, akan muncul error 400. Sebaiknya jangan mengunggah kolase tiga tampak, karena frame pertama bisa menampilkan tiga karakter.
Q3: Berapa durasi yang sebaiknya dipilih untuk Seedance?
Resep aslinya menggunakan durasi 10 detik untuk setiap klip. Seedance 2.0 mendukung durasi 4–15 detik, jadi pilih saja 10 detik. Pastikan durasinya diatur secara eksplisit: jika tidak diisi, durasi default Seedance 2.0 adalah 5 detik, sedangkan Seedance 2.5 akan memilih durasi secara otomatis dan hasilnya bisa dua kali lebih panjang. Untuk uji coba, kamu bisa mulai dengan mini 480p.
Q4: Bisakah satu kunci API digunakan untuk Nano Banana dan Seedance sekaligus?
Bisa. Buat token baru di APIYI apiyi.com, pilih opsi penagihan «Prioritaskan pembayaran sesuai pemakaian», lalu centang grup Default dan SeeDance2. Token yang sama bisa digunakan dengan 图片大师 dan iCover AI. Jika SeeDance2 tidak dicentang, akan muncul error «Tidak ada kanal yang tersedia untuk model ini». Sebaiknya mulai dengan nano-banana-2 dan mini 480p untuk memastikan alurnya berjalan, lalu tentukan gerakan mana yang layak dibuat dengan 720p atau versi standar.
Q5: Apakah saya bisa menyelesaikannya tanpa pengalaman menggunakan command line?
Pembuatan gambar dan video, pemasangan plugin, serta pengaturan ukuran bisa dilakukan sepenuhnya melalui antarmuka grafis. Pemisahan latar bisa dilakukan secara manual menggunakan Premiere (alur B), tetapi menurut README, proses impor, normalisasi, dan konversi format selanjutnya tetap menggunakan skrip. Jika mengalami kendala menyiapkan lingkungan, kamu bisa menyelesaikan dua langkah pertama menggunakan alat grafis APIYI, lalu meminta bantuan teman yang terbiasa dengan command line untuk menjalankan empat perintah terakhir.
Q6: Apakah desktop pet yang sudah dibuat boleh digunakan untuk tujuan komersial?
Kode dsh-pet menggunakan lisensi MIT, tetapi animasi, petunjuk, dan video sumber dari kreator aslinya tidak boleh digunakan untuk tujuan komersial. Penggunaan karakter buatan sendiri yang dibuat dengan Nano Banana dan Seedance untuk tujuan komersial bergantung pada desain karakter dan ketentuan layanan model. Kamu perlu memastikannya sendiri; kami tidak bisa menentukannya untukmu.
Ringkasan AI Desktop Pet: Poin Penting dan Referensi
Poin Penting AI Desktop Pet
- Pilihan alur kerja: Nano Banana + Seedance adalah alternatif pengganti. Penulis aslinya menggunakan Doubao dan Premiere, sedangkan Seedance dan Doubao sama-sama berasal dari ByteDance.
- Poin penting langkah ①: Gunakan satu gambar karakter berdiri menghadap depan, rasio 16:9, dengan latar polos
#00FF00. Posisikan kepala sekitar 20% dari atas dan kaki sekitar 85% dari atas. - Poin penting langkah ②: Gunakan gambar berdiri yang sama sebagai frame awal dan frame akhir. Pakai resep 10 detik apa adanya, dengan pose berdiri menghadap depan yang sama di kedua ujung.
- Kesalahan yang paling sering terjadi: Lupa mencentang grup SeeDance2 pada token, atau tidak menetapkan durasi 10 detik secara eksplisit.
- Poin penting langkah ③: Jalankan keempat skrip secara berurutan. Isi bagian
animationsdan bobot di pet pack dengan lengkap. - Cara uji coba: Mulai dengan mini 480p untuk memastikan semuanya berjalan. Setelah hasilnya memuaskan, lanjutkan ke 720p atau versi standar.
- Cara memulai: Gunakan satu token yang mengutamakan pembayaran sesuai pemakaian, lalu centang grup default dan SeeDance2 agar bisa membuat gambar dan video.
Ringkasan
Membuat AI desktop pet sendiri pada dasarnya berarti mengganti alat pembuat dalam tiga komponen dsh-pet: «petunjuk → alur aset → plugin». Nano Banana digunakan untuk menetapkan karakter dan posisinya, Seedance membuat gerakan berlatar hijau sesuai resep, sedangkan alur aset repositori menghapus latar dan menormalkan hasilnya. Bagian yang paling perlu diperhatikan adalah posisi karakter dan konsistensi frame awal serta akhir. Jika dua hal ini beres, penghapusan latar dan perakitan berikutnya pada dasarnya hanya pekerjaan rutin.
Sebaiknya mulai dengan satu gerakan, yaitu «idle», dan jalankan seluruh alur sampai tuntas. Pastikan latarnya transparan, posisi karakter tidak bergeser, dan transisi frame awal serta akhir berjalan mulus. Setelah itu, baru buat gerakan lainnya secara massal. Disarankan untuk mencoba terlebih dahulu dengan mini 480p melalui APIYI apiyi.com, lalu tentukan kualitas hasil akhir setelah efeknya terverifikasi.
Referensi
- Repositori dsh-pet: README proyek, resep petunjuk, dan skrip alur aset
- Tautan:
github.com/PC2005-cloud/dsh-pet -
Keterangan: Lihat README untuk panduan instalasi, konfigurasi pet pack, dan ketentuan lisensi. Jika membuat karya turunan, cantumkan alamat ini.
-
DeepSeek Harness: Aplikasi host untuk dsh-pet
- Tautan:
github.com/deepseek-ai/deepseek-harness -
Keterangan: Tersedia dalam dua bentuk, yaitu aplikasi desktop dan dsh web.
-
Dokumentasi APIYI Seedance 2: Model, frame awal dan akhir, durasi, resolusi, serta aturan parameter
- Tautan:
docs.apiyi.com(halaman Seedance 2) - Keterangan: Kendala Seedance yang dibahas dalam artikel ini merujuk pada dokumentasi tersebut.
Penulis: Tim Teknis APIYI
Diskusi teknis: Jika mengalami masalah antarmuka saat membuat aset desktop pet, hubungi kami melalui beranda APIYI apiyi.com.
