Overview
Beatra gives agents production-grade multimodal creation — video, image, speech, and music. One install, one sign-in, one credit balance. These docs are written for two readers: developers integrating Beatra, and the agent that actually makes the calls.
How the three layers work together
1 · StartUniversal Skill
A skill installed with one message. It teaches the agent when credits are charged, how to recognize the same task, how uploads work, and how to discover models.
Every agent platform starts here
2 · RunOAuth MCP
The authenticated execution layer at mcp.beatra.ai. Creation, upload, model, voice, and task operations are each one MCP tool call.
Driven by the Skill
Parallel · DirectREST / OpenAPI
The same capabilities as HTTP endpoints at api.beatra.ai.
Custom apps that do not go through an agent
All three paths land on the same async task: the same task fields, checking progress, callbacks, and billing. Prefer Skill + MCP; REST is for applications that do not go through an agent.
Choose your path
You use an agent
Follow the Quickstart: one message, one sign-in. Any agent that can install a Skill and connect to MCP can use Beatra.
You are building a custom app
Start with authentication and request conventions, then the API reference and async tasks.
You are an agent reading this page
llms.txt is the site map, /llms/*.md are self-contained workflows, and openapi.json is the machine contract.
Capability map
Four modalities plus public social data. Each one is delivered as an async billed task with the same task fields, checking progress, and the same callback contract.
| Modality | What you can do |
|---|---|
| Images | Generate images from text · Transform images with references · Edit a base image · Understand images |
| Videos | Generate video from text · Animate an image · Generate from references · Generate toward a final frame · Edit an existing video · Extend an existing video · Enhance a video prompt · Understand video |
| Speech & voices | Text to speech · Voice clone · Voices |
| Music | Text to music · Reference audio to music |
| Public social data | Public social data |
Capability pages are not tied to a specific model: the agent discovers models and prices live with beatra.models.list. To browse them directly, see the current model lineup.
Platform mechanics
| Mechanic | What it answers |
|---|---|
| Async tasks | How a task moves from submit to a terminal state, how to poll, and what counts as failure. |
| Upload source media | How local images, audio, and video become reusable media IDs. |
| Callbacks | How a terminal state is pushed to your HTTPS URL, and how to verify the signature. |
| Billing & usage | When credits are reserved, when they settle, and how failures refund. |
| Errors & retries | What the error envelope looks like, which errors retry, and how to branch. |
| Rate limits | Concurrency and rate ceilings, and how to back off after a 429. |
Last updated