REST · OpenAPI 3.1

REST API и OpenAPI

Найдите модели, аккаунты и методы в каталоге возможностей перед генерацией, публикацией, работой с персонами, аналитикой, сессиями и удалёнными машинами.

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

Защита API

Понятные ограничения для каждого вызова автоматизации

Запросы REST и удалённого MCP одновременно учитываются по API-ключу, аккаунту и IP клиента. Достижение любого лимита останавливает вызов до бизнес-обработки, снижая злоупотребления и неконтролируемые расходы.

Порядок значений КлючАккаунтIP

Лимиты по умолчанию за 60 секунд

Чтение: 120 · 240 · 300
Запись: 30 · 60 · 120
Платные: 5 · 10 · 20
Загрузка: 300 · 600 · 900
MCP: 60 · 120 · 180

Discovery-first workflow

Все возможности используют изоляцию арендаторов, роли, область видимости аккаунтов и аудит. Доступные модели и аккаунты определяются настройками после входа.

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.