REST · OpenAPI 3.1

REST API and OpenAPI

Discover models, accounts, and endpoints before using generation, publishing, personas, analytics, sessions, and remote machines.

Base URL: https://studio-api.mysovi.ai/api
Authentication: Authorization: Bearer $EMS_API_KEY

API protection

Clear rate boundaries for every automation call

REST and remote MCP requests are counted simultaneously by API key, account, and client IP. Reaching any limit stops work before business processing, reducing abuse and runaway cost.

Value order KeyAccountIP

Default quota per 60 seconds

Read: 120 · 240 · 300
Write: 30 · 60 · 120
Billable: 5 · 10 · 20
Upload: 300 · 600 · 900
MCP: 60 · 120 · 180

Discovery-first workflow

Every capability reuses tenant isolation, role permissions, account visibility and audit records. Available models and social accounts always depend on the signed-in tenant configuration.

Endpoint	Purpose
`GET /developer/capabilities`	Discover the complete allowlisted capability catalog
`GET /developer/openapi.json`	Download the tenant-aware OpenAPI 3.1 document
`GET /developer/models`	List available video, image, audio and music models
`GET /developer/accounts`	List visible social accounts and health
`GET /developer/status`	Query jobs, publications and account status
`POST /generate`	Create a video, image, voice, or music generation job
`POST /compose`	Create a composition job
`POST /publish/tiktok`	Create an immediate or scheduled publication; missing YouTube titles receive safe contextual defaults
`POST /publish/{id}/cancel`	Cancel a pending scheduled publication
`POST /publish/{id}/reschedule`	Change a scheduled publication time
`GET /personas · POST /personas/generate-batch`	List Persona Roster records or create an asynchronous 1–10 persona batch
`GET /analytics/groups · /staff · /accounts/daily`	Inspect account-group, staff, and daily account lifecycle analytics within caller scope
`GET /sessions`	List sanitized Session Hub records and health without cookies, tokens, or PINs
`GET /remote-desktop/catalog · /instances`	Inspect AWS and Google Cloud regions, prices, quotas, machines, and runtime state
`PATCH /remote-desktop/instances/{id}/safety`	Set delete protection and automatic-stop policy

Example

curl https://studio-api.mysovi.ai/api/developer/models \
  -H "Authorization: Bearer $EMS_API_KEY"

Responses from the authenticated capability catalog and OpenAPI document are authoritative. Read each model's maxInputImages, durations, resolutions, and feature flags instead of inferring constraints. Passwords, cookies, recovery PINs, short-lived desktop links, and session restore remain interactive-web-only and are intentionally absent from the catalog.