> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Worlds

> Erzeugen Sie erkundbare Worlds, laden Sie Medien-Prompts hoch, pollen Sie Tasks und verwalten Sie fertige 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-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/{id}, bis die Task completed oder failed ist.

```bash theme={null}
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

| Thema                          | Referenz                                                                              |
| ------------------------------ | ------------------------------------------------------------------------------------- |
| World Erstellen                | [World Erstellen](/de/api-reference/worlds/create-world)                              |
| World-Status Abrufen           | [World-Status Abrufen](/de/api-reference/worlds/get-world-status)                     |
| Media-Asset-Upload Vorbereiten | [Media-Asset-Upload Vorbereiten](/de/api-reference/worlds/prepare-media-asset-upload) |
| Media Asset Abrufen            | [Media Asset Abrufen](/de/api-reference/worlds/get-media-asset)                       |
| Worlds Auflisten               | [Worlds Auflisten](/de/api-reference/worlds/list-worlds)                              |
| World Abrufen                  | [World Abrufen](/de/api-reference/worlds/get-world)                                   |
| World Löschen                  | [World Löschen](/de/api-reference/worlds/delete-world)                                |
| Asynchrone Jobs                | [Asynchrone Jobs](/de/guides/async-jobs-polling)                                      |
| 3D-Generierungsleitfaden       | [3D-Generierungsleitfaden](/de/guides/3d-generation)                                  |