Zum Hauptinhalt springen
Erzeugen Sie erkundbare 3D-Welten mit World Labs Marble. Diese API ist asynchron: Create-Responses geben eine Task-Identität und eine poll_url für Statusabfragen zurück. Unterstützte Modelle sind marble-1.0, marble-1.1 und marble-1.1-plus. World Labs dokumentiert marble-1.0-draft, aber TokenLab stellt draft generation in diesem Endpoint derzeit nicht bereit.

​
Request-Body

​
model
string
Standard:"marble-1.0"
Zu verwendendes Marble-Modell: marble-1.0, marble-1.1 oder marble-1.1-plus.
​
prompt
string
Textprompt für reine Textgenerierung oder als Anleitung mit Bild-/Videoeingaben.
​
world_prompt
object
Natives World Labs world_prompt-Objekt für fortgeschrittene Aufrufer. Unterstützte Prompt-Typen sind text, image, multi-image und video.
​
image
string
Base64- oder data-URL-Bildprompt.
​
image_url
string
Bild-URL-Prompt.
​
images
array
Mehrere Bildprompts für verkürzte multi-image-Generierung. Bis zu 4 Bilder. Für den nativen World Labs reconstruction mode übergeben Sie world_prompt.type="multi-image" mit reconstruct_images: true und bis zu 8 Bilder.
​
video_url
string
Video-URL-Prompt.
​
is_pano
boolean | string
Bei Bildeingaben true für ein vorhandenes Panorama, false für ein normales Einzelbild oder auto.
​
seed
integer
Optionaler Seed von 0 bis 4294967295.
​
display_name
string
Optionaler Anzeigename für die Upstream-Welt, bis zu 64 Zeichen.
​
tags
array
Optionale Upstream-Tags. Bis zu 10 Tags, jeweils bis zu 32 Zeichen.
​
permission
object
Optionales World Labs permission-Objekt.

​
Antwort

​
id
string
Öffentliche Task-ID für Polling.
​
task_id
string
Alias für die Async-Task-ID.
​
operation_id
string
Upstream World Labs operation ID.
​
poll_url
string
Bevorzugte Polling-URL für diesen Task.
​
status
string
Task-Status: pending, processing, completed oder failed.
​
world_marble_url
string
URL der generierten Marble-Welt nach Abschluss.
​
glb_url
string
Collider-Mesh-GLB-URL, sofern verfügbar.
​
pano_url
string
Panorama-Bild-URL, sofern verfügbar.

​
Preise

World Labs rechnet in credits ab. TokenLab zieht zunächst das Maximum des Request-Typs ab und rechnet anhand von cost.total_credits der abgeschlossenen operation ab, sofern verfügbar. Standard-Marble-Requests benötigen bis zu 1.600 credits. marble-1.1-plus benötigt bis zu 3.100 credits.

​
Umfang

Diese Management-Endpunkte decken TokenLab-eigene Medien-Assets und abgeschlossene generierte Worlds ab. TokenLab stellt weiterhin keine marble-1.0-draft-Generierung und keine eigenständigen pano/depth-Tools bereit. 
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": "Eine ruhige Küstenstadt bei Sonnenuntergang mit engen Gassen und warmem Licht"
  }'