Worlds

World の一覧取得

TokenLab を通じて作成された完了済みの World Labs Marble world を一覧表示します

POST
/v1/worlds/list

現在の Workspace 内の完了した Marble World を一覧表示します。

保留中または失敗した生成タスクには GET /v1/tasks/{id} を使用してください。この一覧では、生成後に TokenLab がインデックスを作成した完了済みの world が返されます。

リクエストボディ

page_sizeintegerデフォルト: 20

返される world の数(1〜100)。

page_tokenstring

前回のレスポンスからのページネーショントークン。不透明な値(opaque value)として扱ってください。

statusstring

オプションのフィルター: SUCCEEDED、PENDING、RUNNING、または FAILED。このエンドポイントは完了した world を一覧表示します。他の3つの値を指定した場合は空のリストが返されます。進行状況を確認するには生成タスクをクエリしてください。

modelstring

オプションのモデルフィルター。提供が終了したモデルで作成された world にも一致します。

tagsarray

オプションのタグフィルター。タグの少なくとも1つを持つ world に一致します。

is_publicboolean

オプションの公開設定フィルター。

created_afterstring

この ISO 8601 タイムスタンプ以降(指定時刻を含む)に作成された world のみを返します(例: 2026-10-01T00:00:00Z)。

created_beforestring

この ISO 8601 タイムスタンプより前に作成された world のみを返します。

sort_bystringデフォルト: created_at

ソート基準: created_at または updated_at。

sort_orderstringデフォルト: desc

ソート順序: asc または desc。

レスポンス

worldsarray

world レコードの配列。各レコードには world_id が含まれ、利用可能な場合は display_name、world_marble_url、model、tags、created_at、および updated_at が含まれます。

next_page_tokenstring | null

次のページのトークン、または null。

リクエスト

curl -X POST "https://api.tokenlab.sh/v1/worlds/list" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"page_size": 20, "status": "SUCCEEDED", "model": "marble-1.1"}'
{  "worlds": [    {      "display_name": "string",      "world_id": "string",      "world_marble_url": "http://example.com",      "assets": {},      "created_at": "2019-08-24T14:15:22Z",      "model": "string",      "permission": {},      "tags": [        "string"      ],      "updated_at": "2019-08-24T14:15:22Z",      "world_prompt": {}    }  ],  "next_page_token": "string"}

認証

BearerAuth
AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

リクエストボディ

application/json

レスポンス

application/json

application/json