Skip to main content
POST
World Labs Marble で探索可能な 3D ワールドを生成します。この API は非同期です。作成レスポンスにはタスク識別子と、ステータス確認用の poll_url が返ります。 Models API で現在利用可能な Marble モデルを選んでください。

リクエストボディ

string
デフォルト:"marble-1.0"
Models API で現在利用可能な Marble モデルを選んでください。
string
テキストのみの生成、または画像・動画入力時のガイダンスとして使うテキストプロンプトです。
object
高度な呼び出し向けの World Labs ネイティブ world_prompt オブジェクトです。対応タイプは textimagemulti-imagevideo です。
string
Base64 または data URL の画像プロンプトです。
string
画像 URL プロンプトです。
array
簡易 multi-image 生成用の複数画像プロンプトです。最大 4 枚まで指定できます。World Labs ネイティブの再構成モードでは、world_prompt.type="multi-image"reconstruct_images: true を指定し、最大 8 枚まで渡せます。
string
動画 URL プロンプトです。
boolean | string
画像入力では、既存のパノラマなら true、通常の単一画像なら false、または auto を指定します。
integer
任意のシード値です。0 から 4294967295 まで指定できます。
string
生成されるワールドの任意の表示名です。最大 64 文字です。
array
任意の World Labs タグです。最大 10 個、各タグ最大 32 文字です。
object
任意の公開範囲とアクセス設定です:publicallow_id_accessallowed_readersallowed_writerspublic: true は公開されるワールドの作成を要求します。

レスポンス

string
ポーリング用の公開タスク ID です。
string
非同期タスク識別子の別名です。
string
World Labs のオペレーション ID です。
string
このタスクに推奨されるポーリング URL です。
string
タスク状態:pendingprocessingcompletedfailed
string
完了時の生成済み Marble ワールド URL です。
string
利用可能な場合のコライダーメッシュ GLB URL です。
string
利用可能な場合のパノラマ画像 URL です。

料金

現在の料金は Pricing API で確認してください。最終請求額は利用記録に表示されます。返された cost.total_credits は生成使用量であり、通貨の金額ではありません。

承認

Authorization
string
header
必須

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

ヘッダー

X-TokenLab-Delivery-Policy
enum<string>

リクエストごとの配信ポリシー。APIキーおよびWorkspaceのデフォルト設定を上書きします。TokenLab Verifiedを優先的に自動試行し、出力、アップストリームの承認、または永続リソース作成の前に、一度だけOfficialのみに切り替える場合があります。

利用可能なオプション:
auto,
verified,
official

ボディ

application/json
world_prompt
object
必須

上級者向けのネイティブWorld Labs world_promptオブジェクト。サポートされているプロンプトタイプは、text、image、multi-image、videoです。コンテンツ参照には、/v1/worlds/media-assets/prepare-upload で準備されたmedia_asset_idを指定したsource=media_assetを使用できます。

model
enum<string>
デフォルト:marble-1.0

使用するMarbleモデル。省略された場合、現在のWorld Labs互換性のデフォルトに合わせてmarble-1.0がデフォルトとなります。

利用可能なオプション:
marble-1.0,
marble-1.1,
marble-1.1-plus
prompt
string

テキストまたはガイド付きの画像/動画ワールド生成に使用されるテキストプロンプト。

display_name
string

生成されたワールドのオプションの表示名(最大64文字)。

Maximum string length: 64
image
string

Base64またはデータURLの画像プロンプト。

image_url
string<uri>

画像URLプロンプト。

images
(string | object)[]

ショートカットのマルチ画像プロンプト。最大4枚の画像を指定してください。最大8枚の画像にはネイティブのworld_prompt.reconstruct_images=trueを使用してください。

Maximum array length: 4
video_url
string<uri>

動画URLプロンプト。

is_pano

画像プロンプトが既存のパノラマかどうか。パノラマ入力にはtrue、単一画像入力にはfalse、またはautoを使用してください。

seed
integer

0から4294967295までのオプションのシード値。

必須範囲: 0 <= x <= 4294967295
tags
string[]

オプションのWorld Labsタグ。最大10個のタグを指定でき、各タグは最大32文字です。

Maximum array length: 10
Maximum string length: 32
permission
object

オプションのWorld Labs権限オブジェクト。

user
string

エンドユーザー識別子。

レスポンス

タスクが作成されました

id
string
task_id
string
operation_id
string
status
enum<string>
利用可能なオプション:
pending,
processing,
completed,
failed
poll_url
string
world_id
string
world_marble_url
string
model_url
string
glb_url
string
pano_url
string
thumbnail_url
string
caption
string
cost
object