---
title: "Public Generate Course Experience"
method: POST
path: "/api/v1/public/course-experience/generate"
tags: ["public-api"]
---

# Public Generate Course Experience

`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

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

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

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

回應為同步，3-8 秒。

## Headers

- `Authorization` string, nullable
- `X-API-Key` string, nullable

## Request body

- PublicCourseExperienceRequest
  - `topic` string, required: 課程主題，例：『向企業主管說故事』
  - `duration_minutes` integer, required: 總時長（分鐘），10-480
  - `audience` string, required: 對象，例：『企業中高階主管』
  - `energy_curve` 'build_up' | 'wave' | 'intensive_then_reflect': 能量曲線
  - `learning_objectives` string[], nullable: 學習目標（選填，沒給就由 AI 生成）
  - `language` 'zh-TW' | 'zh-CN' | 'en' | 'ja'

## Response `200`

Successful Response

- PublicCourseExperienceResponse
  - `blueprint_id` string, required: Blueprint 唯一識別碼；後續教學深度工具（activity/deepen）需傳此 id，且狀態需先為 confirmed
  - `blueprint_status` 'pending_confirmation' | 'confirmed'
  - `title` string, required
  - `total_duration_minutes` integer, required
  - `target_audience` string, required
  - `design_philosophy` string, required
  - `learning_objectives` string[], required
  - `energy_curve` string, required
  - `activities` CourseActivity[], required
    - `type` 'lecture' | 'discussion' | 'exercise' | 'poll' | 'reflection' | 'demo' | 'case_study' | 'pair_work' | 'group_work' | 'quiz' | 'video' | 'break' | 'cta', required
    - `title` string, required
    - `duration_minutes` integer, required
    - `summary` string, required: 1-2 句活動說明
  - `summary` string, required
  - `next_suggestion` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/slidemaster/apis/slidemaster-ai-api.md) · [All operations](https://skmtc.dev/slidemaster/apis/slidemaster-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/slidemaster/apis/slidemaster-ai-api/revisions/a964c005977e?raw)