Chart-to-Video API
Generate animated chart videos for financial research reports, investor presentations, and automated research outputs. Perfect for dexter-style research agents and LangChain integrations.
Use Cases
Financial Research Agents
Automated financial report visuals for dexter-style research agents. Transform data into investor-ready videos.
Investor Presentations
Animated quarterly earnings, growth metrics, and portfolio performance for pitch decks.
Automated Reports
Generate chart videos programmatically for weekly/monthly research outputs.
Agent Integrations
LangChain, Claude Code, and CrewAI agents can call chart-to-video as a tool.
Animation Styles
Ken Burns
Smooth cinematic zoom and pan effect for professional presentations
Build-up
Data elements appear sequentially, building the chart progressively
Reveal
Dramatic fade-in transitions for impactful reveals
Morph
Smooth transitions between chart states for before/after comparisons
Quick Start
from creativeai import CreativeAI
# Initialize client
client = CreativeAI(api_key="your_api_key")
# Generate chart video from image
result = client.chart_to_video(
chart_image_url="https://example.com/q3-earnings-chart.png",
animation_style="ken-burns",
duration=10,
title_text="Q3 2026 Revenue Growth",
subtitle_text="Year-over-year comparison showing 47% growth",
webhook_url="https://your-app.com/webhook"
)
print(f"Generation ID: {result.id}")
print(f"Status: {result.status}")
# Poll for completion
video = client.wait_for_chart_video(result.id, timeout=300)
print(f"Video URL: {video.video_url}")API Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| chart_image_url | string | - | URL of existing chart image to animate |
| chart_config | object | - | Data-driven chart configuration (line/bar/pie/area) |
| animation_style | string | ken-burns | Animation style: ken-burns, build-up, reveal, morph |
| duration | int | 8 | Video duration in seconds (4-30) |
| aspect_ratio | string | 16:9 | Aspect ratio: 16:9, 9:16, 1:1 |
| webhook_url | string | - | Webhook URL for async completion (3 attempts: 0s, 5s, 30s) |
Webhook Events
chart_to_video.completed
{
"event": "chart_to_video.completed",
"id": "abc123xyz",
"status": "completed",
"video_url": "https://cdn.creativeai.run/videos/abc123.mp4"
}chart_to_video.failed
{
"event": "chart_to_video.failed",
"id": "abc123xyz",
"status": "failed",
"error_message": "Chart image could not be processed"
}LangChain Integration
Use chart-to-video as a LangChain tool for financial research agents:
from langchain.tools import Tool
from creativeai import CreativeAI
client = CreativeAI(api_key="your_api_key")
def generate_chart_video(chart_data: str) -> str:
"""Generate animated chart video from data."""
result = client.chart_to_video(
chart_config={"chart_type": "bar", "data": eval(chart_data)},
animation_style="build-up",
duration=8,
)
video = client.wait_for_chart_video(result.id)
return video.video_url
chart_tool = Tool(
name="chart_to_video",
description="Generate animated chart videos for financial reports",
func=generate_chart_video,
)Ready to generate chart videos?
Get started with 15 credits per video. Perfect for financial research agents and investor presentations.