Worlds
World の一覧取得
TokenLab を通じて作成された完了済みの World Labs Marble world を一覧表示します
現在の Workspace 内の完了した Marble World を一覧表示します。
保留中または失敗した生成タスクには GET /v1/tasks/{id} を使用してください。この一覧では、生成後に TokenLab がインデックスを作成した完了済みの world が返されます。
リクエストボディ
20返される world の数(1〜100)。
前回のレスポンスからのページネーショントークン。不透明な値(opaque value)として扱ってください。
オプションのフィルター: SUCCEEDED、PENDING、RUNNING、または FAILED。このエンドポイントは完了した world を一覧表示します。他の3つの値を指定した場合は空のリストが返されます。進行状況を確認するには生成タスクをクエリしてください。
オプションのモデルフィルター。提供が終了したモデルで作成された world にも一致します。
オプションのタグフィルター。タグの少なくとも1つを持つ world に一致します。
オプションの公開設定フィルター。
この ISO 8601 タイムスタンプ以降(指定時刻を含む)に作成された world のみを返します(例: 2026-10-01T00:00:00Z)。
この ISO 8601 タイムスタンプより前に作成された world のみを返します。
created_atソート基準: created_at または updated_at。
descソート順序: asc または desc。
レスポンス
world レコードの配列。各レコードには world_id が含まれ、利用可能な場合は display_name、world_marble_url、model、tags、created_at、および updated_at が含まれます。
次のページのトークン、または 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 APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。
場所: header
リクエストボディ
application/json
レスポンス
application/json
application/json