Worlds

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 AssetsCopy Anchor Link

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.

Akses catatan media dan dunia diperiksa berdasarkan organisasi pemilik kunci API. Tinjau opsi permission model sebelum berbagi; URL aset atau penampil dapat memiliki aturan akses sendiri.

Buat Dan PollingCopy Anchor Link

Respons create menyertakan ID tugas publik dan biasanya poll_url. Simpan ID itu sebelum menampilkan progress, lalu ikuti poll_url atau GET /v1/tasks/{id} 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 SelesaiCopy Anchor Link

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 UmumCopy Anchor Link

• 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 APICopy Anchor Link