TokenLab
API-Schlüssel erhalten
DokumentationAPI-ReferenzIntegrationen

Worlds

World erstellen

Erstellt eine World Labs Marble-Weltgenerierungsaufgabe

POST
/v1/worlds/generations

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.

Wählen Sie ein aktuell verfügbares Marble-Modell über die Models API.

Request-Body

modelstringStandard: marble-1.0

Wählen Sie ein aktuell verfügbares Marble-Modell über die Models API.

promptstring

Textprompt für reine Textgenerierung oder als Anleitung mit Bild-/Videoeingaben.

world_promptobject

Natives World Labs world_prompt-Objekt für fortgeschrittene Aufrufer. Unterstützte Prompt-Typen sind text, image, multi-image und video.

imagestring

Base64- oder data-URL-Bildprompt.

image_urlstring

Bild-URL-Prompt.

imagesarray

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_urlstring

Video-URL-Prompt.

is_panoboolean | string

Bei Bildeingaben true für ein vorhandenes Panorama, false für ein normales Einzelbild oder auto.

seedinteger

Optionaler Seed von 0 bis 4294967295.

display_namestring

Optionaler Anzeigename für die Upstream-Welt, bis zu 64 Zeichen.

tagsarray

Optionale Upstream-Tags. Bis zu 10 Tags, jeweils bis zu 32 Zeichen.

permissionobject

Optionale Sichtbarkeits- und Zugriffsregeln: public, allow_id_access, allowed_readers und allowed_writers. public: true fordert eine öffentlich sichtbare Welt an.

Antwort

idstring

Öffentliche Task-ID für Polling.

task_idstring

Alias für die Async-Task-ID.

operation_idstring

World-Labs-Vorgangs-ID.

poll_urlstring

Bevorzugte Polling-URL für diesen Task.

statusstring

Task-Status: pending, processing, completed oder failed.

world_marble_urlstring

URL der generierten Marble-Welt nach Abschluss.

glb_urlstring

Collider-Mesh-GLB-URL, sofern verfügbar.

pano_urlstring

Panorama-Bild-URL, sofern verfügbar.

Preise

Aktuelle Preise finden Sie in der Pricing API. Der endgültige Rechnungsbetrag steht in Ihren Nutzungsdaten. Ein zurückgegebenes cost.total_credits beschreibt Generierungsverbrauch, keinen Währungsbetrag.

Anfrage

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"
  }'
{  "id": "string",  "task_id": "string",  "operation_id": "string",  "status": "pending",  "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": {},  "error": "string",  "error_details": {    "projection_version": 0,    "status": 400,    "message": "string",    "type": "string",    "code": "string",    "param": "string",    "retryable": true,    "upstream": {      "source": "string",      "code": "string",      "message": "string",      "param": "string"    }  }}

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Header

X-TokenLab-Delivery-Policy?string

Zustellungsrichtlinie pro Anfrage. Überschreibt die API-Key- und Workspace-Standardeinstellungen. Versucht automatisch zuerst TokenLab Verified und kann vor der Ausgabe, der Annahme der Anfrage oder der Erstellung persistenter Ressourcen einmalig auf Official umstellen.

Zulässige Werte

  • "auto"
  • "verified"
  • "official"

Anfragekörper

application/json

Antwort

application/json

application/json

application/json

Medien-Asset abrufen

Zurück

Weltstatus abrufen

Weiter