Upload Asset

Uploads a file (image, video, audio, or PDF) and returns an asset_id for use in other endpoints. Max 32 MB. Supported types: png, jpeg, mp4, webm, mp3, wav, pdf.

POST /v3/assets

Upload 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

{
  "data": {
    "asset_id": "<string>",
    "url": "<string>",
    "mime_type": "<string>",
    "size_bytes": 123
  }
}

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