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.