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#
-
Sign Up for Captions.ai
-
Go to captions.ai
- Click Get Started
- Sign up as appropriate
- Verify your email address
Step 2: Generate API Key#
-
Access API Settings
-
Log into your Captions.ai dashboard
- Go to API Dashboard
- Click Generate API Key - follow the Terms and Conditions
- Copy the API key to clipboard
- Add the API key to your Agents Captions deployment
Setting Up in Eden#
Step 1: Configure Your Agent#
- Access Agent Settings
- Go to your agent's configuration page
- Navigate to the Integrations tab
- Find Captions.ai in the available integrations
Step 2: Add API Credentials#
- Enter API Key
- Paste your Captions.ai API key
- Save the configuration
- Test the connection
Step 3: Configure Video Settings#
- Set Default Parameters
- Choose your preferred avatar style
- Select voice options
- Set video quality preferences
- 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:
- Test Basic Functionality - Generate simple videos
- Customize Your Workflow - Adjust settings for your needs
- Scale Up - Implement in production environments
- Monitor Performance - Track usage and optimize costs
Need help? Join our Discord community for support and tips from other users.