Upload an asset

Upload a file (image, video, audio, or PDF) to get an asset_id for use in other endpoints like POST /v3/video-agents. Uses multipart/form-data with a ‘file’ field. Max 32 MB. MIME type is auto-detected from file bytes. Supported types: image (png, jpeg), video (mp4, webm), audio (mp3, wav), and pdf.

POST /v3/assets

Upload an asset

cURL

curl --request POST \
  --url https://api.heygen.com/v3/assets \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form file='@example-file'

200

{}

Authorizations

ApiKeyAuthBearerAuth

x-api-key · string · header · required

HeyGen API key. Obtain from your HeyGen dashboard.

Body

multipart/form-data

file · file · required

File to upload (image, video, audio, or PDF). Max 32 MB.

Response

200

application/json

Successful response

data · UploadAssetV3Response · object

Response from uploading an asset via POST /v3/assets.

Show child attributes