---
title: "Generate Teaser Endpoint"
method: POST
path: "/v1/admin/marketing/generate-teaser"
tags: ["marketing-teaser"]
---

# Generate Teaser Endpoint

`POST /v1/admin/marketing/generate-teaser`

## Request

- Base URL: `https://api.storyflo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.storyflo.com/v1/admin/marketing/generate-teaser`
- Auth: none declared

Render a teaser .mp4, upload to R2, return the public URL.

Returns 503 if ffmpeg isn't installed or the Kokoro model isn't
loaded — these are deployment-environment problems, not bad
requests, so the operator sees the right signal.

## Headers

- `x-storyflo-email-token` string, nullable

## Request body

- GenerateTeaserRequest
  - `tagline` string
  - `voice_id` string
  - `format` 'square' | 'vertical'
  - `duration_s` integer

## Response `200`

Successful Response

- GenerateTeaserResponse
  - `url` string, required
  - `size_bytes` integer, required
  - `duration_s` integer, required
  - `format` 'square' | 'vertical', required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/storyflo/apis/storyflo-inference-router.md) · [All operations](https://skmtc.dev/storyflo/apis/storyflo-inference-router/llms.txt) · [OpenAPI document](https://skmtc.dev/storyflo/apis/storyflo-inference-router/revisions/c3a1a735ac7a?raw)