public-api

Public Generate Course Experience

使用 AI 生成課程體驗藍圖（骨架版）。

基於主題、時長、對象、能量曲線，產出課程大綱級的活動序列。每個活動包含類型、標題、時長、簡短說明。不包含 deepen 類的 7 欄位深度，深度欄位請另呼叫 POST /activity/deepen。

必填：topic, duration_minutes, audience。選填：energy_curve（預設 build_up）、learning_objectives、language。

回應為同步，3-8 秒。

post/api/v1/public/course-experience/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/course-experience/generate
Auth: none declared

Authorizationstring nullable

X-API-Keystring nullable

topicstring required

課程主題，例：『向企業主管說故事』

duration_minutesinteger required

總時長（分鐘），10-480

audiencestring required

對象，例：『企業中高階主管』

energy_curve'build_up' | 'wave' | 'intensive_then_reflect'

能量曲線

learning_objectivesstring[] nullable

學習目標（選填，沒給就由 AI 生成）

language'zh-TW' | 'zh-CN' | 'en' | 'ja'

Successful Response

blueprint_idstring required

Blueprint 唯一識別碼；後續教學深度工具（activity/deepen）需傳此 id，且狀態需先為 confirmed

blueprint_status'pending_confirmation' | 'confirmed'

titlestring required

total_duration_minutesinteger required

target_audiencestring required

design_philosophystring required

learning_objectivesstring[] required

energy_curvestring required

summarystring required

next_suggestionstring required

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