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 keys → Create key. Copy the full key when shown, it 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 and poll for results

Start a job, poll until it finishes, then download the file to your storage. Up to 5 jobs can run at the same time 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.

Download full API reference Open dashboard