> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Worlds

> Buat Worlds yang dapat dijelajahi, unggah prompt media, polling tugas, dan kelola Worlds yang selesai.

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/{id} sampai tugas completed atau failed.

```bash theme={null}
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](/id/api-reference/worlds/create-world)                               |
| Ambil Status World         | [Ambil Status World](/id/api-reference/worlds/get-world-status)                   |
| Siapkan Upload Media Asset | [Siapkan Upload Media Asset](/id/api-reference/worlds/prepare-media-asset-upload) |
| Ambil Media Asset          | [Ambil Media Asset](/id/api-reference/worlds/get-media-asset)                     |
| Daftar Worlds              | [Daftar Worlds](/id/api-reference/worlds/list-worlds)                             |
| Ambil World                | [Ambil World](/id/api-reference/worlds/get-world)                                 |
| Hapus World                | [Hapus World](/id/api-reference/worlds/delete-world)                              |
| Pekerjaan Async            | [Pekerjaan Async](/id/guides/async-jobs-polling)                                  |
| Panduan 3D Generation      | [Panduan 3D Generation](/id/guides/3d-generation)                                 |