Catatan penulis: Dengan Qwen3.5-4B-GLB-3D-Coder sebagai contoh, artikel ini membongkar alur kerja lapisan perantara kode “teks → Three.js → GLB” dan memberikan langkah operasional yang dapat diterapkan.
Membuat Model Bahasa Besar langsung menghasilkan file 3D yang dapat digunakan adalah masalah yang sering dihadapi banyak pengembang independen dan tim game kecil. Sebuah model fine-tune komunitas berparameter 4B menawarkan pendekatan lain: minta model menulis kode Three.js, lalu ekspor GLB dari browser, memisahkan pembuatan dan ekspor menjadi dua langkah.
Ini bukan sekadar daftar alat text-to-3D lainnya. Aset yang diekspor Qwen3.5-4B-GLB-3D-Coder sudah dapat diimpor ke editor Godot, dan pengembang komunitas Naoki Kishida bahkan membuat demo RPG 3D yang dapat dimainkan menggunakan aset yang dihasilkan model ini. Artikel ini berfokus pada metode rekayasa yang dapat digunakan kembali di balik alur tersebut.
Nilai inti: Setelah membaca artikel ini, Anda akan memahami mengapa lapisan perantara kode efektif, dan mempelajari cara menjalankan alur lengkap dari petunjuk hingga aset Godot secara end-to-end di lokal atau cloud.
Poin-poin Inti Lapisan Kode Perantara Three.js
Lapisan kode perantara artinya: model tidak langsung mengeluarkan file biner final, melainkan mengeluarkan sebuah program yang bisa dijalankan, lalu program tersebut yang menghasilkan produk akhir. Dalam kasus ini, model mengeluarkan satu file HTML mandiri yang berisi scene Three.js dan tombol “Export GLB”.
| Poin | Penjelasan | Nilai bagi Developer |
|---|---|---|
| Output model | Satu file HTML yang berisi scene Three.js dan tombol ekspor | Bisa langsung dibaca dan dimodifikasi, bukan file kotak hitam |
| Produk akhir | GLB diunduh setelah mengeklik tombol di browser | Dapat diimpor ke Godot dan alat lain yang mendukung GLB |
| Cakupan pelatihan | Mencakup karakter, senjata, kendaraan, bangunan modular, dan total 25 bidang aset game | Satu alat bisa menutupi sebagian besar kebutuhan placeholder di tahap prototipe |
| Cara menjalankan | Menyediakan dua versi kuantisasi GGUF: Q4_K_M dan Q8_0 | Bisa dijalankan secara lokal lewat LM Studio dan sejenisnya |
| Posisi kualitas | Aset game low-poly, bukan untuk produksi realistis atau sekelas film | Cocok untuk prototipe, placeholder, dan proyek bergaya |
Perlu dijelaskan bahwa Qwen3.5-4B-GLB-3D-Coder adalah versi pratinjau independen hasil fine-tuning developer CCORE berbasis Qwen/Qwen3.5-4B, bukan rilis resmi Qwen. Menurut model card-nya, sebagian besar hasil generasi bisa langsung dipakai pada percobaan pertama, terutama untuk prompt berbahasa Inggris, tetapi sebagian aset masih perlu dicoba ulang atau kode-nya dimodifikasi manual.
Alur Kerja Lapisan Kode Perantara Three.js
Seluruh rantai prosesnya bisa dirangkum dalam enam langkah: memasukkan deskripsi, menghasilkan HTML, menyimpan file, pratinjau di browser, mengekspor GLB, lalu mengimpor ke engine. Dua langkah pertama diserahkan ke model, ekspor dilakukan oleh kode yang berjalan di browser, sehingga model tidak perlu menuliskan sendiri konten biner GLB.
Jika aset perlu bergerak, misalnya pintu yang terbuka, system prompt akan meminta model menambahkan animasi dan menyertakannya dalam GLB yang diekspor. Tanpa permintaan eksplisit, model secara default menghasilkan aset statis. Jadi, kebutuhan animasi harus dituliskan dengan jelas di prompt.
5 Pelajaran Alur Kerja dari Lapisan Perantara Kode Three.js
Perbandingan di bawah ini adalah penilaian teknis kami berdasarkan kasus ini, bukan hasil benchmark. Setiap pendekatan pembuatan 3D punya cakupan yang berbeda; di sini kami hanya membandingkan perbedaan struktural antara dua pendekatan.
| Dimensi perbandingan | Menghasilkan file 3D secara langsung | Lapisan perantara kode Three.js |
|---|---|---|
| Output model | Mesh atau aset biner | Kode teks yang dapat dibaca |
| Penanganan saat terjadi kesalahan | Biasanya perlu dibuat ulang atau masuk ke alat pemodelan untuk diperbaiki | Geometri, material, dan animasi dapat dimodifikasi sebagian |
| Pratinjau sebelum ekspor | Bergantung pada alat penampil khusus | Buka HTML di browser untuk melihatnya |
| Dukungan animasi | Tergantung model dan pipeline tertentu | Dapat dijelaskan lewat kode dan diekspor bersama GLB |
| Cakupan yang dikuasai | Tergantung solusi spesifik | Aset low-poly dengan struktur yang jelas |
| Keterbatasan utama | Hasil sulit diedit secara granular | Aset detail tinggi atau realistis di luar cakupan desain |
Pelajaran pertama: pilih lapisan representasi yang menjadi kekuatan model. Kekuatan model coding adalah menghasilkan teks terstruktur, dan Three.js tepat mengubah aset 3D menjadi masalah pemrograman. Model ini hanya memiliki 4B parameter, tetapi mampu menangani tugas pembuatan aset; kuncinya adalah tugas diubah ke bentuk yang bisa diprosesnya.
Pelajaran kedua: buat hasil antara dapat diperiksa. File HTML adalah hasil generasi sekaligus pintu masuk untuk debugging. Ketika material salah tempat atau animasi berulang bermasalah, sering kali cukup diperbaiki manual tanpa harus membuat ulang dari awal; ini sangat menurunkan biaya satu kali kegagalan.
Pelajaran ketiga: serahkan langkah terakhir ke alat deterministik. Detail format file tidak perlu menjadi tanggung jawab model probabilistik byte demi byte. Ekosistem Three.js sendiri punya kemampuan ekspor seperti GLTFExporter, jadi model cukup menulis logika pemanggilan ekspor. Umumnya, semakin banyak tahap yang diserahkan ke alat yang matang, semakin kecil ketidakpastian di tingkat format.
Pelajaran keempat: tugas sempit ditambah konvensi tetap lebih praktis daripada kemampuan generalisasi. Petunjuk sistem model ini tetap, dan bentuk output dibatasi ketat ke satu file HTML. Pada saat yang sama, data pelatihan di 25 domain menjamin cakupan jenis aset. Batas tugasnya jelas, sehingga model kecil pun punya ruang cukup untuk menunjukkan kemampuannya.
Pelajaran kelima: verifikasi di tujuan sebenarnya. Terlihat bagus di browser bukan berarti aset bisa dipakai; kartu model juga menampilkan hasil setelah diimpor ke editor Godot. Target langkah berikutnya penulis juga terkait: mewujudkan pembuatan sekali jalan yang andal, serta otomatis menyelesaikan pembuatan, pengujian, dan optimalisasi dalam kerangka Agent.
Pendekatan ini tidak terbatas pada aset game. Skrip OpenSCAD dapat menghasilkan model CAD, Blender Python dapat menggerakkan alur pemodelan, SVG dan Mermaid dapat mendeskripsikan grafis dan diagram. Selama format target sulit dihasilkan secara langsung, kita bisa bertanya: adakah lapisan kode yang dapat menghasilkannya secara stabil?
Saran teknis: Jika ingin membandingkan efek berbagai model dalam menulis Three.js, Anda dapat memanggil beberapa model dengan set petunjuk yang sama melalui APIYI apiyi.com, lalu mengevaluasinya secara seragam menggunakan daftar pemeriksaan di bagian berikutnya.
Mulai Cepat Lapisan Kode Menengah Three.js: Deployment Lokal
Berikut ini kita gunakan LM Studio sebagai contoh, dan sepanjang proses tidak perlu menulis kode tambahan sama sekali. LM Studio bisa langsung memuat model GGUF; kamu bisa mencari Qwen3.5-4B-GLB-3D-Coder di browser model, atau mengunduh filenya dari Hugging Face lalu memuatnya secara lokal.
Langkah Pertama: Pilih Versi Kuantisasi GGUF
Kartu model tidak mencantumkan kebutuhan VRAM secara pasti, jadi silakan uji sendiri sesuai perangkat kerasmu. Inferensi di CPU juga bisa dilakukan, tetapi kecepatannya akan jauh lebih lambat.
| Versi | Karakteristik | Skenario yang Disarankan |
|---|---|---|
| Q4_K_M | File lebih kecil, penggunaan memori lebih rendah, inferensi lebih cepat, kualitas sedikit menurun | GPU laptop, perangkat dengan spesifikasi terbatas, iterasi cepat |
| Q8_0 | File lebih besar, lebih mendekati presisi penuh | VRAM melimpah, ingin meningkatkan tingkat keberhasilan aset kompleks pada percobaan pertama |
Perhatikan pembaruan versi: Kedua versi kuantisasi telah mengganti bobotnya pada 2 November 2026. Penulis menyebut kualitas visual meningkat signifikan, tetapi nama filenya tidak berubah. Jika kamu mengunduhnya sebelum tanggal tersebut, sebaiknya hapus lalu unduh ulang, kalau tidak kamu mungkin masih memakai versi lama.
Langkah Kedua: Konfigurasi System Prompt dan Parameter Sampling
Model ini di-fine-tune dengan format instruksi tertentu, jadi sebaiknya gunakan system prompt dari kartu model apa adanya, jangan diubah sendiri:
Create game assets for the Godot editor， which uses GLB files. Create whatever the user requests as a good-quality low-poly asset using only Three.js in one complete standalone HTML file. The HTML must show the asset and include an Export GLB button that downloads a working GLB. If the requested asset needs animation， add it and include the animation in the exported GLB； otherwise make it static.
Setelah menempelkannya ke kolom system message di LM Studio, atur parameter sampling yang direkomendasikan penulis. Nilai-nilai ini adalah titik awal yang dipakai penulis saat pengujian, bukan ketentuan wajib, dan bisa disesuaikan setelah semuanya berjalan lancar.
| Parameter | Nilai yang Disarankan | Lokasi Konfigurasi |
|---|---|---|
temperature |
0.8 | Parameter generasi LM Studio |
top_k |
40 | Parameter generasi LM Studio |
top_p |
0.95 | Parameter generasi LM Studio |
min_p |
0.0 | Parameter generasi LM Studio |
Langkah Ketiga: Hasilkan dan Ekspor GLB
Prompt pengguna harus singkat, spesifik, dan sebisa mungkin dalam bahasa Inggris. Kamu bisa mencoba Create a blue goblin brute atau Build a jungle siege platform terlebih dahulu; jika butuh animasi, tulis saja Create a wooden gate with an opening animation. Setelah itu ikuti urutan berikut:
- Kirim prompt, tunggu model mengeluarkan HTML lengkap.
- Simpan output tersebut sebagai file
.html. - Buka file tersebut di browser, pastikan aset ter-render dengan benar.
- Klik tombol “Export GLB”, unduh file
.glb. - Impor GLB ke Godot, atau ke tool lain yang mendukung format tersebut.
Jika halaman kosong, buka dulu developer tools browser dan periksa error di konsol. Sebagian skrip mungkin terkena batasan file lokal browser saat dibuka dengan klik dua kali; dalam kasus ini, jalankan python -m http.server di direktori file, lalu akses melalui alamat lokal.
Langkah Keempat: Verifikasi Aset Sesuai Checklist
Jangan hanya melihat pratinjau di browser. Sebaiknya periksa beberapa hal berikut untuk setiap aset:
- Struktur: Apakah komponennya lengkap, ada tidaknya pergeseran atau tumpang tindih yang jelas.
- Material: Apakah warna dan material tetap konsisten dengan pratinjau setelah diimpor ke engine.
- Animasi: Apakah animasi benar-benar tertulis ke dalam GLB dan bisa diputar di dalam engine.
- Ukuran dan Origin: Apakah proporsi dan titik poros sesuai kebutuhan scene; bagian ini mungkin perlu penyesuaian manual.
- Kemudahan Perbaikan: Untuk masalah kecil prioritaskan mengubah kode, untuk masalah struktural baru lakukan regenerasi.
Skema Akses Cloud untuk Lapisan Perantara Kode Three.js
Salah satu keuntungan lapisan perantara kode adalah ia tidak terikat pada satu model tertentu. Selama sebuah model mampu menulis Three.js yang bisa dijalankan, ia bisa masuk ke alur yang sama. Berdasarkan informasi publik, Qwen3.5-4B-GLB-3D-Coder saat ini didistribusikan dalam format GGUF dan terutama ditujukan untuk inferensi lokal; jika perangkat Anda kurang nyaman menjalankannya, atau Anda ingin membandingkan hasilnya dengan model coding umum, Anda bisa menggunakan API cloud.
APIYI menyediakan pemanggilan API untuk berbagai model, kompatibel dengan format antarmuka OpenAI dan Anthropic; klien yang sudah ada biasanya hanya perlu menyesuaikan alamat endpoint, kunci, dan nama model. Perlu diperhatikan bahwa ketersediaan pemanggilan cloud untuk model fine-tuning di atas silakan mengacu pada tampilan aktual di daftar model. Cara konfigurasi spesifiknya bisa dilihat di dokumentasi APIYI: docs.apiyi.com.
| Skema | Karakteristik utama | Skenario penggunaan | Dasar biaya | Platform yang tersedia |
|---|---|---|---|---|
| Model fine-tuning lokal | Di-fine-tune untuk aset GLB, bisa dipakai offline setelah diunduh | Membuat aset placeholder secara batch, butuh berjalan offline | Tanpa biaya per panggilan, perlu hardware sendiri | LM Studio dan alat penjalan GGUF lainnya |
| Model coding umum di cloud | Tidak butuh daya komputasi lokal, mudah berganti dan membandingkan | Perangkat terbatas, perlu mencoba petunjuk kompleks | Mengacu pada halaman harga APIYI | APIYI apiyi.com dan kanal resmi masing-masing model |
| Campuran lokal dan cloud | Volume besar dijalankan lokal, aset yang sulit diserahkan ke cloud | Tim yang ingin menyeimbangkan biaya dan tingkat keberhasilan | Bagian cloud mengacu pada halaman harga APIYI | Alat lokal dipadukan dengan platform API |
Langkah-langkah memanggil model pembuat Three.js melalui antarmuka API
- Buat API Key di konsol APIYI, lalu pastikan alamat endpoint yang berlaku dari dokumentasi, jangan menyalin mentah alamat dari tutorial pihak ketiga.
- Berdasarkan klien yang ada, pilih format antarmuka OpenAI atau Anthropic, lalu isi
base_urldan API Key. - Pilih model yang ingin diuji dari daftar model, dan isi namanya ke kolom
model. - Letakkan system prompt dari bagian sebelumnya ke dalam pesan system. Model umum belum di-fine-tune untuk tugas ini, jadi Anda bisa menambahkan batasan seperti “hanya keluarkan HTML lengkap”.
- Simpan respons sebagai file
.html; langkah pratinjau, ekspor, dan verifikasi setelahnya sama dengan skema lokal.
Layanan lokal LM Studio juga menyediakan antarmuka yang kompatibel dengan OpenAI. Jadi, Anda bisa memakai klien yang sama untuk beralih antara lokal dan cloud, cukup mengubah alamat endpoint dan nama model. Dengan begitu, tahap pratinjau, ekspor, dan verifikasi setelah lapisan perantara kode tidak perlu diubah.
Catatan penagihan: Harga satuan model, dasar penagihan input/output, dan harga cache bisa berubah. Artikel ini tidak mencantumkan angka spesifik dan selalu mengacu pada data aktual di halaman harga APIYI: https://docs.apiyi.com/models.
Pertanyaan yang Sering Diajukan (FAQ)
Q1: Apa itu alur kerja lapisan perantara kode Three.js?
Alur kerja ini maksudnya membuat model menulis program Three.js terlebih dahulu, lalu program tersebut merender dan mengekspor GLB — bukan meminta model langsung mengeluarkan file 3D. Dengan cara ini, hasilnya bisa dipratinjau dan diubah sebelum diekspor.
Q2: Apakah Qwen3.5-4B-GLB-3D-Coder bisa langsung menghasilkan GLB?
Tidak bisa. Keluarannya berupa file HTML mandiri yang harus dibuka di browser dan diklik tombol “Export GLB”-nya untuk mendapatkan file GLB.
Q3: Apakah GLB hasil ekspor hanya bisa dipakai di Godot?
Tidak. System prompt-nya memang menyasar alur kerja Godot, tetapi GLB adalah format universal yang juga bisa diimpor oleh Unity, Blender, dan viewer 3D berbasis web. Namun, hasil setelah impor tetap perlu diverifikasi satu per satu di masing-masing tool.
Q4: Skenario penggunaan apa yang paling cocok untuk model ini?
Model ini paling cocok untuk prototipe game bergaya low-poly dan aset placeholder, misalnya NPC, senjata, kendaraan, bangunan modular, dan trap. Kalau butuh aset final yang sangat kustom, tetap perkirakan adanya penyesuaian manual setelah impor.
Q5: Kalau tidak punya GPU yang memadai, bagaimana cara mencoba alur ini lewat API?
Anda bisa memanggil model coding dari daftar model melalui APIYI apiyi.com, lalu mengonfigurasi antarmuka berformat OpenAI atau Anthropic sesuai dokumentasi. Setelah model mengeluarkan HTML, pratinjau dan ekspor selanjutnya dilakukan di browser lokal.
Q6: Bagaimana biaya pemanggilan di cloud dihitung?
Harga satuan dan dasar penghitungan tiap model berbeda-beda, jadi silakan cek langsung halaman harga APIYI: https://docs.apiyi.com/models. Sebaiknya jalankan dulu dengan sedikit petunjuk, lalu perkirakan biaya berdasarkan pemakaian aktual.
Q7: Apakah file proyeksi visual wajib ada?
Tidak wajib. File proyeksi visual BF16 bersifat opsional dengan ukuran sekitar 644 MiB, digunakan untuk memasukkan gambar referensi di lingkungan yang mendukung Qwen3.5 multimodal GGUF. Kalau hanya memakai petunjuk teks, file ini tidak perlu diunduh.
Q8: Apa saja keterbatasan solusi ini saat ini?
Saat ini statusnya masih versi pratinjau, dataset pelatihannya lebih condong ke petunjuk sederhana, kemampuan generalisasinya terbatas untuk kebutuhan yang kompleks atau jarang, dan tidak ditujukan untuk aset realistis. Penulis berencana merilis dataset dan bobot Safetensors, serta melatih versi lebih besar dengan sekitar 100 ribu sampel dan panjang jendela konteks 8K hingga 128K token, tetapi materi tersebut belum dipublikasikan.
Poin-Poin Penting Lapisan Perantara Kode Three.js
- Ide inti: biarkan model menulis kode Three.js yang bisa dijalankan, lalu program mengekspor GLB.
- Keunggulan utama: hasil perantara bisa dipratinjau, dibaca, dan dimodifikasi sebagian, sehingga biaya kegagalan lebih rendah.
- Mulai secara lokal: LM Studio memuat GGUF, dipadukan dengan system prompt tetap dan parameter sampling yang direkomendasikan.
- Peringatan versi: bobot yang diunduh sebelum 2 November sebaiknya dihapus lalu diunduh ulang.
- Batas penggunaan: cocok untuk prototipe low-poly dan aset placeholder, tidak cocok untuk produksi realistis atau kelas film.
- Jalur cloud: dapat mengakses model melalui APIYI dengan format OpenAI atau Anthropic dan membandingkan hasilnya.
- Perluasan metode: skenario seperti Blender Python dan OpenSCAD juga bisa mengadopsi desain lapisan perantara ini.
Kesimpulan
Inspirasi dari Qwen3.5-4B-GLB-3D-Coder bukan hanya tentang model kecil yang mampu menghasilkan aset game, tetapi lebih pada bagaimana ia membagi ulang tanggung jawab antara model dan alat:
- Model bertanggung jawab atas ekspresi: mengubah deskripsi bahasa alami menjadi kode Three.js yang terstruktur jelas.
- Alat bertanggung jawab atas realisasi: browser dan logika ekspor menghasilkan file GLB standar.
- Validasi menentukan kelayakan: hanya setelah diimpor ke engine target dan lolos pemeriksaan, pekerjaan benar-benar dianggap selesai.
Sebaiknya mulai dengan menjalankan alur lengkap menggunakan satu prop statis sederhana, lalu secara bertahap menguji animasi dan aset yang lebih kompleks. Jika ingin membandingkan beberapa model cloud, Anda bisa memanggilnya secara terpadu melalui APIYI; cara integrasinya dapat dilihat di docs.apiyi.com, dan harga mengacu pada data aktual di https://docs.apiyi.com/models.
📚 Referensi
- Pengenalan Model Qwen3.5-4B-GLB-3D-Coder: Posisi model, 25 bidang aset, dan roadmap selanjutnya
- Tautan:
mindstudio.ai/blog/qwen3-5-4b-glb-3d-coder-model -
Keterangan: Cocok untuk memahami gambaran keseluruhan proyek dan contoh kasus dari komunitas
-
Panduan Menjalankan Qwen3.5-4B-GLB-3D-Coder Secara Lokal: Mekanisme generasi, versi kuantisasi, dan analisis kesesuaian penggunaan
- Tautan:
mindstudio.ai/blog/qwen3-5-4b-glb-3d-coder-local -
Keterangan: Cocok untuk menilai apakah model sesuai dengan kebutuhan proyek Anda
-
Panduan Konfigurasi LM Studio: System prompt, parameter sampling, dan langkah ekspor GLB
- Tautan:
mindstudio.ai/blog/run-qwen3-5-glb-3d-coder-locally -
Keterangan: Cocok untuk menyelesaikan deployment lokal langkah demi langkah
-
Dokumentasi dan Halaman Harga APIYI: Penjelasan integrasi API serta data harga model
- Tautan:
docs.apiyi.comdandocs.apiyi.com/models - Keterangan: Informasi konfigurasi API dan penagihan mengacu pada konten terbaru di halaman ini
Penulis: Tim Teknis APIYI
Diskusi Teknis: Jika ada pertanyaan selama proses integrasi, silakan hubungi kami melalui situs resmi APIYI di apiyi.com. Informasi lebih lengkap dapat dilihat di pusat dokumentasi docs.apiyi.com
