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.