Put BallEngine in your own product.
One engine, one account, one set of settings. Show the live simulator on your website, render finished videos in the cloud, or let Claude make them for you. A look you set once is the same everywhere.
Three ways in, one engine
Use one, or all three together: let visitors play with the player on your site, then render their favourite in the cloud at full quality.
Website player
The live simulator on your own website. Visitors press Randomize and download videos made on their own device, or an HD cloud video, like the Studio.
- One iframe, any finished mode
- Free downloads made on the visitor's device
- Optional HD cloud videos on your credits
<iframe src="https://ballengine.app/embed ?key=be_pk_…&mode=FLAG_BATTLE &theme=cyberpunk_neon &title_text=Who escapes first?"></iframe>
Cloud render API
Finished MP4s from your server: 5 to 300 seconds, any aspect ratio, 720p or 1080p at 60 fps.
- One POST in, one MP4 out
- Webhooks when a video is done
- Paid with render credits
POST /api/v1/videos
{ "mode": "FLAG_BATTLE",
"theme": "cyberpunk_neon",
"title_text": "Who escapes first?",
"duration": 30 }Claude and AI agents
Connect Claude, Cursor or ChatGPT and ask for videos in plain words. They render on your credits.
- Hosted MCP server, nothing to install
- OpenAPI spec for custom GPTs
- Can add the player to your site for you
"Make a 30 second Flag Battle video, cyberpunk neon, titled 'Who escapes first?'" MCP: https://ballengine.app/api/v1/mcp
One set of settings, everywhere
The player, the API and Claude read the same settings with the same names. Design a look once and your website and your rendered videos match.
On your website
<iframe src="https://ballengine.app/embed?key=be_pk_…
&mode=ESCAPE&theme=gold_luxury
&title_text=Wait for it&speed=1.5"></iframe>
// or change it live from your page:
player.contentWindow.postMessage({
target: 'ballengine', type: 'set-settings',
settings: { theme: 'gold_luxury', title_text: 'Wait for it' }
}, 'https://ballengine.app');In a cloud render (or through Claude)
POST https://ballengine.app/api/v1/videos
Authorization: Bearer be_sk_…
{
"mode": "ESCAPE",
"theme": "gold_luxury",
"title_text": "Wait for it",
"speed": 1.5,
"duration": 30,
"aspect_ratio": "9:16"
}| Setting | What it does |
|---|---|
| mode | Which simulation: FLAG_BATTLE, RHYTHMIC, ESCAPE, SPACE_SPIRAL and more |
| theme | A finished colour look, such as cyberpunk_neon or gold_luxury |
| palette | Your own colours instead of a theme, up to 8 |
| title_text | The headline drawn on the video |
| watermark_text | Your handle or brand on the video |
| speed | Simulation speed, 0.5 to 3 |
| ball_count | How many balls (or flags in Flag Battle) |
| gravity | Gravity, 0 to 5 |
| sound_effect | The bounce sound |
| config_overrides | Finer settings: ball colour, trails, backdrop, title colour and more |
Only a cloud render takes duration, aspect_ratio, quality and music. The player makes 9:16 videos of 5 to 60 seconds on the visitor's device.
One set of keys
A public key (be_pk_) for the player, locked to your registered websites. A secret key (be_sk_) for the API and your agents, kept on your server.
One credit balance
Cloud renders from the API, from Claude, from the Studio and from your player's Cloud video button all use the same cloud credits: your plan's monthly credits, then bought ones. Downloads made on a visitor's device use none.
One console
Your websites, keys, credits, webhooks and recent renders on this page, and one AI prompt that sets up all of it.
Open to see, invite only to use
We are letting people in a small group at a time. Pick the plan you would want and press Confirm interest. Nothing is charged; we use it to decide who to invite first.
Contact support to unlock pricingFree
Price locked
- 3 modes in the website player
- 50 player videos a month
- BallEngine watermark
- 1 website
Builder
Price locked
- Every finished mode
- 2,000 player videos a month
- Cloud video button, API and Claude
- No watermark, small BallEngine link
- 1 website
Platform
Price locked
- Every mode, new modes first
- 20,000 player videos a month
- API, Claude and webhooks
- Your own branding only
- 5 websites
Enterprise
Price locked
- Unlimited player videos
- White label
- Early access to new modes
- Revenue share for big sites
Player videos are made on your visitors' own devices. Cloud renders use render credits.
Your console
Your account is not invited yet
Pick a plan under Open to see, invite only to use and press Confirm interest, or tell support what you are building. Once you are in, your websites, keys and renders appear here.
Buy cloud render credits
1 credit = 30 seconds of video. 1080p at 60 fps uses 2.
Buy credits
credits = 100 videos of 30 seconds
$35.00
$0.35 per credit
Pay with
By purchasing, you agree to the Terms of Service and Refund Policy. Billing help
Credits last 12 months. Failed renders are credited back. Minimum 20 credits. Non-refundable.
Questions
- What can I build with BallEngine?
- A ball simulator website, a video tool, a bot or an app. Show the live simulator on your site with one iframe, render finished MP4s from your server with one API call, or let Claude and other AI agents make videos through our hosted MCP server. All three use the same engine and the same settings.
- Why not build my own ball simulator with AI?
- You can, but you start from zero: physics, recording, audio sync and every browser bug are yours. BallEngine is a finished engine with every mode, built and kept working by game developers with 10+ years of experience.
- Do the player and the API look the same?
- Yes. Both read the same settings with the same names (theme, palette, title_text, speed and the rest), through the same code, so a look you design for your site renders the same in the cloud.
- Who pays for the videos?
- Downloads from the website player are made on your visitors' own devices and use no credits; they count toward your site's monthly videos. Cloud renders use your cloud credits, from your plan or bought: from the API, Claude, the Studio, or the Cloud video button in your player. 1 credit is 30 seconds at 720p, 2 at 1080p 60 fps.
- Can my visitors make cloud videos, like on BallEngine?
- Yes. Switch on Cloud videos for your player in your console and it gets a Cloud video button: an HD video made on our GPUs, paid from your plan's cloud credits. You set how many credits a month the site may spend, how many videos each visitor gets and the longest length. To give them only to your paying users, require a one-time token that your server makes with your secret key.
- Can Claude set it up for me?
- Yes. Your console has a Copy AI prompt button with your keys and websites filled in. Paste it into Claude, ChatGPT or Cursor in your project and the assistant adds the player, and the API if you want it.
- Who can use it?
- Anyone can read how it works. Access is invite-only for now: pick the plan you would want and press Confirm interest, and we invite people in order.