API Reference

🧩 Open Swagger UI Interactive reference. Paste your pk_live_... key and execute real requests.

📄 OpenAPI 3.0 JSON Raw spec for Postman, Insomnia, OpenAPI codegen, or pasting into Claude / Cursor.

Base URL

https://api.playcut.ai

For local development: http://localhost:3001

All endpoints require:

Authorization: Bearer pk_live_<40 hex chars>

See Authentication for details.

The Swagger UI is the source of truth. This is just a quick map of what’s available.

Tool	Description
`generate-image-from-text`	Text → image (Gemini, Grok)
`generate-image-from-reference`	Reference images → new image
`generate-video-from-text`	Text → video (Veo, Grok)
`generate-video-from-image`	Animate a still image
`generate-video-from-reference`	Reference style → video
`generate-video-interpolation`	Interpolate between two frames
`generate-video-extension`	Extend a video clip
`generate-tts`	Text-to-speech
`design-voice`	Create a custom voice from description
`clone-voice-from-audio`	Clone a voice from audio sample
`generate-actor`	Generate an AI actor appearance
`actor-shoot`	Photo shoot for an actor
`actor-act`	Multi-step actor video pipeline
`get-task-status`	Poll task completion
`wait-for-task`	Block until task completes
`list-assets` / `get-asset` / `download-asset`	Manage media library
`create-session` / `list-sessions`	Manage generation sessions
`list-folders` / `create-folder`	Organize content
`list-actors` / `update-actor` / `clone-actor-template`	Actor library
`list-voices`	Voice library
`list-brand-kits` / `get-brand-kit`	Brand assets
`get-credit-balance` / `get-current-workspace`	Account info

Method	Path	Purpose
`POST`	`/api/v1/api-keys`	Create a key (returns plaintext + webhook secret once)
`GET`	`/api/v1/api-keys`	List keys in workspace
`DELETE`	`/api/v1/api-keys/:id`	Revoke a key
`POST`	`/api/v1/api-keys/:id/webhook/test`	Send a test webhook event