Worlds
Préparer l'upload d'un asset média
Crée une cible d'upload d'asset média World Labs
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
Nom du fichier d'origine, jusqu'à 64 caractères, par exemple reference.png.
Type de média : image ou video.
Extension optionnelle telle que png, jpg ou mp4.
Métadonnées personnalisées stockées avec l'asset.
Réponse
Métadonnées de l'asset média préparé : media_asset_id, file_name, kind, extension, metadata, created_at et updated_at.
URL signée pour téléverser le fichier.
Méthode HTTP à utiliser lors du téléversement du fichier binaire vers upload_info.upload_url, lorsqu'elle est renvoyée.
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 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