REST API
Build app-owned video generation, asset, reference, and editor workflows with the Videotok REST API.
Overview
Videotok has two developer surfaces.
This section documents the REST API. Use it when your app, backend, automation, or SDK owns the workflow.
Use the MCP Server when an AI agent should operate Videotok directly for a signed-in user.
REST API At A Glance
The REST API is available to paid workspaces.
Use it to create static ads, video ads, UGC ads, slideshows, faceless videos, AI model outputs, and editable video projects.
https://videotok.app/api/v1Calculated and deducted server-side before a paid job is queued.
Not Looking For REST?
Use the MCP Server when an AI agent should operate Videotok directly for a signed-in user.
Start Here
- Create an API key in your workspace settings.
- Call
GET /modelsto load templates, model variants, presets, and credit estimates. - Call
GET /assetswhen you need workspace brand kits, avatars, voices, or reference targets. - Call the endpoint that matches the asset type you want.
- Poll the returned id until the job is completed or failed.
Workspace-specific REST endpoints under /api/v1 use workspace API keys. Public discovery endpoints such as GET /models, GET /openapi.json, and GET /skill.md do not require an API key.
REST Surfaces
| Area | Endpoint |
|---|---|
| Catalog | GET /models |
| Workspace assets | GET /assets |
| Static ads, video ads, UGC ads, AI models | POST /generations |
| Slideshows and carousels | POST /slideshows |
| Faceless videos | POST /faceless-videos |
| Reference inspirations | GET /reference-inspirations, POST /reference-inspirations |
| Editor | /editor/videos, /editor/media |
REST Capabilities
| Capability | What the REST API controls |
|---|---|
| Catalog discovery | Load live template ids, AI model ids, variants, presets, quality tiers, and estimated credits. |
| Workspace assets | Load brand kits, avatars, voices, and reference template targets for the API key workspace. |
| Generation | Queue static ads, video ads, UGC ads, and raw AI model outputs, then poll completion. |
| Slideshows | Create slideshow/carousel workflows with product images, brand kit, avatar, language, and optional editable text overlays. |
| Faceless videos | Create prompt or script-driven videos with visuals, voiceover, captions, and final render. |
| References | Save, list, recommend, and target reference inspirations for template workflows. |
| Editor | Create editable video drafts, upload/list media, add media to timelines, and apply supported structured edits. |
Machine-Readable Docs
Use GET /api/v1/openapi.json for OpenAPI clients.
Use GET /api/v1/skill.md when an agent needs concise Videotok API instructions.
Use MCP Server docs for agent tools, scopes, resources, catalog ids, editor operations, and publishing.
Authentication
Authenticate requests and understand credit behavior.
Quick Start
Create your first static ad and poll the result.
Catalog And Assets
Load templates, models, brand kits, avatars, voices, and template targets.
Generations
Create static ads, video ads, UGC ads, and AI model outputs.
Slideshows
Create slideshow and carousel workflows.
Faceless Videos
Create faceless videos with the automatic video workflow.
References
Save and reuse reference media for generation.
Video Editor
Create editable videos, upload media, add clips, and apply edits.
Errors And OpenAPI
Handle errors and generate clients from the OpenAPI schema.