Skip to main content

Uploading With Accessible URL

When This Option Is Ideal

Use this when your video is already accessible via HTTPS (public, or via a time-limited URL you generate).

AntCDN will fetch the video server-side and start processing automatically.

This is often easier than direct upload if your video already lives in cloud storage.

The Single-Step Process

  1. Submit an accessible URL plus your processing options.

Upload Your Video

POST https://api.antcdn.net/v1/videos/upload

Required Parameters

FieldTypeDescription
allowPublicAccessbooleanWhether video can be accessed without authentication
fileNamestringA filename for AntCDN to use (e.g. demo.mp4)
videoURLstringThe URL AntCDN will fetch

Optional Parameters

FieldTypeDefaultDescription
videoNamestring-Display name for the video. Useful for finding the video in the dashboard or via API.
videoQualitystringstandardQuality preset: standard, high, ultra
maxEdgeLengthinteger-1Max short-edge resolution (e.g. 1080). -1 means “auto”.
maxFrameRateinteger-1Max frame rate. -1 means “auto”.
encodingModestring-fast or slow
audioCodecstringaacaac, aac-he, aac-he-v2, mp3, ac3, eac3

Response body

A successful response will include this:

{
"body": {
"assetId": "vid_XXX"
}
}

Code Examples


How To Play The Video You Just Uploaded

Once processing finishes, create (or use) an Edge Key and embed it:

<!-- Replace {edgeKey} with an Edge Key -->
<iframe
src="https://player.antcdn.net/v1/{edgeKey}/master.m3u8?autoplay=true&muted=true"
frameborder="0"
allowfullscreen>
</iframe>

Check out our “Video Player” docs for more information.