TokenLab

Worlds

Préparer l'upload d'un asset média

Crée une cible d'upload d'asset média World Labs

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

Créez un enregistrement d'asset média World Labs et recevez une URL d'upload pour une image ou une vidéo. Téléversez le fichier binaire vers upload_info.upload_url, puis référencez le media_asset.media_asset_id renvoyé depuis world_prompt avec source: "media_asset".

L'asset est disponible uniquement dans le Workspace qui l'a créé.

{
  "model": "marble-1.1",
  "world_prompt": {
    "type": "image",
    "image_prompt": { "source": "media_asset", "media_asset_id": "<media_asset.media_asset_id>" }
  }
}

Envoyez ce corps de requête à Créer un monde. Un media_asset_id qui appartient à un autre Workspace renvoie 403 media_asset_not_owned ; un identifiant inconnu renvoie 404 media_asset_not_found.

Corps de la requête

file_namestringrequis

Nom du fichier d'origine, jusqu'à 64 caractères, par exemple reference.png.

kindstringrequis

Type de média : image ou video.

extensionstring | null

Extension optionnelle telle que png, jpg ou mp4.

metadataobject | null

Métadonnées personnalisées stockées avec l'asset.

Réponse

media_assetobject

Métadonnées de l'asset média préparé : media_asset_id, file_name, kind, extension, metadata, created_at et updated_at.

upload_info.upload_urlstring

URL signée pour téléverser le fichier.

upload_info.upload_methodstring

Méthode HTTP à utiliser lors du téléversement du fichier binaire vers upload_info.upload_url, lorsqu'elle est renvoyée.

upload_info.required_headersobject

En-têtes à inclure avec le téléversement 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