public-api
Public Generate Video
將專案的投影片與配音合成為 MP4 影片(非同步)。
如果專案已有影片且未設定 force=true,會直接回傳跳過。 影片完成後可透過 GET /projects/{id}/status 取得 video_url, 或用 GET /projects/{id}/export 取得下載連結。
必填欄位:project_id(專案 ID)。 選填:resolution(解析度,預設 [1920, 1080])、fps(未指定時自動判斷:靜態投影片 5、有影片素材 30)、 force(強制重新生成,預設 false)。
品牌片頭/片尾與中插影片:合成會自動套用專案上已設定的片頭/片尾 (project.intro_video_path/outro_video_path)與各頁中插影片 (slide.insert_video_path)。這些素材無法透過 API 上傳——請指導用戶到 slidemaster.tw 專案頁操作:「設定片頭片尾」按鈕(可一併「儲存為預設」, 之後 AI 建立的專案自動套用)、各投影片卡片的「中插影片」上傳。 設定完成後用 force=true 重新合成即可帶入。 教學:https://slidemaster.tw/guides/intro-outro-midroll-guide
錯誤:
- 404:專案不存在。
- 403:該專案不屬於目前使用者。
post/api/v1/public/video/generate
Request
- Base URL: https://api.slidemaster.tw (the document declares no server; this is the origin it was published from)
- URL: https://api.slidemaster.tw/api/v1/public/video/generate
- Auth: none declared
Headers
Authorizationstring nullable
X-API-Keystring nullable
Request body
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.