AGTCloud API Docs
GuidesAPI ReferenceIntegrations and resourcesUpdate and help
Video generationPixVerse

PixVerse Upload audio and video

Upload an audio or video file to obtain a media ID for subsequent operations.

POST/openapi/v2/media/upload

Authorization

bearerAuth
AuthorizationBearer <token>

Use a platform API key in the format Authorization: Bearer your-api-key.

In: header

Header Parameters

Ai-trace-id?string

Optional unique trace value; generated by the platform if omitted. Not an idempotency key.

Accept-Language?string

Optional language preference for resource APIs.

Request Body

multipart/form-data

Response Body

application/json

application/json

application/json

application/json

Use the returned result

Choose either file or file_url and use a multipart form. Video supports MP4, MOV and WebM; audio supports MP3, WAV, M4A and AAC. Requirements of the downstream API also apply.

After success, check Resp.media_type to distinguish audio from video and save Resp.media_id. Audio can be used for Create custom voice or lip-sync; video can be used for reference generation, extension, expansion and lip-sync.

PixVerse upload audio and video — official documentationView the corresponding upstream protocol definition.