WeryAI video tool — background remove#

This skill is self-contained: it documents and runs only the background-remove workflow on an existing video given by URL. It is not text-to-video or image-to-video generation from scratch.

Entry script: scripts/video_background_remove.js (alongside this SKILL.md).

Runtime: WERYAI_API_KEY, Node.js 18+.

Inputs: video_url must be a public https:// URL. This script does not read local files and does not perform upload-file flows.

What this package ships (verify before trust)#

Canonical layout for this skill only:

• SKILL.md, eval.yaml
• scripts/video_background_remove.js ( the only runnable script in scope)

If your copy also contains scripts/video_gen.js, scripts/video_toolkits.js, references/WERYAI_VIDEO_API.md, or other CLIs, those files are not part of this skill’s contract — they may come from another repo sync or an over-broad install. Do not run them when you only want background-remove; remove them or reinstall from a clean source. Inspect what you run: node scripts/video_background_remove.js spec.

Other tools (multi-endpoint CLIs, local-file upload to growth/upload-file APIs, extra environment variables in those CLIs) are out of scope for this package. This skill’s script uses only WERYAI_API_KEY and public https:// URLs.

API surface (this tool only)#

• Required: video_url (public https:// URL)
• Optional: background_color — TRANSPARENT, BLACK, WHITE, GRAY, RED, GREEN, BLUE, YELLOW, CYAN, MAGENTA, ORANGE
• Default: background_color=BLACK

From this skill root, run node scripts/video_background_remove.js spec to print the full tool schema (endpoint, required fields, defaults, enums) as JSON.

Pre-submit gate (mandatory)#

Do not run submit / wait until the user explicitly confirms the video URL and any non-default background_color. Paid runs are not idempotent.

Workflow#

Prefer --dry-run to validate JSON. Use wait to submit and poll until the task finishes; use submit only when the user wants a task_id without blocking, then status for later checks. Share final URLs as Markdown links [Video](https://…).

CLI#

From this skill root:

sh

node scripts/video_background_remove.js wait \
  --json '{"video_url":"https://example.com/video.mp4"}'

node scripts/video_background_remove.js submit \
  --json '{"video_url":"https://example.com/video.mp4"}'

node scripts/video_background_remove.js status --task-id <task-id>

Dry-run:

sh

node scripts/video_background_remove.js wait \
  --json '{"video_url":"https://example.com/video.mp4"}' \
  --dry-run

Security#

Never write WERYAI_API_KEY into files. Keep only WERYAI_API_KEY set for this workflow; do not rely on undocumented env vars in sibling scripts if any were mistakenly present. The in-scope script reads only WERYAI_API_KEY (no other env keys). video_background_remove.js accepts only https:// media URLs (no disk read / no upload-file). Base URL and poll intervals are constants in the script, not env-driven.

Do not pass local filesystem paths or run tools that accept them unless you have explicitly reviewed and consented to their upload behavior — that is never required for this skill.

Out of scope#

• Any other WeryAI video-tool workflows (subtitles, upscale, extend, face change, etc.)
• Text-to-video or image-to-video from scratch

References#

• WeryAI llms.txt