beatra-ai/beatra-skills / plugins/beatra/skills/beatra
beatra
VerifiedCreate AI images, videos, music, and voice, look up public social data, edit visual results, and keep generated assets easy to find and manage. Beatra Universal turns text into images, images and references into video, ideas into songs or instrumentals, and scripts into narration, while also supporting custom voice creation and public social media data lookup across YouTube, TikTok, Instagram, and X. Use it as an AI media generator and AI creative suite for text-to-image, image-to-video, AI video editing, AI music generation, text-to-speech, multilingual voice-over, voice cloning, multimodal content creation, and YouTube or TikTok data for posts, comments, accounts, and trends. Reuse source media, returned files, and public social findings across formats, follow production progress, and view actual credit use for completed creative work.
references/videos.md
View on GitHub# Videos
Choose exactly one video action from the transformation the user wants.
- Use `beatra.videos.generate` for text-to-video without a required visual source.
- Use `beatra.videos.enhance_prompt` to create a text-only production prompt from
a creative brief and optional multimodal context before a separate video request.
- Use `beatra.videos.animate` when one image must be the opening frame.
- Use `beatra.videos.interpolate` when a strict last image defines the destination;
add a strict first image when both boundaries matter.
- Use `beatra.videos.generate_from_references` when ordered image, video, or audio media
should guide a new video without being a strict endpoint.
- Use `beatra.videos.edit` to change an existing video's content or style.
- Use `beatra.videos.extend` to generate footage immediately before or after one source
clip.
- Use `beatra.videos.compose` to join 1–12 of the account's own video clips into one MP4
(`canvas`: `9:16`, `16:9`, `1:1`, `3:4`) with optional `narration`, ducked `music`
(`{source, volume}`), and up to 200 burned-in `subtitles` (`{start, end, text <= 80}`).
Each clip keeps its own trimmed audio only when `keep_audio: true` (for example, a
lip-synced presenter take); other clips are muted. Query `{"capability": "video_compose"}`
on `beatra.models.list` for live pricing.
- Use free **`beatra.avatars.list`** before talking-presenter runs to inspect saved
portraits (`image.artifact_id` and paired `voice_id`, default first) so returning
customers do not need to re-upload their portrait. Use free **`beatra.avatars.save`**
to save an uploaded or generated `artifact_id` (`display_name`, optional `purpose`,
optional `voice_id`, `make_default`) ONLY after the user agrees to save it and
confirms portrait consent (`consent_attested: true`, `consent_subject`: `"self"` or
`"authorized_other"`).
These operations are not interchangeable. Editing transforms source content; extension
adds footage immediately before or after one source clip; reference generation uses media
as guidance. A strict opening
image belongs in `animate`, and a required strict last image belongs in `interpolate`.
After choosing the action, load [video controls](video-controls.md). Load
[video recipes](video-recipes.md) when constructing the payload. Call
`beatra.models.list` for the chosen capability before naming compatibility,
duration, resolution, or a numeric estimate:
```bash
python3 scripts/mcp_client.py call beatra.models.list
```
```json
{"capability": "text_to_video"}
```
Copy the matching value for the action just chosen from [models](models.md).
Admit the complete payload against one current card. Write the shortest
admitted integer duration unless the route
is audio-led or an extend whose `duration` is the final returned length and
must exceed the trusted source. Use the lowest admitted resolution unless the
user named a higher tier.
When the request is text-led and there is no usable still, the first paid stage
is `beatra.videos.enhance_prompt` or one `beatra.images.generate` keyframe.
That gift delivery does not authorize any later video call.
Upload local media before generation. Omit `model` unless the user explicitly requests a
concrete model. A concrete model is never silently replaced. Before
`beatra.videos.generate`, `beatra.videos.animate`, `beatra.videos.interpolate`,
`beatra.videos.generate_from_references`, `beatra.videos.edit`,
`beatra.videos.extend`, or `beatra.videos.compose`, show the six-field production card from the main
instructions and wait for the user's answer. Carry this route's own facts into
it: the tool being called, and the duration, resolution, and aspect read from
the live card beside the provisional estimate. Planning, comparison, or “make
the clip” is not approval; approving the card is. Any change to the
model, media, instruction, prompt, resolution, ratio, duration, or optional
control creates a new logical request, a new card, and a new
`client_request_id`. On `insufficient_balance`, relay the returned message,
keep the top-up URL it carries exact, and retry the same frozen ID only after
the user says they have topped up.
When a create call is rejected, preserve the complete structured error. Use `param` to
locate the field and `details.candidate_failures[].code` to distinguish resolution,
duration, aspect-ratio, media, route, or optional-control incompatibility. Change the
request before retrying a non-retryable error.
When polling ends with `status: "failed"`, preserve the complete `Task.error`, including
`code`, `type`, `message`, `retryable`, `param`, `details`, and `request_id`.
`model_output_invalid` means the generated artifact could not be downloaded after three
attempts; report the failure because there is no result artifact to deliver.
```bash
python3 scripts/mcp_client.py call beatra.videos.compose
```
```json
{
"clips": [
{
"source": {"type": "artifact", "artifact_id": "art_clip_1"},
"keep_audio": true
}
],
"narration": {"type": "artifact", "artifact_id": "art_voice_1"},
"canvas": "9:16",
"client_request_id": "compose-opaque-1"
}
```
Muted clips with a voice-over and a music bed:
```json
{
"clips": [
{"source": {"type": "artifact", "artifact_id": "art_clip_1"}},
{"source": {"type": "artifact", "artifact_id": "art_clip_2"}, "start": 0.5, "end": 5}
],
"narration": {"type": "artifact", "artifact_id": "art_voice_1"},
"music": {"source": {"type": "artifact", "artifact_id": "art_song_1"}, "volume": 0.2},
"canvas": "9:16",
"client_request_id": "compose-opaque-2"
}
```
Music dips under the voice by itself and fades out at the video's end. Narration
may not run longer than the clips. Joining and its card follow
[deliver one file](deliver-one-file.md).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |