Worlds
Preparar Upload de Ativo de Mídia
Cria um destino de upload de ativo de mídia do World Labs
Crie um registro de ativo de mídia do World Labs e receba uma URL de upload para uma imagem ou vídeo. Faça o upload do arquivo binário para upload_info.upload_url e, em seguida, referencie o media_asset.media_asset_id retornado a partir de world_prompt com source: "media_asset".
O ativo fica disponível apenas no Workspace que o criou.
{
"model": "marble-1.1",
"world_prompt": {
"type": "image",
"image_prompt": { "source": "media_asset", "media_asset_id": "<media_asset.media_asset_id>" }
}
}Envie este corpo para Criar Mundo. Um media_asset_id pertencente a outro Workspace retorna 403 media_asset_not_owned; um identificador desconhecido retorna 404 media_asset_not_found.
Corpo da Requisição
Nome original do arquivo, com até 64 caracteres, por exemplo reference.png.
Tipo de mídia: image ou video.
Extensão opcional, como png, jpg ou mp4.
Metadados personalizados armazenados com o ativo.
Resposta
Metadados do ativo de mídia preparado: media_asset_id, file_name, kind, extension, metadata, created_at e updated_at.
URL assinada para fazer o upload do arquivo.
Método HTTP a ser usado ao fazer o upload do arquivo binário para upload_info.upload_url, quando retornado.
Cabeçalhos a serem incluídos no upload binário, quando retornados.
Requisição
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" } }}Autorização
BearerAuth Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: header
Corpo da requisição
application/json
Resposta
application/json
application/json