Skip to content

Captions.ai Integration Setup#

What is Captions.ai Integration?

Eden's Captions.ai integration allows you to programmatically create AI-generated videos with custom avatars, voices, and scripts. This enables automated video content creation, personalized messaging, and scalable video production through Eden's AI-powered tools.

Paid Features!

Captions API requires a credit balance on Captions.ai - as a new account, you will receive 360 credits for generation. For more info read their docs here

Prerequisites#

Before setting up Captions.ai integration, you'll need:

  • A Captions.ai account (free to create)
  • Access to Captions.ai dashboard
  • High-quality photos or videos for AI clone creation
  • Scripts ready for video generation
  • Basic understanding of video content creation

Getting Your Captions.ai Credentials#

Step 1: Create a Captions.ai Account#

  1. Sign Up for Captions.ai

  2. Go to captions.ai

  3. Click Get Started
  4. Sign up as appropriate
  5. Verify your email address

Step 2: Generate API Key#

  1. Access API Settings

  2. Log into your Captions.ai dashboard

  3. Go to API Dashboard
  4. Click Generate API Key - follow the Terms and Conditions

Captions API dashboard

  • Copy the API key to clipboard
  • Add the API key to your Agents Captions deployment

Setting Up in Eden#

Step 1: Configure Your Agent#

  1. Access Agent Settings
  2. Go to your agent's configuration page
  3. Navigate to the Integrations tab
  4. Find Captions.ai in the available integrations

Step 2: Add API Credentials#

  1. Enter API Key
  2. Paste your Captions.ai API key
  3. Save the configuration
  4. Test the connection

Step 3: Configure Video Settings#

  1. Set Default Parameters
  2. Choose your preferred avatar style
  3. Select voice options
  4. Set video quality preferences
  5. Configure output format

Usage Examples#

Basic Video Generation#

// Example API call through Eden
const videoRequest = {
  script: "Welcome to our product demo!",
  avatar: "professional_business",
  voice: "natural_male",
  duration: 30,
};

Advanced Configuration#

// Custom avatar and voice settings
const advancedRequest = {
  script: "Custom script content here",
  avatar: "custom_avatar_id",
  voice: "custom_voice_id",
  background: "office_setting",
  effects: ["subtitles", "music"],
};

Best Practices#

Content Creation#

  • Keep scripts concise and engaging
  • Use natural, conversational language
  • Include clear calls-to-action
  • Test with short scripts first

Technical Optimization#

  • Monitor your Captions.ai credit usage
  • Use appropriate video quality for your needs
  • Cache generated content when possible
  • Implement error handling for API failures

Integration Tips#

  • Start with simple use cases
  • Gradually add complexity
  • Monitor performance metrics
  • Keep API keys secure

Troubleshooting#

Common Issues#

API Key Errors

  • Verify your API key is correct
  • Check your Captions.ai account status
  • Ensure you have sufficient credits

Video Generation Failures

  • Review script content for inappropriate content
  • Check avatar and voice availability
  • Verify video length limits

Integration Problems

  • Test API connectivity separately
  • Check Eden agent configuration
  • Review error logs for specific issues

Support Resources#

Next Steps#

Once you have Captions.ai integration working:

  1. Test Basic Functionality - Generate simple videos
  2. Customize Your Workflow - Adjust settings for your needs
  3. Scale Up - Implement in production environments
  4. Monitor Performance - Track usage and optimize costs

Need help? Join our Discord community for support and tips from other users.