api

API overview

One REST surface at /api/v1 backs the studio, the MCP server, and your integrations.

Last updated 2026-07-10

Base URL

base url

https://cadenza.media/api/v1

GET /api/v1 returns a live discovery document listing every tool, its method, path, and required scope. The MCP tools are thin mappings over these endpoints, so agent and REST behavior never drift.

The tools

Tool	Method and path	Scope
generate_video	`POST /generate_video`	generate
generate_video_staged	`POST /generate_video_staged`	generate
animate_image	`POST /animate_image`	generate
ad_from_url	`POST /ad_from_url`	brand+generate
refine_shot	`POST /refine_shot`	generate
extend_sequence	`POST /extend_sequence`	generate
get_story_intelligence_report	`POST /story_intelligence_report`	read
plan_director_prompt	`POST /director_prompt_plan`	read
list_models	`GET /models`	read
list_brand_profiles	`GET /brand_profiles`	read
set_brand_profile	`POST /brand_profiles`	brand
list_publish_connections	`GET /publish/connections`	publish
publish_video	`POST /publish_video`	publish

Conventions

JSON in, JSON out. Send Content-Type: application/json.
Auth via Authorization: Bearer cadk_... or a signed-in browser session.
Free planning calls (read scope) never spend; billable work needs generate or publish.
Errors are structured; see errors.