Worlds

Preparar Upload de Ativo de Mídia

Cria um destino de upload de ativo de mídia do World Labs

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

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

file_namestringobrigatório

Nome original do arquivo, com até 64 caracteres, por exemplo reference.png.

kindstringobrigatório

Tipo de mídia: image ou video.

extensionstring | null

Extensão opcional, como png, jpg ou mp4.

metadataobject | null

Metadados personalizados armazenados com o ativo.

Resposta

media_assetobject

Metadados do ativo de mídia preparado: media_asset_id, file_name, kind, extension, metadata, created_at e updated_at.

upload_info.upload_urlstring

URL assinada para fazer o upload do arquivo.

upload_info.upload_methodstring

Método HTTP a ser usado ao fazer o upload do arquivo binário para upload_info.upload_url, quando retornado.

upload_info.required_headersobject

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

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