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

> 生成可探索的 Worlds、上传媒体提示、轮询任务并管理已完成的 World。

World 生成会异步创建可探索的 Marble World。当输出是用户可以打开或再次访问的环境时使用 Worlds；如果需要可下载的单独模型资产，请使用 3D 生成。

## 输入与媒体资产

World 任务可根据所选模型和请求形态从文本、图片、多图或视频开始。可复用的媒体提示应先准备媒体资产，再在 World 请求中引用。媒体资产和完成后的 World 只对你的账户可用。

## 创建与轮询

创建响应包含公共任务 ID，通常也包含 poll\_url。展示进度前先保存这个 ID，然后跟随 poll\_url 或 GET /v1/tasks/{id}，直到任务 completed 或 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"
  }'
```

## 管理已完成的 Worlds

Worlds 列表和详情端点用于查看当前账户里已完成的 World。待处理或失败的生成任务请使用任务状态端点。只有用户明确删除产品里的生成 World 时才调用删除。

## 常见问题

* 不要假设每个 World 模型都支持所有输入类型。
* 签名图片或视频 URL 要保持足够长的有效期，覆盖服务端拉取重试。
* 超时后重试前，先保存并查询已返回的任务 ID。
* 需要可下载模型文件时使用 3D 生成，而不是 Worlds。

## API 参考

| 主题          | 参考                                                              |
| ----------- | --------------------------------------------------------------- |
| 创建 World    | [创建 World](/zh/api-reference/worlds/create-world)               |
| 获取 World 状态 | [获取 World 状态](/zh/api-reference/worlds/get-world-status)        |
| 准备媒体资产上传    | [准备媒体资产上传](/zh/api-reference/worlds/prepare-media-asset-upload) |
| 获取媒体资产      | [获取媒体资产](/zh/api-reference/worlds/get-media-asset)              |
| 列出 Worlds   | [列出 Worlds](/zh/api-reference/worlds/list-worlds)               |
| 获取 World    | [获取 World](/zh/api-reference/worlds/get-world)                  |
| 删除 World    | [删除 World](/zh/api-reference/worlds/delete-world)               |
| 异步任务        | [异步任务](/zh/guides/async-jobs-polling)                           |
| 3D 生成指南     | [3D 生成指南](/zh/guides/3d-generation)                             |