Zum Hauptinhalt springen
World-Generierung erstellt asynchron erkundbare Marble Worlds. Verwenden Sie Worlds für Umgebungen, die Nutzer öffnen oder erneut besuchen können. Verwenden Sie 3D-Generierung, wenn Sie ein eigenständiges Modell-Asset benötigen.

​
Eingaben Und Medien-Assets

World-Tasks können je nach Modell und Request-Form mit Text, Bildern, mehreren Bildern oder Video starten. Für wiederverwendbare Medien-Prompts bereiten Sie zuerst ein Media Asset vor und referenzieren es dann im World-Request. Media Assets und fertige Worlds sind nur für Ihr Konto verfügbar.

​
Erstellen Und Pollen

Create-Antworten enthalten eine öffentliche Task-ID und meist eine poll_url. Speichern Sie diese ID, bevor Sie Fortschritt anzeigen, und folgen Sie dann der poll_url oder GET /v1/tasks/, bis die Task completed oder failed ist. 
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": "A quiet coastal town at sunset with narrow alleys and warm lights"
  }'

​
Fertige Worlds Verwalten

Verwenden Sie die Worlds-Listen- und Detailendpunkte für fertige Worlds in Ihrem Konto. Für ausstehende oder fehlgeschlagene Generierungsaufgaben verwenden Sie Task-Status-Endpunkte. Löschen Sie nur, wenn der Nutzer die generierte World bewusst aus Ihrem Produkt entfernt.

​
Häufige Fehler

  • Nehmen Sie nicht an, dass jedes World-Modell jeden Eingabetyp unterstützt.
  • Halten Sie signierte Bild- oder Video-URLs lange genug gültig, damit Abrufversuche der Dienste gelingen.
  • Speichern Sie die zurückgegebene Task-ID, bevor Sie nach einem Timeout erneut versuchen.
  • Verwenden Sie 3D-Generierung für herunterladbare Modelldateien statt für erkundbare Worlds.

​
API-Referenz

ThemaReferenz
World ErstellenWorld Erstellen
World-Status AbrufenWorld-Status Abrufen
Media-Asset-Upload VorbereitenMedia-Asset-Upload Vorbereiten
Media Asset AbrufenMedia Asset Abrufen
Worlds AuflistenWorlds Auflisten
World AbrufenWorld Abrufen
World LöschenWorld Löschen
Asynchrone JobsAsynchrone Jobs
3D-Generierungsleitfaden3D-Generierungsleitfaden