Sign in

11e1197415cb

latestOpenAPI 3.1.02026-08-11415467.4 KB
Assets

Start or Resume Asset Upload

Starts or recovers an expiring direct-to-storage session for a long-term Asset. Abandoned sessions expire and callers should abort cancelled uploads. A completed Asset is stored, not byte-validated; video generation validates its media later.

post/v1/assets/uploads

Headers

Idempotency-Keystring required
x-api-keystring required

API Key for authentication

API Key for authentication

Request body

filenamestring required
size_bytesinteger required
media_type'image' | 'audio' | 'video' required
content_typestring required

Response

Successful Response

upload_idstring required
status'initiated' | 'processing' | 'completed' required
part_size_bytesinteger required
total_partsinteger required
size_bytesinteger required
expires_atinteger required
max_concurrent_partsinteger required
asset_idstring nullable