---
title: "Suggest Compilation Bundles"
method: POST
path: "/api/v1/compilations/suggest"
tags: ["Compilations"]
---

# Suggest Compilation Bundles

`POST /api/v1/compilations/suggest`

## Request

- Base URL: `https://api.clipmaster.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.clipmaster.app/api/v1/compilations/suggest`
- Auth: HTTP bearer

Propose themed clip bundles across the user's library for a free-form prompt.
Stateless — nothing is persisted until the client calls /from-suggestion.
Per-user rate-limited; cost control via PF2 option (A).

## Request body

- CompilationSuggestRequest
  - `prompt` string, required
  - `min_duration_sec` number, nullable
  - `max_suggestions` integer

## Response `200`

Successful Response

- CompilationSuggestResponse
  - `suggestions` SuggestionBundle[], required
    - `theme` string, required
    - `reason` string, required
    - `clip_ids` integer[], required
    - `total_duration_sec` number, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/clipmaster/apis/semantic-video-clip-ai-agent.md) · [All operations](https://skmtc.dev/clipmaster/apis/semantic-video-clip-ai-agent/llms.txt) · [OpenAPI document](https://skmtc.dev/clipmaster/apis/semantic-video-clip-ai-agent/revisions/c9b8333cd22b?raw)