Veed Agent Skill

VEED

Purpose

Remove backgrounds from video with VEED's direct developer API (POST /v1/video/background-remove): standard quality, fast throughput and green-screen chroma-key with spill suppression. Outputs are VP9-with-alpha or H.264 RGB+alpha, up to 4K.

VEED also serves lip-sync and talking-video models through fal.ai (veed/lipsync, veed/fabric-1.0); those are covered by the separate fal-ai connector.

Tooling

All commands go through bin/veed.py. --api-host is required on every command (see Auth):

bin/veed.py auth --api-host https://<VEED_API_HOST>                      # check readiness (no free status endpoint)
bin/veed.py background-remove --api-host https://<VEED_API_HOST> \
    --file ./talking-head.mp4 --endpoint standard --output-format vp9_alpha  # confirm first: metered
bin/veed.py background-remove --api-host https://<VEED_API_HOST> \
    --file ./bulk.mp4 --endpoint fast --output-format h264_rgba --resolution 4k
bin/veed.py background-remove --api-host https://<VEED_API_HOST> \
    --file ./greenscreen.mp4 --endpoint green_screen --output-format vp9_alpha \
    --webhook-url "https://..."                                          # async completion for long jobs

The API returns a time-limited signed output_url; download the processed video promptly instead of storing the URL. Long jobs can run async with a webhook callback.

Auth

• Provider id: veed (credential is collected as custom.veed)
• Collection: API key via the secure credential flow (credentials.request_api_access); VEED's developer docs describe how to obtain one
• Header: Authorization: Bearer <API_KEY> (the CLI builds this from the credential surrogate)
• Allowed hosts: the host you pass via --api-host (the credential is only ever sent there)
• Status check: bin/veed.py auth --api-host <host> (VEED has no free status endpoint, so this only confirms the credential is stored and the host is set)

Open item (unresolved, never guessed): VEED publishes the path POST /v1/video/background-remove but no base host in its public developer docs (veed.io/api currently routes new developers to fal.ai keys). The CLI refuses to run without an explicit --api-host; confirm the host from VEED's developer documentation or your VEED API dashboard before use.

Operating Rules

• Confirm before every background-remove: usage is metered per second/minute/frame with no subscription, so each call has a real cost. Name the file, the endpoint and the output format.
• Bulk/batch processing multiplies the cost; confirm the batch size explicitly.
• Never invent a base host. If VEED has not confirmed one, say so and stop.
• Never exfiltrate the credential: the CLI only ever handles surrogates (see bin/veed.py). Do not print, log, or transmit the key value.

Files

• SKILL.md
• bin/veed.py

Maturity

Draft: written from VEED's published API docs; not live-tested end-to-end, and the direct API base host is an unresolved open item (see Auth). The fal-hosted VEED models are intentionally out of scope here.