TokenLab

Worlds

Préparer un upload de média

Crée une cible d’upload pour un média World Labs

POST
/v1/worlds/media-assets/prepare-upload

Créez un enregistrement de média World Labs et recevez une URL d’upload pour une image ou une vidéo. Uploadez le fichier binaire vers upload_info.upload_url, puis référencez media_asset.media_asset_id dans world_prompt avec source: "media_asset".

TokenLab enregistre le propriétaire du média. Seule la même organisation peut récupérer ou utiliser ce média dans une génération de World.

Corps de requête

file_namestringrequis

Nom de fichier d’origine, jusqu’à 64 caractères.

kindstringrequis

Type de média: image ou video.

extensionstring | null

Extension optionnelle, par exemple png, jpg ou mp4.

metadataobject | null

Objet de métadonnées optionnel stocké avec le média upstream.

Réponse

media_assetobject

Métadonnées du média World Labs préparé.

upload_info.upload_urlstring

URL upstream signée où uploader le fichier binaire.

upload_info.upload_methodstring

Méthode HTTP à utiliser pour envoyer le fichier binaire à upload_info.upload_url, lorsqu’elle est renvoyée.

upload_info.required_headersobject

En-têtes à inclure lors de l’envoi du fichier binaire, lorsqu’ils sont renvoyés.

Requête

curl -X POST "https://api.tokenlab.sh/v1/worlds/media-assets/prepare-upload" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "file_name": "reference.png",
    "kind": "image",
    "extension": "png"
  }'
{  "media_asset": {    "created_at": "2019-08-24T14:15:22Z",    "file_name": "string",    "kind": "image",    "media_asset_id": "string",    "extension": "string",    "metadata": {},    "updated_at": "2019-08-24T14:15:22Z"  },  "upload_info": {    "upload_method": "string",    "upload_url": "http://example.com",    "curl_example": "string",    "required_headers": {      "property1": "string",      "property2": "string"    }  }}

Autorisation

BearerAuth
AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

Corps de la requête

application/json

Réponse

application/json

application/json