Introduction
This article will guide you through the process of adding a custom domain to your account. A custom domain allows you to use your own domain for your video assets. Please follow these steps to get started.
Pricing
Adding a custom domain comes with the following pricing options:
$60 for Video on Demand (VOD)
$60 for Livestream
$100 for both VOD and Livestream
Process
The request
To initiate the process, you need to simply click "Add Custom Domain" button within the Domains area.
Please note that this option is only available in the Production environment.
Your use case
Depending on how you plan to use api.video, you can decide whether you would like to get custom domains for VOD, Livestream, or both options. If you select both, you will get a discount rate.
After making your selection, our billing system will automatically process the charges after you click "Confirm Addon".
And voilà, you will only have to complete the 3 technical configuration steps.
Technical Configuration
Upon confirmation of payment, you will be given the option to set up your custom domains immediately or postpone it for later. If you choose to postpone it, you will encounter a CONFIGURATION NEEDED status.
To configure it, follow the steps described below:
Which player do you use?
Select the first option if you intend to utilize any of our available players, or choose the second option if you plan to use an external player.
When selecting your choice, you will be asked to submit specific certificates in the next step.
Providng TLS certificates and keys
api.video requires a valid TLS certificate for every custom domain that you want to use and also your certificate key.
Depending on your use case and the option you have choosen for the player, you might need separate sub-domains and separete certificates + keys for video, live, collector, and embed services as described below.
Using one of our players
Live streaming | live.mycustomdomain.comem bed.mycustomdomain.com collector.mycustomdomain.com |
VOD | vod.mycustomdomain.com embed.mycustomdomain.com collector.mycustomdomain.com |
VOD and Live streaming | vod.mycustomdomain.com live.mycustomdomain.com embed.mycustomdomain.com collector.mycustomdomain.com |
Using an external player
VOD or Livestream using your own custom player without analytics | vod.mycustomdomain.com live.mycustomdomain.com |
VOD or Livestream using your own custom player with analytics | vod.mycustomdomain.com live.mycustomdomain.com collector.mycustomdomain.com |
Fill in the custom domains information and upload the certificates and keys:
Updating DNS records (Final step!)
You need to update your custom domain’s DNS records. Simply add a CNAME for every custom domain that you want to use. Each custom URL should point to api.video’s corresponding CDN.
video.mycustomdomain.com CNAME→vod.api.videolive.mycustomdomain.com CNAME→live.api.videoembed.mycustomdomain.com CNAME→embed.api.videocollector.mycustomdomain.com CNAME→collector.api.video
The steps to update your custom domain’s DNS records are determined by the domain host that you use. Contact your domain host if you are unsure about the specific steps of updating the DNS records.
At this point you will encounter a PROCESSING status.
Start using your new video or live domain
After you have updated your DNS records and provided the corresponding TLS certificates, api.video will enable traffic for each custom domain that you want to use and this process usually takes a few hours.
Once everything is configured on our side we will let you know by email and you will have a LIVE status.
If you have any questions, feel free to reach out to us!