> ## 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 を生成し、メディアプロンプトをアップロードし、タスクを polling して完了済み World を管理します。

World 生成は探索可能な Marble World を非同期で作成します。ユーザーが開いたり再訪できる環境が出力の場合は Worlds を使います。単体のダウンロード可能なモデルアセットが必要な場合は 3D 生成を使います。

## 入力とメディアアセット

World タスクは、モデルとリクエスト形式に応じて、テキスト、画像、複数画像、動画から開始できます。再利用するメディアプロンプトは先に media asset を準備し、World リクエスト内で参照します。media asset と完成済み World は自分のアカウントでのみ利用できます。

## 作成と polling

作成レスポンスには公開タスク 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 の list/get は自分のアカウントで利用できる完了済み World 用です。pending または failed の生成タスクは task status endpoint を使います。delete はユーザーが生成 World を削除する意図を示した時だけ使います。

## よくある落とし穴

* すべての World モデルがすべての入力タイプを支援するとは限らない。
* 署名付き画像・動画 URL はサービス側取得の再試行に十分な有効期限を持たせる。
* timeout 後に再試行する前に、返された task ID を保存して確認する。
* ダウンロード可能なモデルファイルが必要なら Worlds ではなく 3D 生成を使う。

## API リファレンス

| トピック              | リファレンス                                                                   |
| ----------------- | ------------------------------------------------------------------------ |
| World を作成         | [World を作成](/ja/api-reference/worlds/create-world)                       |
| World 状態を取得       | [World 状態を取得](/ja/api-reference/worlds/get-world-status)                 |
| メディアアセットアップロードを準備 | [メディアアセットアップロードを準備](/ja/api-reference/worlds/prepare-media-asset-upload) |
| メディアアセットを取得       | [メディアアセットを取得](/ja/api-reference/worlds/get-media-asset)                  |
| Worlds 一覧         | [Worlds 一覧](/ja/api-reference/worlds/list-worlds)                        |
| World を取得         | [World を取得](/ja/api-reference/worlds/get-world)                          |
| World を削除         | [World を削除](/ja/api-reference/worlds/delete-world)                       |
| 非同期ジョブ            | [非同期ジョブ](/ja/guides/async-jobs-polling)                                  |
| 3D 生成ガイド          | [3D 生成ガイド](/ja/guides/3d-generation)                                     |