public-api

Public Batch Generate Scripts

為專案中所有(或指定)投影片批量觸發 AI 講稿生成(非同步)。

若未指定 slide_ids,則對專案內所有投影片生成講稿。傳統型專案優先使用 batch_generate_script 任務以確保上下文連貫。回傳 202 Accepted。

必填欄位:project_id(專案 ID)。 選填:slide_ids(指定投影片清單)、prompt_style(講稿風格)、regenerate(覆寫既有)。

錯誤:

  • 404:專案不存在。
  • 403:該專案不屬於目前使用者。
  • 400:沒有找到需要生成講稿的投影片。
post/api/v1/public/scripts/batch-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/batch-generate
  • Auth: none declared

Headers

Authorizationstring nullable
X-API-Keystring nullable

Request body

project_idstring required
prompt_style'professional' | 'casual' | 'educational' | 'storytelling' nullable
regenerateboolean nullable
slide_idsstring[] 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.