REST · OpenAPI 3.1

REST API và OpenAPI

Khám phá mô hình, tài khoản và endpoint từ danh mục khả năng trước khi dùng tính năng tạo, xuất bản, persona, phân tích, phiên và máy từ xa.

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

Bảo vệ API

Giới hạn tần suất rõ ràng cho mọi lệnh tự động

Yêu cầu REST và MCP từ xa được đếm đồng thời theo API Key, tài khoản và IP máy khách. Chạm bất kỳ giới hạn nào sẽ dừng trước khi xử lý nghiệp vụ, giúp ngăn lạm dụng và chi phí tăng ngoài kiểm soát.

Thứ tự giá trị KhóaTài khoảnIP

Hạn mức mặc định mỗi 60 giây

Đọc: 120 · 240 · 300
Ghi: 30 · 60 · 120
Tính phí: 5 · 10 · 20
Tải lên: 300 · 600 · 900
MCP: 60 · 120 · 180

Discovery-first workflow

Mọi khả năng đều dùng chung cơ chế tách tenant, phân quyền vai trò, phạm vi tài khoản và nhật ký kiểm toán. Mô hình và tài khoản khả dụng phụ thuộc cấu hình sau khi đăng nhập.

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.