---
title: "Public Pipeline Topic To Video"
method: POST
path: "/api/v1/public/pipelines/topic-to-video"
tags: ["public-api"]
---

# Public Pipeline Topic To Video

`POST /api/v1/public/pipelines/topic-to-video`

## 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/pipelines/topic-to-video`
- Auth: none declared

One-click pipeline: topic to slides/scripts/video (async).

Auto: outline → render slides → scripts → TTS → video.
Required: topic. Optional: slides_count, language, style,
tts_provider, tts_voice, image_size, include_scripts, include_video.
Poll getProjectStatus for progress.

品牌片頭/片尾：若用戶已在主站按過「儲存為預設」，本 pipeline 建立的專案
會自動套用預設片頭/片尾，合成的影片直接帶品牌開場/結尾。尚未設定時，
可指導用戶到 slidemaster.tw 專案頁「設定片頭片尾」上傳並儲存為預設；
中插影片在專案頁各投影片卡片設定後重新合成（generateVideo force=true）。
教學：https://slidemaster.tw/guides/intro-outro-midroll-guide

## Headers

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

## Request body

- PublicPipelineRequest
  - `topic` string, required
  - `slides_count` integer, nullable
  - `language` 'zh-TW' | 'zh-CN' | 'en' | 'ja', nullable
  - `style` 'professional' | 'casual' | 'educational' | 'storytelling', nullable
  - `tts_provider` 'gemini' | 'cosyvoice' | 'azure', nullable
  - `tts_voice` string, nullable
  - `image_size` '1K' | '2K' | '4K', nullable
  - `include_scripts` boolean, nullable
  - `include_video` boolean, nullable
  - `dry_run` boolean, nullable: 若為 true，僅回傳預估成本，不實際執行 pipeline
  - `conversation_id` string, nullable

## Response `202`

Successful Response

- PublicPipelineResponse
  - `project_id` string, required
  - `status` string, required
  - `message` string, required
  - `summary` string
  - `next_suggestion` string

## 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)