メインコンテンツへスキップ
World Labs Marble で探索可能な 3D ワールドを生成します。この API は非同期です。作成レスポンスにはタスク識別子と、ステータス確認用の poll_url が返ります。 対応モデルは marble-1.0、marble-1.1、marble-1.1-plus です。World Labs のドキュメントには marble-1.0-draft も記載されていますが、TokenLab は現時点でこのエンドポイントでは draft 生成を公開していません。

​
リクエストボディ

​
model
string
デフォルト:"marble-1.0"
使用する Marble モデル：marble-1.0、marble-1.1、marble-1.1-plus。
​
prompt
string
テキストのみの生成、または画像・動画入力時のガイダンスとして使うテキストプロンプトです。
​
world_prompt
object
高度な呼び出し向けの World Labs ネイティブ world_prompt オブジェクトです。対応タイプは text、image、multi-image、video です。
​
image
string
Base64 または data URL の画像プロンプトです。
​
image_url
string
画像 URL プロンプトです。
​
images
array
簡易 multi-image 生成用の複数画像プロンプトです。最大 4 枚まで指定できます。World Labs ネイティブの再構成モードでは、world_prompt.type="multi-image" と reconstruct_images: true を指定し、最大 8 枚まで渡せます。
​
video_url
string
動画 URL プロンプトです。
​
is_pano
boolean | string
画像入力では、既存のパノラマなら true、通常の単一画像なら false、または auto を指定します。
​
seed
integer
任意のシード値です。0 から 4294967295 まで指定できます。
​
display_name
string
上流ワールドの任意の表示名です。最大 64 文字です。
​
tags
array
任意の上流タグです。最大 10 個、各タグ最大 32 文字です。
​
permission
object
任意の World Labs permission オブジェクトです。

​
レスポンス

​
id
string
ポーリング用の公開タスク ID です。
​
task_id
string
非同期タスク識別子の別名です。
​
operation_id
string
上流 World Labs の operation ID です。
​
poll_url
string
このタスクに推奨されるポーリング URL です。
​
status
string
タスク状態：pending、processing、completed、failed。
​
world_marble_url
string
完了時の生成済み Marble ワールド URL です。
​
glb_url
string
利用可能な場合のコライダーメッシュ GLB URL です。
​
pano_url
string
利用可能な場合のパノラマ画像 URL です。

​
料金

World Labs は credits で課金します。TokenLab はリクエスト種別の最大値を事前控除し、完了した operation から cost.total_credits が得られる場合は実 credits で精算します。標準 Marble リクエストは最大 1,600 credits、marble-1.1-plus は最大 3,100 credits です。

​
スコープ

これらの管理エンドポイントは TokenLab 所有のメディアアセットと完了済み world を対象にします。marble-1.0-draft 生成および単独の pano/depth ツールはまだ公開していません。 
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": "夕暮れの静かな海辺の町、細い路地と温かな灯り"
  }'