Worlds - TokenLab

Pembuatan World membuat Marble Worlds yang dapat dijelajahi secara async. Gunakan Worlds saat output berupa lingkungan yang bisa dibuka kembali pengguna. Gunakan 3D generation saat Anda membutuhkan asset model mandiri.

Input Dan Media Assets

Tugas World dapat dimulai dari teks, gambar, beberapa gambar, atau video sesuai model yang dipilih dan bentuk request. Untuk prompt media yang dapat digunakan ulang, siapkan media asset terlebih dahulu lalu referensikan di request World. Media assets dan Worlds yang selesai hanya tersedia untuk akun Anda.

Buat Dan Polling

Respons create menyertakan ID tugas publik dan biasanya poll_url. Simpan ID itu sebelum menampilkan progress, lalu ikuti poll_url atau GET /v1/tasks/ sampai tugas completed atau failed.

curl -X POST "https://api.tokenlab.sh/v1/worlds/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "marble-1.1",
    "prompt": "A quiet coastal town at sunset with narrow alleys and warm lights"
  }'

Kelola Worlds Selesai

Gunakan endpoint daftar dan detail Worlds untuk Worlds selesai yang tersedia di akun Anda. Gunakan endpoint status tugas untuk generasi yang pending atau failed. Hapus hanya ketika pengguna sengaja menghapus World dari produk Anda.

Kesalahan Umum

Jangan berasumsi setiap model World mendukung semua jenis input.
Pastikan URL gambar atau video bertanda tangan tetap valid cukup lama untuk retry pengambilan oleh layanan.
Simpan ID tugas yang dikembalikan sebelum mencoba ulang setelah timeout.
Gunakan 3D generation untuk file model yang dapat diunduh, bukan untuk Worlds yang dapat dijelajahi.

Referensi API

Topik	Referensi
Buat World	Buat World
Ambil Status World	Ambil Status World
Siapkan Upload Media Asset	Siapkan Upload Media Asset
Ambil Media Asset	Ambil Media Asset
Daftar Worlds	Daftar Worlds
Ambil World	Ambil World
Hapus World	Hapus World
Pekerjaan Async	Pekerjaan Async
Panduan 3D Generation	Panduan 3D Generation

Generasi Musik Generasi 3D