> ## 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

> Tạo Worlds có thể khám phá, tải prompt media, polling tác vụ và quản lý Worlds đã hoàn tất.

Tạo World tạo Marble Worlds có thể khám phá theo cách bất đồng bộ. Dùng Worlds khi đầu ra là môi trường người dùng có thể mở hoặc quay lại. Dùng tạo 3D khi bạn cần một asset mô hình độc lập.

## Đầu Vào Và Media Assets

Tác vụ World có thể bắt đầu từ văn bản, hình ảnh, nhiều hình ảnh hoặc video tùy theo model đã chọn và dạng yêu cầu. Với prompt media tái sử dụng, hãy chuẩn bị media asset trước rồi tham chiếu trong yêu cầu World. Media assets và Worlds đã hoàn tất chỉ khả dụng cho tài khoản của bạn.

## Tạo Và Poll

Phản hồi tạo gồm ID tác vụ công khai và thường có poll\_url. Lưu ID đó trước khi hiển thị tiến trình, rồi theo poll\_url hoặc GET /v1/tasks/{id} đến khi tác vụ completed hoặc 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"
  }'
```

## Quản Lý Worlds Đã Hoàn Tất

Dùng endpoint liệt kê và lấy Worlds cho Worlds đã hoàn tất trong tài khoản của bạn. Dùng endpoint trạng thái tác vụ cho tác vụ đang chờ hoặc thất bại. Chỉ xóa khi người dùng chủ động gỡ World đã tạo khỏi sản phẩm của bạn.

## Lỗi Thường Gặp

* Đừng giả định mọi World model đều hỗ trợ mọi loại đầu vào.
* Giữ URL ảnh hoặc video đã ký đủ lâu cho các lần dịch vụ thử tải lại.
* Lưu ID tác vụ trả về trước khi thử lại sau timeout.
* Dùng tạo 3D cho tệp mô hình có thể tải xuống thay vì Worlds có thể khám phá.

## Tham Chiếu API

| Chủ đề                   | Tham chiếu                                                                      |
| ------------------------ | ------------------------------------------------------------------------------- |
| Tạo World                | [Tạo World](/vi/api-reference/worlds/create-world)                              |
| Lấy Trạng Thái World     | [Lấy Trạng Thái World](/vi/api-reference/worlds/get-world-status)               |
| Chuẩn Bị Tải Media Asset | [Chuẩn Bị Tải Media Asset](/vi/api-reference/worlds/prepare-media-asset-upload) |
| Lấy Media Asset          | [Lấy Media Asset](/vi/api-reference/worlds/get-media-asset)                     |
| Liệt Kê Worlds           | [Liệt Kê Worlds](/vi/api-reference/worlds/list-worlds)                          |
| Lấy World                | [Lấy World](/vi/api-reference/worlds/get-world)                                 |
| Xóa World                | [Xóa World](/vi/api-reference/worlds/delete-world)                              |
| Tác Vụ Bất Đồng Bộ       | [Tác Vụ Bất Đồng Bộ](/vi/guides/async-jobs-polling)                             |
| Hướng Dẫn Tạo 3D         | [Hướng Dẫn Tạo 3D](/vi/guides/3d-generation)                                    |