public-api

Public Generate Script

為指定投影片觸發 AI 講稿生成(非同步)。

將講稿生成任務加入佇列,由背景 worker 執行。回傳 202 Accepted 表示任務已排入。 可透過 GET /projects/{id}/status 輪詢進度。

必填欄位:slide_id(投影片 ID)。 選填:prompt_style(講稿風格,預設 professional)、regenerate(是否覆寫既有講稿)。

錯誤:

  • 404:投影片不存在。
  • 400:投影片沒有關聯的專案。
  • 403:該專案不屬於目前使用者。
post/api/v1/public/scripts/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/scripts/generate
  • Auth: none declared

Headers

Authorizationstring nullable
X-API-Keystring nullable

Request body

slide_idstring required
prompt_style'professional' | 'casual' | 'educational' | 'storytelling' nullable
regenerateboolean nullable
language'zh-TW' | 'zh-CN' | 'en' | 'ja' 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.