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/models.md
View on GitHub# Models
Prefer Beatra's automatic routing. Omit `model`, or leave it as `auto`, unless
the user explicitly names a model or asks to choose, compare, or change models.
When model choice matters, call `beatra.models.list` with the exact generation
capability for the tool you are about to use. Pass one JSON object:
```bash
python3 scripts/mcp_client.py call beatra.models.list
```
```json
{"capability": "text_to_image"}
```
Map the next tool to `capability`:
- `beatra.images.generate` → `text_to_image`
- `beatra.images.transform` → `image_to_image`
- `beatra.images.edit` → `image_edit`
- `beatra.videos.generate` → `text_to_video`
- `beatra.videos.animate` → `image_to_video`
- `beatra.videos.generate_from_references` → `reference_to_video`
- `beatra.videos.interpolate` → `frames_to_video`
- `beatra.videos.edit` → `video_edit`
- `beatra.videos.extend` → `video_extend`
- `beatra.videos.compose` → `video_compose`
- `beatra.videos.enhance_prompt` → `video_prompt_enhancement`
- `beatra.music.generate` → `text_to_music` or `reference_audio_to_music`
- `beatra.speech.prepare_script` → `speech_script`
- `beatra.speech.synthesize` → `text_to_speech`
- `beatra.speech.synthesize_dialogue` → `text_to_dialogue`
- `beatra.voices.clone` → `voice_clone`
- `beatra.speech.convert` → `speech_to_speech`
- `beatra.audio.transcribe` → `speech_to_text`
- `beatra.audio.generate_sfx` → `sound_effects`
- `beatra.music.edit` and `beatra.audio.process` → the capability of the
operation (`music_*`, `audio_process`, `audio_stem_separation`, `audio_voice_isolation`),
listed in [music editing and audio](music-editing-and-audio.md) and
[speech and audio](speech-and-audio.md)
- `beatra.images.understand` → `image_to_text`
- `beatra.videos.understand` → `video_to_text`
Do not call with an empty object, `capability: "image"` / `"video"`, a hyphenated
name such as `voice-clone`, a tool name such as `videos.animate`, or
`capabilities: [...]`. Present only the returned selectable models and use its
current constraints, defaults, supported media combinations, and customer price
inputs. Respect an explicit selection and allow validation to reject an
incompatible combination rather than silently substituting another model.
Every returned control name is an exact MCP request path. A dotted path names a
nested object and `[]` names each item in an array, for example
`references[].reference_voice`. Do not flatten or rename these paths.
For image capabilities, the public input and output limit is four. A concrete
model can expose a lower input maximum in its interface card; explicit requests
must respect that value, while `auto` evaluates the complete request and may
select another eligible model. Never truncate, merge, or drop an image. Image
pricing uses `pricing.options`. Select an option only when all of its
`dimensions` match the admitted request; an empty dimensions object is the
default. A preset canvas exposes its `tier` as the `resolution` dimension. When
target-canvas normalization or request-dependent `auto` leaves multiple
eligible prices, quote the returned range and approve against the maximum
rather than guessing. Apply the card's `estimate_formula`; under
`billing_basis: "successful_image_count"`, source-image count never multiplies
the customer estimate and the task's persisted artifacts and terminal billing
are final truth. Never copy model names, tier names, thresholds, or credit
amounts into the Skill as durable catalog data.
For video capabilities, `auto` selection is request-dependent. Discovery's
`auto.candidate_order` is the live priority order; Beatra evaluates the complete
request against that order and selects the first eligible model. The selected
concrete model is persisted on the Task as `resolved_model`. Do not describe
`auto` as one fixed model. If controls are omitted, each candidate is evaluated
with its own returned defaults.
When the user supplies a concrete model, pass that concrete model unchanged.
Do not continue down `candidate_order` and do not silently replace it when the
request is incompatible or temporarily unavailable.
For text-to-speech, customer pricing is linear per 1,000 weighted characters:
each Han ideograph counts as two and every other character counts as one.
Requests below 1,000 are not rounded to a full block. The customer-facing task
contract remains asynchronous while Beatra performs automatic execution
routing internally. The exact TTS model card's `constraints.supported_languages` is the source of truth
for the public BCP-47 `language` field; see [speech and voices](speech-and-voices.md)
and [speech and audio](speech-and-audio.md). For voice cloning, pass
`{"capability": "voice_clone"}` and select the clone model as described in
[speech and audio](speech-and-audio.md) §5. Read live rates from
`beatra.models.list`; do not reuse remembered model or price data.
For a preflight estimate, use the returned price options for the relevant
candidate or concrete model and state that request-dependent auto selection is
finalized at admission. Image cards use their own `estimate_formula` and
dimension-matched `unit_credits`. Other media may use
`(unit_price_credits * billable_quantity) / scale`. For video, read each price
option's `billable_quantity.basis` and `counted_inputs`; when the basis is
`capped_reference_video_seconds`, apply the returned aggregate maximum and
`per_video_cap_seconds_by_video_count` map. For other media, read the returned
`billing_basis`. This is an estimate until actual task usage is known. The
request-time prepaid debit is therefore an estimate for workflows whose
billable duration depends on accepted media or generated output. On terminal
success, use the task's returned usage and billing as truth:
`charged_credits` includes all debits, `refunded_credits` includes any
unused-estimate refund, and `net_charged_credits` is the final charge.
Do not list model catalogs from memory. Call model discovery when a production
card needs a live price (every video, compose, clone, clone activation, Smart
Voice Director script prep, dialogue, speech-to-speech, transcription, SFX,
music edit, and audio processing step) or when model choice, compatibility, or an
estimate matters; it is not a routine prerequisite for a direct image, music, or
single-speaker speech request.
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: 194k | 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: 194k | 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: 194k | Updated | Claude CodeCodex | Verified | Install |