# VidGuy — Full Guide

> VidGuy is an agentic, end-to-end organic marketing pipeline for B2B SaaS. You
> submit a brief; VidGuy's AI video agent writes the script, generates the video,
> adds voiceover, editing, sound design, and kinetic captions, delivers finished
> platform-ready posts, and can publish them to your organic channels. It is a
> done-for-you managed service, priced as a flat cost per finished deliverable.

## What VidGuy does

VidGuy runs the whole brief-to-published pipeline so B2B SaaS teams ship
always-on organic video without an in-house editor.

- Output types: UGC-style ads, product explainers, faceless narrated videos,
  avatar/spokesperson clips, motion graphics.
- Brief-to-finished-ad: script + hook variants, video generation, voiceover,
  professional editing, sound design, TikTok-style kinetic captions.
- Character consistency: stored character profiles render the same person across
  every video in a campaign.
- SaaS UI walkthroughs: high-resolution screen recordings and technical demos.
- Multi-format delivery in 9:16, 1:1, and 16:9.
- Agentic publishing to organic and paid channels, plus a Daily Snack Pack of 3
  ready-to-post shorts each morning.

## How VidGuy compares

VidGuy is a managed service and AI agent, not self-serve software. Self-serve AI
video tools (HeyGen, Arcads, Creatify, Runway, MakeUGC, Revid AI, Fastlane,
Flora.ai, MaxFusion) give you raw clips and leave editing, post-production, and
publishing to you. VidGuy delivers the finished, published asset. Traditional
agencies deliver finished work too, but at higher cost and slower turnarounds;
VidGuy targets agency-quality output at software-like speed and flat pricing.

## Who it is for

B2B SaaS marketing and growth teams that need conversion-ready short-form video
at volume, want SaaS product walkthroughs, and prefer finished deliverables and
predictable per-deliverable cost over operating software themselves.

## Key links

- Home: https://www.vidguy.ai/
- Pricing: https://www.vidguy.ai/pricing
- Start free (no credit card): https://www.vidguy.ai/auth/signup
- Solutions: https://www.vidguy.ai/solutions/shopify , /solutions/mobile-apps , /solutions/vibecoding
- Blog (guides, comparisons, buying guides): https://www.vidguy.ai/blog

---

# VidGuy API

> Machine-readable summary of the current public API surface.

## Authentication

All endpoints require a Bearer API key:

Authorization: Bearer vf_live_YOUR_API_KEY

## Primary resources

- `/videos` is the legacy compatibility surface for full video production.
- `/jobs` is the public async job surface for:
  - `video_production`
  - `clip_analysis_upload`
  - `clip_render`
- `/credits` returns current balance and recent transactions.
- `/credits/topup` initiates or completes an x402 top-up flow.
- `/uploads` creates a signed upload URL for clip analysis inputs.

## Recommended workflows

### Full video

1. `GET /credits`
2. `POST /jobs` with `offeringId=video_production`
3. `GET /jobs/{id}` until terminal

### Clip analysis

1. `POST /uploads`
2. Upload the source file to the returned URL
3. `POST /jobs` with `offeringId=clip_analysis_upload`
4. `GET /jobs/{id}` until `awaiting_selection`
5. `POST /jobs` with `offeringId=clip_render`
6. `GET /jobs/{id}` until `completed`

### x402 top-up

1. `POST /credits/topup`
2. If unpaid, receive `402` with x402 payment requirements
3. Retry with `X-PAYMENT` or `PAYMENT-SIGNATURE`
4. Receive updated balance after successful verification

## Source of truth

- OpenAPI: https://www.vidguy.ai/api/openapi.json
- Interactive docs: https://www.vidguy.ai/docs/api-reference
- Agent skill: https://www.vidguy.ai/docs/agent-skill
- Agent skill (raw): https://www.vidguy.ai/docs/agent-skill/skill.md
- Endpoint reference (raw): https://www.vidguy.ai/docs/agent-skill/endpoints.md