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

project_idstring required
resolutioninteger[] nullable
fpsinteger nullable
forceboolean nullable
billing_operation_idstring nullable

Response

Successful Response

statusstring required
messagestring required
summarystring
next_suggestionstring

Changes

No recorded changes to this operation across all 1 revision of this API.