Worlds
Preparar la subida de recursos multimedia
Crea un destino de subida de recursos multimedia de World Labs
Cree un registro de recurso multimedia de World Labs y reciba una URL de subida para una imagen o video. Suba el archivo binario a upload_info.upload_url, luego haga referencia al media_asset.media_asset_id devuelto desde world_prompt con source: "media_asset".
El recurso solo está disponible en el Workspace que lo creó.
{
"model": "marble-1.1",
"world_prompt": {
"type": "image",
"image_prompt": { "source": "media_asset", "media_asset_id": "<media_asset.media_asset_id>" }
}
}Envíe este cuerpo a Crear mundo. Un media_asset_id que pertenezca a otro Workspace devuelve 403 media_asset_not_owned; uno desconocido devuelve 404 media_asset_not_found.
Cuerpo de la solicitud
Nombre original del archivo, de hasta 64 caracteres, por ejemplo reference.png.
Tipo de contenido multimedia: image o video.
Extensión opcional como png, jpg o mp4.
Metadatos personalizados almacenados con el recurso.
Respuesta
Metadatos del recurso multimedia preparado: media_asset_id, file_name, kind, extension, metadata, created_at y updated_at.
URL firmada para subir el archivo.
Método HTTP a utilizar al subir el archivo binario a upload_info.upload_url, cuando se devuelva.
Encabezados que se deben incluir con la subida binaria, cuando se devuelvan.
Solicitud
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" } }}Autorización
BearerAuth Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Cuerpo de la solicitud
application/json
Respuesta
application/json
application/json