Avatars

Welcome to HeyGen! Today, we're diving into how to integrate HeyGen Interactive Avatars via API, step-by-step.Whether you're a developer, business owner, or tech enthusiast, this guide will empower you to connect seamlessly with HeyGen’s advanced avatar capabilities. <a href="https://labs.heygen.com/interactive-avatar?tab=demo" rel="noopener noreferrer" target="_blank">Demo Interactive Avatars here</a>, and then let’s dive into making one of your own! <h3>What’s covered in this guide</h3>In this tutorial, we’ll cover:&nbsp;<ol><li data-list="bullet">What is HeyGen API?</li><li data-list="bullet">Setting up your API credentials</li><li data-list="bullet">Making your first API request</li><li data-list="bullet">Testing your Avatar</li><li data-list="bullet">Downloading the video</li><li data-list="bullet">Build video generation with templates</li><li data-list="bullet">Customizing with input audio</li></ol> <h3>What is HeyGen API?</h3>The HeyGen API is offered independently of the HeyGen App and provides powerful tools like Video Generation, Video Translation, and Interactive Avatar endpoints. Every HeyGen App user receives Free Trial access to these features. Paid tiers – Creator, Team and Enterprise – are available for those who need expanded usage.<img alt="some-file-ab1363a6-453c-4634-bb75-f1cf1ba9a33b" src="https://d2xo500swnpgl1.cloudfront.net/uploads/heygen/some-file-ab1363a6-453c-4634-bb75-f1cf1ba9a33b-1735076088769.png"> <h3>Create HeyGen account and grab your API credentials</h3>To get started, create a HeyGen account if you haven’t already. Once registered, you’ll gain access to our API and can begin leveraging HeyGen’s AI to make professional avatar videos.In HeyGen, click your name and then ‘Space settings.’ Then, click ‘API.’ You’ll then need to copy your API credentials. <img alt="some-file-b54dbe57-f9ca-4a39-a79f-ef890cb8a297" src="https://d2xo500swnpgl1.cloudfront.net/uploads/heygen/some-file-b54dbe57-f9ca-4a39-a79f-ef890cb8a297-1735076166620.gif"> <h3>Setting up your development environment</h3>Next, ensure your development environment is set up to handle HTTP requests. We recommend using tools like Postman or a REST client for initial testing.<img alt="some-file-7c589575-a37b-413c-bd88-9322456dc248" src="https://d2xo500swnpgl1.cloudfront.net/uploads/heygen/some-file-7c589575-a37b-413c-bd88-9322456dc248-1735076151826.gif"> <h3>Making your first API request</h3>Let’s make our first API call! Using your chosen tool, you’ll set up a POST request to HeyGen's avatar endpoint. In this example, we'll focus on creating a basic interactive avatar.In this code, replace YOUR_API_KEY with your actual key. The parameters name, voice, and interactionType are customizable. For example, choose from voice options to fit your brand’s tone or set interaction types like text-based or video-based.<img alt="some-file-969ffa11-05ae-4a63-8a4a-aafcc20e5f0a" src="https://d2xo500swnpgl1.cloudfront.net/uploads/heygen/some-file-969ffa11-05ae-4a63-8a4a-aafcc20e5f0a-1735076634241.gif"> <h3>Testing your Avatar</h3>After creating your video, you can check its status.Use the video_status.get endpoint to monitor your video’s progress. When it’s ready, the status will update to ‘completed.’<img alt="some-file-a9e6548a-8cce-497c-b218-b516f38b0b32" src="https://d2xo500swnpgl1.cloudfront.net/uploads/heygen/some-file-a9e6548a-8cce-497c-b218-b516f38b0b32-1735076735563.gif"> <h3>Downloading the video</h3>Once the status is marked ‘completed,’ you’ll get a download link. Use this to retrieve your video. Remember, the link expires in 7 days, so be sure to download promptly.<img alt="some-file-38cea273-974c-4b24-865e-4e6e0754ddd6" src="https://d2xo500swnpgl1.cloudfront.net/uploads/heygen/some-file-38cea273-974c-4b24-865e-4e6e0754ddd6-1735076778872.gif"> <h3>Bulk video generation with templates</h3>If you need to create multiple videos, HeyGen’s Template endpoint lets you generate similar videos in bulk, perfect for scaling up your content creation.<img alt="some-file-f2fd62a4-26e2-4943-b831-c5917f5b0fee" src="https://d2xo500swnpgl1.cloudfront.net/uploads/heygen/some-file-f2fd62a4-26e2-4943-b831-c5917f5b0fee-1735076831427.gif"> <h3>Customizing with input audio</h3>For added flexibility, replace text input with an audio file using the audio_url attribute. This lets you bring your own voice or music to avatar videos, giving you ultimate control over the sound.<img alt="some-file-dd0c7cb3-c7ec-4ec4-8c87-48bd74d64275" src="https://d2xo500swnpgl1.cloudfront.net/uploads/heygen/some-file-dd0c7cb3-c7ec-4ec4-8c87-48bd74d64275-1735076873009.gif"> <h3>Recap</h3>That’s it! You’ve now integrated HeyGen Interactive Avatars via API. With HeyGen, you’re equipped to create innovative, AI-powered videos programmatically. For detailed documentation and more advanced capabilities, visit our API reference. Happy video-making!In this tutorial, you learned:&nbsp;<ol><li data-list="bullet">What is HeyGen API?</li><li data-list="bullet">Setting up your API credentials</li><li data-list="bullet">Making your first API request</li><li data-list="bullet">Testing your Avatar</li><li data-list="bullet">Downloading the video</li><li data-list="bullet">Build video generation with templates</li><li data-list="bullet">Customizing with input audio</li></ol>We’re looking forward to seeing what you’ll create with HeyGen!If you’re posting your videos on social media, make sure to tag any videos you create with “at HeyGen” so we can celebrate them with you.

How to integrate HeyGen Interactive Avatars via API

How to integrate HeyGen Interactive Avatars via API: a step-by-step guide

Connect with the community, find inspiration, and learn how to make your best videos. 

HeyGen Hub

Job Title

HeyGen Community

Login to the HeyGen Hub community to connect with others, attend community events, and more!

Login or Sign Up for even more

To unlock all parts of the community and get the best experience, complete your profile.

How to integrate HeyGen Interactive Avatars via API: a step-by-step guide

How to integrate HeyGen Interactive Avatars via API

Popular

Related