Documentation

Getting started

Upload your first video from the dashboard. Drop in the file you want to run through the forge, or click to browse for it.

Pick an intensity, hit forge, and the batch starts. Each variant moves from queued to forging to verified right in your recent forges list.

How forging works

Every upload goes through the same four steps. The frame shifts a little, any burned-in captions get rebuilt, the audio changes tone, and then every copy gets checked against the original.

Nothing ships until it clears that check. If a variant doesn't land far enough from the source, it gets remade instead of handed to you as-is.

Intensity settings

Light keeps the picture close to the original. Good for a small batch, or for content where the framing really matters. Balanced is where most fleets land, enough change to read as different without losing the feel of the clip.

Max pushes frame, captions, and audio further apart, useful when you're posting to a lot of accounts on the same platform. You can set intensity per upload, so nothing is locked to one setting.

Exports and platforms

Every variant exports in the shape its destination wants. Most platforms want 9:16 vertical at 1080×1920, and X accepts native aspect ratios up to 1080p.

Covered platforms: TikTok, Instagram, Facebook, YouTube, and X. Pick which profiles you need before you forge, or export to all of them at once.

Verification

Verified means every copy was measured against the source and cleared real distance before it was marked done. It's not a guess, it's a check that runs on every variant, every time.

You can see the result for each forge from your dashboard. A variant that doesn't pass gets remade automatically, it never ships as a near-duplicate.

Billing and credits

One credit covers one shipped variant. Previews and verification checks are free, you only spend a credit once a copy is ready to download.

Upgrade, downgrade, or cancel any time from Billing. If you cancel, you keep access through the period you already paid for.

API and integrations

Starter and up includes API access, so you can trigger forges and pull results straight from your own tools instead of the dashboard. Every job you submit through the API or through the MCP server below shows up in your dashboard too, they all share the same job list.

One thing worth knowing up front:the cloud worker behind this API is a simulated stub right now, there's no real server-side render yet. Every job comes back flagged simulated: true, and the verification numbers are placeholders scaled to the intensity you picked. It's the full, real, key-authed API surface, wired up ahead of the real render backend landing.

Get a key

Open Settings in the dashboard and click Rotate key. The full secret is shown once, copy it somewhere safe. If you lose it, rotate again for a new one, the old key stops working the moment you do.

Submit a job

POST /api/v1/jobs with your key as a Bearer token:

curl -X POST https://videoforge-fleet.vercel.app/api/v1/jobs \
  -H "Authorization: Bearer vf_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "https://example.com/clip.mp4",
    "variants": 3,
    "intensity": "balanced"
  }'

That returns a job right away with status: "queued". Variants are capped by your plan (Starter 4, Pro and Agency 8), and asking for more than your plan allows comes back as a 400.

Poll and download

GET /api/v1/jobs/:idreturns the same job with an updated status and progress. It moves from queued to processing to completed on its own, usually within a few seconds. Once it's completed, the response includes every variant's download URL and its uniqueness readout.

curl -H "Authorization: Bearer vf_live_your_key_here" \
  https://videoforge-fleet.vercel.app/api/v1/jobs/job_xxxxx/download?variant=0 \
  -o variant-0.mp4

GET /api/v1/jobs lists your recent jobs, newest first, with simple cursor pagination if you have a lot of them.

Rate limits and plans

Every response carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers. Limits scale with your plan:

• Free: dashboard only, no API access.
• Starter: 20 requests/min, 100 jobs/month, up to 4 variants per job.
• Pro: 60 requests/min, 1,000 jobs/month, up to 8 variants per job.
• Agency: 240 requests/min, 10,000 jobs/month, up to 8 variants per job.

Going over the per-minute limit returns a 429, going over your monthly job quota returns a 403. Both reset on their own, minute-by-minute and at the start of each calendar month.

MCP setup

If you'd rather have an agent (Claude, Codex, or anything else that speaks MCP) drive the forge for you, there's a small standalone MCP server in the repo under mcp/. It wraps this same API with four tools: submit a job, check its status, list recent jobs, and get a variant's download URL. See mcp/README.md for install steps and a Claude Desktop config snippet, it takes about two minutes to wire up once you have a key.

Still stuck? Contact support.