> ## Documentation Index
> Fetch the complete documentation index at: https://heygen-1fa696a7.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Simple Upload

> Upload a file up to 50 MB (32 MB for images) to HeyGen in one multipart request with POST /v3/assets and get an asset_id for Video Agent, avatars, translation, lipsync, and more.

![](https://mintcdn.com/heygen-1fa696a7/hfMXXwJzjE7vBSYZ/images/theme/research-9.webp?fit=max\&auto=format\&n=hfMXXwJzjE7vBSYZ\&q=85\&s=9afc7a8acf73c8f9ec670dde494e9931)

[`POST /v3/assets`](https://heygen-1fa696a7.mintlify.site/reference/upload-asset) uploads a file in one `multipart/form-data` request and returns an `asset_id`. For files over the limits below, use [direct upload to S3](https://heygen-1fa696a7.mintlify.site/docs/direct-upload.md). To pick a method or see where an `asset_id` can be used, start at the [Assets overview](https://heygen-1fa696a7.mintlify.site/assets.md).

## Upload a file

The MIME type is detected from the file bytes.

### Limits

| File type | Formats | Max size |
| - | - | - |
| Image | PNG, JPEG | 32 MB |
| Video | MP4, WebM | 50 MB |
| Audio | MP3, WAV | 50 MB |
| Document | PDF | 50 MB |
| Subtitles | SRT | 50 MB |

Each file is checked against the content policy after upload. A blocked file is removed, and later requests for its `asset_id` return not found.

### Example request

```bash theme={null}
curl -X POST "https://api.heygen.com/v3/assets" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -F "file=@./product-screenshot.png"
```

The response carries the `asset_id`, a public `url` of the uploaded file, the detected `mime_type`, and `size_bytes`; see the [reference](https://heygen-1fa696a7.mintlify.site/reference/upload-asset.md). The `asset_id` does not expire; see [Asset lifetime and deletion](https://heygen-1fa696a7.mintlify.site/assets.md#asset-lifetime-and-deletion).

## Example: upload then generate

Upload a PDF, then pass its `asset_id` to Video Agent:

```bash theme={null}
# Step 1: Upload the PDF
ASSET_ID=$(curl -s -X POST "https://api.heygen.com/v3/assets" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -F "file=@./quarterly-report.pdf" | jq -r '.data.asset_id')

# Step 2: Generate a video using the uploaded PDF
curl -X POST "https://api.heygen.com/v3/video-agents" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"prompt\": \"Summarize the key findings from this quarterly report in a 60-second video\",
    \"files\": [{ \"type\": \"asset_id\", \"asset_id\": \"$ASSET_ID\" }]
  }"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.