---
title: "Public Generate Questions"
method: POST
path: "/api/v1/public/questions/generate"
tags: ["public-api"]
---

# Public Generate Questions

`POST /api/v1/public/questions/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/questions/generate`
- Auth: none declared

為特定教學時機生成精準提問。

不同於通用「生成問題」，此端點會根據 moment_type（opening/transition/
check_understanding/provoke_thinking/closing）產出對應風格的提問，
並附上 facilitator_note 指引講師如何引導、等待、救場。

同步呼叫，2-5 秒回傳。

## Headers

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

## Request body

- PublicQuestionsRequest
  - `topic` string, required: 主題或一段內容，例：『說故事的黃金三角』或一張 slide 的講述要點
  - `moment_type` 'opening' | 'transition' | 'check_understanding' | 'provoke_thinking' | 'closing', required: 使用時機：opening(開場) / transition(段落銜接) / check_understanding(驗證吸收) / provoke_thinking(製造認知衝突) / closing(收斂)
  - `count` integer: 生成幾個問題（1-10）
  - `audience` string, nullable: 對象描述（選填）
  - `language` 'zh-TW' | 'zh-CN' | 'en' | 'ja'

## Response `200`

Successful Response

- PublicQuestionsResponse
  - `questions` PublicQuestion[], required
    - `text` string, required: 問題文字
    - `question_type` 'open' | 'closed' | 'rhetorical' | 'hypothetical', required
    - `expected_response_time_seconds` integer, required: 預估學員回應時間（秒）
    - `facilitator_note` string, required: 給講師的引導建議（如何問、問完怎麼接）
  - `moment_type` string, required
  - `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)