Worlds

Preparar subida de medio

Crea un destino de subida para un medio de World Labs

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

Crea un registro de medio de World Labs y recibe una URL de subida para una imagen o video. Sube el binario a upload_info.upload_url y luego referencia media_asset.media_asset_id desde world_prompt con source: "media_asset".

TokenLab registra el propietario del medio. Solo la misma organización puede recuperar o usar este medio en la generación de Worlds.

Cuerpo de la solicitud

file_namestringobligatorio

Nombre de archivo original, hasta 64 caracteres.

kindstringobligatorio

Tipo de medio: image o video.

extensionstring | null

Extensión opcional como png, jpg o mp4.

metadataobject | null

Objeto opcional de metadatos guardado con el medio upstream.

Respuesta

media_assetobject

Metadatos del medio de World Labs preparado.

upload_info.upload_urlstring

URL upstream firmada donde subir el archivo binario.

upload_info.upload_methodstring

Método HTTP para subir el archivo binario a upload_info.upload_url, si se devuelve.

upload_info.required_headersobject

Encabezados que se deben incluir al subir el archivo binario, si se devuelven.

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
AuthorizationBearer <token>

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