PlayAI model · API & MCP

PlayAI integration guide

PlayAI is the AI model developed by PlayableLab — trained for advertising creative. It generates and refines campaign copy, visuals, motion, voice, and music while keeping typography legible and minimizing product-shot distortion.

Use the REST API from your server with API keys, or connect PlayableLab MCP inside Claude, ChatGPT, and similar apps. Both paths deliver finished files for download. Results from the API and MCP are not editable — open the signed-in PlayableLab dashboard to refine copy, timing, voice, music, and interactions.

PlayAI API

One job per request. Pick one model: PlayAIV (video), PlayAIP (interactive ad), or PlayAII (image). Credits apply to the account that owns the API key. API output is download-only — poll for status, then fetch fileUrl as raw bytes (not JSON). Editing requires the PlayableLab dashboard.

ModelOutput
PlayAIVVideo MP4
PlayAIPInteractive ad (preview + export package)
PlayAIIStill image / banner
1

Get an API key

Sign in at PlayableLab → profile menu → Account → 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 one job at a time

Start a job, poll until it finishes, then download the file to your storage.

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