Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/beatapi/beatapi-codex-plugin/beatapi-videonpx skills add BeatAPI/beatapi-codex-plugin --skill beatapi-videogit clone --depth 1 https://github.com/BeatAPI/beatapi-codex-pluginWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00089 | $0.01733 |
| Opus 5 | $0.00044 | $0.00866 |
| Sonnet 5 | $0.00018 | $0.00347 |
| Haiku 4.5 | $0.00009 | $0.00173 |
Grade A, and why
beatapi-video scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 177 lines — stays where its author put it; the contents beside it link to each section on GitHub.
BeatAPI Video
Treat the bundled OpenAPI snapshot as the exact API contract.
Choose the execution adapter
Prefer the bundled BeatAPI MCP tools when beatapi_check_setup is available.
Use beatapi_* tools for the complete workflow and do not shell out to the CLI
for the same operation.
When BeatAPI MCP tools are unavailable, fall back to the official beatapi CLI.
The Skills-only distribution requires Node.js 20.19+ or 22.12+ and
npm install --global beatapi.
Protect the account
- Use the customer's existing BeatAPI account and API key.
- Read credentials only through the MCP setup tool,
beatapi auth, orBEATAPI_API_KEY. - Never request a key in chat, pass it as a command argument, print it, or place it in JSON, source files, logs, screenshots, or issue text.
- Treat task creation, shot editing, and composition as paid mutations.
- Consider an explicit request to generate or edit authorization for that operation. Ask before spending credits only when the request is ambiguous, material settings are missing, or the operation expands beyond the request.
- Never describe a queued or processing task as a completed video.
Establish readiness
- With MCP, call
beatapi_check_setup. If configured, use its usage result; otherwise follow its exact next step. - Without MCP, check
beatapi --version, then runbeatapi auth status. - If the CLI is missing, instruct the user to install it; install it only when the user has authorized environment changes.
- If authentication is absent, ask the user to run
beatapi auth loginin a terminal or setBEATAPI_API_KEY. Do not ask them to paste the key into the conversation. - Before a paid operation, call
beatapi_get_usageor runbeatapi usage. Check both credit balance and active concurrency.
Skip credential checks for anonymous beatapi_list_workflows or
beatapi workflows list.
Choose the workflow
- Choose Music Video when the user supplies audio plus 1-7 visual references.
- Choose automatic Music Video composition unless the user wants to inspect, select, reorder, or edit storyboard shots.
- Choose manual Music Video composition for those storyboard controls. Read manual-music-video.md before executing.
- Choose Ecommerce Video when the user supplies product images and wants a short product advertisement.
- Choose Realtime Video when the user needs a short-lived interactive browser session. Read realtime-video.md first. The agent may manage the server-side session but does not own camera permission, WebRTC negotiation, or browser rendering.
- Do not force unrelated video editing, transcription, generic image generation, or non-BeatAPI API design tasks into this Skill.
What ships with it
12 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- agents/openai.yaml 254 B
- assets/ecommerce-video.json 185 B
- assets/music-video.auto.json 288 B
- assets/music-video.manual.json 294 B
- assets/webhook.json 161 B
- evals/evals.json 6.6 KB
- references/api-workflows.md 3.2 KB
- references/beatapi.openapi.yaml 59 KB
- references/credits-and-limits.md 2.2 KB
- references/errors-and-recovery.md 1.2 KB
- references/manual-music-video.md 1.9 KB
- references/realtime-video.md 1.9 KB
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday First seen · 177 lines · 89 tokens per session scan A 897d12eefd9b
beatapi-video is a skill published in the GitHub repository BeatAPI/beatapi-codex-plugin (0 stars, last pushed 13d ago), licensed MIT. It adds 89 tokens to every session and 1,733 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
fashion-campaign-production
Provider-independent production workflow for AI-assisted fashion campaigns, lookbooks, editorial fashion films, ecommerce/editorial hybrids, social cutdowns, virtual try-on assets, generated model/lifestyle ads, and retouched fashion visuals; use when an agent must plan, prompt, produce, review, localize, or deliver…
food-beverage-content-production
Provider-independent production guidance for AI agents creating or retouching appetizing food and beverage images, recipe videos, restaurant/menu visuals, CPG ads, ecommerce product images, beverage pours, packaging/lifestyle shots, and social food clips, including truthfulness, labeling/claims discipline, styling…
product-ad-production
Diagnose, design, script, produce, adapt, and quality-control product video advertisements from evidence-backed briefs. Use for physical-product, software, app, service, ecommerce, direct-response, brand-response, demonstration, testimonial, launch, and variant ad work where product truth, legibility, claims, platform…
ecommerce-product-imagery
Provider-independent ecommerce product imagery production for marketplace listings, product pages, hero shots, lifestyle scenes, comparison charts, infographics, variant/packaging images, virtual try-on or placement mockups, ads, and AI-assisted product visuals. Use when an agent must plan, generate, edit, review…
neural-reality-capture
Use this skill for provider-independent reality capture that turns photographed or video-derived real places, objects, aerial sites, interiors, or people into photogrammetric meshes, NeRFs, or 3D Gaussian splats. It guides representation choice, capture planning, calibration and scale, reconstruction or training…
aliang-product-detail-photos
高质量商品详情图生成。将产品图片去背景，根据产品特点生成多角度、多场景商品详情图。.