v3

latestOpenAPI 3.1.02026-07-313340106.6 KB
Assets

Create a new asset

Registers a media URL as a reusable asset. Use the returned asset id in generation inputs (input[].assetId) or as a voice clone sample. To upload a local file, first request a presigned URL via POST /v2/assets/upload, PUT the file there, then register the returned url here.

post/v2/assets

Request body

namestring
visibility'USER' | 'ORGANIZATION'
projectIdstring
urlstring uri required
type'AUDIO' | 'VIDEO' | 'IMAGE' required
inputType'UPLOAD' | 'URL' | 'RECORD' | 'TTS' | 'EXTRACT' | 'DUB' | 'DUB_SOURCE' | 'PLATFORM_IMPORT' | 'PLUGIN_PREMIERE_FILE' | 'PLUGIN_PREMIERE_TIMELINE_SELECTION' | 'PLUGIN_RESOLVE_FILE' | 'PLUGIN_RESOLVE_TIMELINE_SELECTION'
thumbnailUrlstring uri nullable
sizeinteger
formatstring
durationSecondsnumber
widthinteger
heightinteger

Response

Asset created successfully

idstring required
createdAtstring date-time required
updatedAtstring date-time required
deletedAtstring date-time nullable required
namestring nullable required
urlstring nullable required
sizenumber nullable required
formatstring nullable required
type'AUDIO' | 'VIDEO' | 'IMAGE' required
inputType'UPLOAD' | 'URL' | 'RECORD' | 'TTS' | 'EXTRACT' | 'DUB' | 'DUB_SOURCE' | 'PLATFORM_IMPORT' | 'PLUGIN_PREMIERE_FILE' | 'PLUGIN_PREMIERE_TIMELINE_SELECTION' | 'PLUGIN_RESOLVE_FILE' | 'PLUGIN_RESOLVE_TIMELINE_SELECTION' | 'null' nullable required
durationSecondsnumber nullable required
thumbnailUrlstring nullable required
visibility'USER' | 'ORGANIZATION' required
userIdstring nullable required
apiKeyIdstring nullable required
organizationIdstring required
widthnumber nullable required
heightnumber nullable required
proxyPathstring nullable
projectIdstring nullable