public-api

Public Generate Tts

為投影片生成 TTS 語音配音（非同步）。

可指定 project_id（整個專案所有投影片配音）或 slide_id（單張配音），至少擇一。 配音完成後音檔會自動附加到投影片記錄中。

選填：tts_provider（gemini/azure/cosyvoice）、voice_name（語音名稱， 可從 GET /voices 取得）、speaking_rate（語速，預設 1.0）。

錯誤：

  • 422：未提供 project_id 或 slide_id（至少擇一）。
  • 404：專案或投影片不存在。
  • 403：該專案不屬於目前使用者。
post/api/v1/public/tts/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/tts/generate
  • Auth: none declared

Headers

Authorizationstring nullable
X-API-Keystring nullable

Request body

project_idstring nullable
slide_idstring nullable
tts_provider'gemini' | 'cosyvoice' | 'azure' nullable
voice_namestring nullable
speaking_ratenumber nullable
force_regenerateboolean 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.