---
title: "POST /flowmusic/v1/video-clip"
method: POST
path: "/flowmusic/v1/video-clip"
---

# POST /flowmusic/v1/video-clip

`POST /flowmusic/v1/video-clip`

Download video processing

## Request body

- VideoclipRequest
  - `clip_id` string, required — Music clip_id to generate video.
  - `preset` 'simple' | 'modern' | 'player' — Video template preset
  - `hook_url` string — Business callback URL after task completion; no callback push when empty

## Response `200`

Request successful

- object
  - `status` string, required
  - `message` string, required
  - `data` object, required

## Other responses

- `400` — Parameter error
- `401` — Authorization failed

---

[API](https://skmtc.net/ttapi/apis/flowmusic-api-docs.md) · [All operations](https://skmtc.net/ttapi/apis/flowmusic-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ttapi/flowmusic-api-docs/versions/f27f8a59dbd0/schema)