> ## 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

> Générez des Worlds explorables, importez des prompts média, suivez les tâches et gérez les Worlds terminés.

La génération World crée de façon asynchrone des Marble Worlds explorables. Utilisez Worlds pour un environnement que les utilisateurs peuvent ouvrir ou revisiter. Utilisez la génération 3D quand vous avez besoin d’un modèle autonome.

## Entrées Et Assets Média

Les tâches World peuvent partir de texte, d’images, de plusieurs images ou d’une vidéo selon le modèle choisi et la forme de requête. Pour les prompts média réutilisables, préparez d’abord un media asset, puis référencez-le dans la requête World. Les media assets et Worlds terminés ne sont disponibles que pour votre compte.

## Créer Et Suivre

Les réponses de création incluent un ID de tâche public et généralement une poll\_url. Stockez cet ID avant d’afficher la progression, puis suivez poll\_url ou GET /v1/tasks/{id} jusqu’à completed ou failed.

```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"
  }'
```

## Gérer Les Worlds Terminés

Utilisez les endpoints de liste et de détail Worlds pour les Worlds terminés disponibles dans votre compte. Utilisez les endpoints de statut de tâche pour les générations en attente ou échouées. Supprimez uniquement lorsque l’utilisateur retire volontairement le World généré de votre produit.

## Erreurs Fréquentes

* Ne supposez pas que chaque modèle World prend en charge tous les types d’entrée.
* Gardez les URLs signées d’image ou vidéo valides assez longtemps pour les tentatives de récupération du service.
* Stockez l’ID de tâche retourné avant de réessayer après un timeout.
* Utilisez la génération 3D pour les fichiers de modèle téléchargeables plutôt que pour des Worlds explorables.

## Référence API

| Sujet                            | Référence                                                                               |
| -------------------------------- | --------------------------------------------------------------------------------------- |
| Créer Un World                   | [Créer Un World](/fr/api-reference/worlds/create-world)                                 |
| Obtenir Le Statut World          | [Obtenir Le Statut World](/fr/api-reference/worlds/get-world-status)                    |
| Préparer L’upload De Media Asset | [Préparer L’upload De Media Asset](/fr/api-reference/worlds/prepare-media-asset-upload) |
| Obtenir Le Media Asset           | [Obtenir Le Media Asset](/fr/api-reference/worlds/get-media-asset)                      |
| Lister Les Worlds                | [Lister Les Worlds](/fr/api-reference/worlds/list-worlds)                               |
| Obtenir Le World                 | [Obtenir Le World](/fr/api-reference/worlds/get-world)                                  |
| Supprimer Le World               | [Supprimer Le World](/fr/api-reference/worlds/delete-world)                             |
| Tâches Asynchrones               | [Tâches Asynchrones](/fr/guides/async-jobs-polling)                                     |
| Guide De Génération 3D           | [Guide De Génération 3D](/fr/guides/3d-generation)                                      |