Worlds

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-AssetsCopy Anchor Link

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.

Der Zugriff auf Medien- und Welt-Datensätze wird für die Organisation des API-Schlüssels geprüft. Prüfen Sie vor dem Teilen die permission-Optionen des Modells; Asset- oder Viewer-URLs können eigene Zugriffsregeln haben.

Erstellen Und PollenCopy Anchor Link

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/{id}, 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 VerwaltenCopy Anchor Link

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 FehlerCopy Anchor Link

• 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-ReferenzCopy Anchor Link