PlayAI model · API & MCP

PlayAI integration guide

PlayAI is PlayableLab's ad production model. Use the REST API or MCP to produce finished ad videos for download, the same single-shot production as the dashboard, from your own stack or assistant apps.

PlayableLab API

One job per request, one output: a finished ad video (MP4). Send a brief, optionally with a product link, reference images, a reference clip, or campaign data, and poll for status, then fetch fileUrl as raw bytes (not JSON). Credits apply to the account that owns the API key.

InputOutput
Brief (prompt + aspect ratio, optional duration, references, campaign data)Finished ad video (MP4)
1

Get an API key

Sign in at PlayableLab → profile menu → API integration → Create key. Copy the API key and webhook signing secret when shown — each is only displayed once.

2

Authenticate every request

Send your key as a Bearer token. Keep it on your server only, never in a browser or mobile app.

3

Run jobs — poll or webhook

Start a job, then either poll GET /runs/{id} until terminal status or pass HTTPS callback_url on POST /run for a completion webhook. Download the MP4 with the same API key. Up to 5 unfinished jobs per account.

Start

POST /api/public/v1/run

Status

GET /api/public/v1/runs/{id}

Recent runs

GET /api/public/v1/runs

Download

Use fileUrl from the succeeded run JSON.

Polling or webhooks

Authenticate with Authorization: Bearer plk_live_… (create keys in dashboard → API integration). Wait for completion by polling GET /runs/{id} or by adding HTTPS callback_url on POST /run. Verify inbound webhooks with whsec_… from the same dashboard panel.

Download API integration guide Open dashboard MCP integration