AI video / Private beta

Turn a photo into a talking video.

Create product explainers, UGC ads and presenter videos from a portrait and speech, without a recording session.

Duration-based credits. Quote before generating.

UGC API documentation

Sign in or buy credits to run the private beta. No API key needed for playground runs.

Video playground

Create a talking video from a portrait and speech. Access is limited to approved beta accounts.

PNG or JPEG, up to 5 MB

02 / Your video

Your generated video will appear here.

03 / Give it a voice

Speech source
Loading available voices and languages…

Get a quote before generating.

Recent jobs

Loading jobs…

Video demonstration

Original demonstration portrait

01 / Original photo

02 / Generated video

Existing Reelborne demonstration using the underlying video workflow; not a Switchboarde billing test.

Build without a camera crew

Product advertising

Create presenter-led product explainers.

Business communication

Produce authorized presenter videos from written scripts.

Your own application

Integrate asynchronous video generation into your workflow.

API reference

Private beta. Server-side bearer authentication. Never expose your API key in browser code.

Quote and create

POST /v1/ai/video/ugc/quote
POST /v1/ai/video/ugc

Use the quote to obtain the maximum reservation. Create requires Idempotency-Key, image data URI (PNG/JPEG, 5 MB), exactly one script (up to 1800 characters) or audio data URI (10 MB, 1–180 seconds), resolution (480p, 768p, 1080p), confirm_paid: true, authorized_media: true and max_credits. Optional motion, voice, voice_language, voice_prompt.

Example server-side request

curl -X POST "$SWITCHBOARDE_BASE/v1/ai/video/ugc/quote" \
  -H "Authorization: Bearer $SWITCHBOARDE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"resolution":"480p"}'

After reviewing the quote, submit a JSON body containing the required fields above with a unique Idempotency-Key header. Use the returned job_id to poll the jobs endpoint.

Retrieve results

GET /v1/ai/video/ugc/jobs/:id

Poll the job ID until succeeded, failed, canceled or review. Response includes job_id, status, resolution, reserved_credits, duration_seconds, credits_charged and output_url. Output links are temporary. Review requires reconciliation; do not retry blindly. Actual duration is charged in whole credits, with unused reservation returned after settlement.

Errors: 400 invalid input or budget, 401 authentication, 402 insufficient credits, 429 job limit, 503 unavailable beta or pricing. MCP: quote_ugc_video, create_ugc_video, get_ugc_video, list_ugc_videos.