The AI UGC API.Creators, product photos, videos and scripts — one key.

What teams build with it

The same engine the dashboard runs, without anyone clicking through it.

Everything the dashboard does

If you can do it in ppl.studio, you can do it with a key. Six areas, 184 endpoints — each in the reference.

How a video run works

A UGC video isn't one render. It's a brief, a script, a frame per line, then video — and the video is where the money goes. So a run stops and asks first.

1. Step 01

   Start a run

   Send a product URL (or a written brief), a creator and a workflow. You get a run id back at once.

   POST /api/v1/flows
2. Step 02

   It writes and pictures

   The run reads the page into a brief, writes the script and draws a first frame for every line. Seconds to a minute, and cheap.

   GET /api/v1/flows/{id}
3. Step 03

   You approve the price

   The run stops at the preview: every frame with its line, and what the video will cost. Nothing is rendered until you approve.

   POST /api/v1/flows/{id}/approve
4. Step 04

   Collect the MP4

   Veo animates the frames, the cut is joined with captions and upscaled. The run's cut.url is your 1080×1920 video.

   cut.url

Quickstart: product page to MP4

Five calls from a fresh key to a finished creator video. Copy them into a terminal, or read the developer guide for a Node client.

1. 1

   Get a key

   Create one at Account → API keys. It is shown once; only its hash is stored. Send it as Authorization: Bearer … or x-api-key. Then ask the API what your plan allows:

   terminal

   Copy

   export PPL_API_KEY=ppl_live_…
   
   curl https://ppl.studio/api/v1/account -H "Authorization: Bearer $PPL_API_KEY"
   # → plan, image allowance, gemini.connected, video.allowed (and why not)

2. 2

   Make a creator

   Generate one from a niche and save it — or list the creators you already have with GET /api/v1/personas.

   terminal

   Copy

   curl https://ppl.studio/api/v1/personas/generate \
     -H "Authorization: Bearer $PPL_API_KEY" -H "Content-Type: application/json" \
     -d '{ "niche": "skincare for busy moms", "save": true }'
   # → { "draft": { … }, "persona": { "slug": "mia-…", … } }

3. 3

   Add your product

   Upload the product photo, then save the product with it. Images up to 5 MB go in one request; video and audio up to 512 MB go in parts.

   terminal

   Copy

   curl https://ppl.studio/api/v1/uploads -H "Authorization: Bearer $PPL_API_KEY" -F file=@serum.png
   # → { "url": "https://…/serum.png", "kind": "image", … }
   
   curl https://ppl.studio/api/v1/props \
     -H "Authorization: Bearer $PPL_API_KEY" -H "Content-Type: application/json" \
     -d '{ "name": "Glow Serum", "category": "handheld", "text": "Vitamin C serum, 30 ml",
           "image_urls": ["https://…/serum.png"] }'

4. 4

   Start a video run

   Pick a workflow from GET /api/v1/presets — each lists what it needs and an example body. This one reads a product page:

   terminal

   Copy

   curl https://ppl.studio/api/v1/flows \
     -H "Authorization: Bearer $PPL_API_KEY" -H "Content-Type: application/json" \
     -d '{ "preset": "creator-ugc-video", "creatorSlug": "mia-…",
           "briefSource": { "mode": "url", "value": "https://yourstore.com/products/glow-serum" } }'
   # → { "runId": "3f1c9a…" }

5. 5

   Approve the preview, download the video

   Poll the run. Its next field says what it waits on and which call moves it on. At the preview, check the frames and the estimate, approve, and poll again until cut.url is set.

   terminal

   Copy

   curl https://ppl.studio/api/v1/flows/3f1c9a… -H "Authorization: Bearer $PPL_API_KEY"
   # → "awaiting": "gate", "estimate": { "usd": 1.2, "clips": 3 }, "frames": [ … ],
   #   "next": { "action": "approve", "call": { "method": "POST", "path": "/api/v1/flows/3f1c9a…/approve" } }
   
   curl -X POST https://ppl.studio/api/v1/flows/3f1c9a…/approve -H "Authorization: Bearer $PPL_API_KEY"
   # … a few minutes later: "finishedAt": "…", "cut": { "url": "https://…/final.mp4" }

Built to run unattended

API or MCP server?

Questions