---
title: "Render a YouTube clip (async)"
method: POST
path: "/api/v1/clip"
---

# Render a YouTube clip (async)

`POST /api/v1/clip`

## Request

- Base URL: `https://www.startuphub.ai`
- URL: `https://www.startuphub.ai/api/v1/clip`
- Auth: HTTP bearer

Enqueue a vertical/landscape clip from a YouTube video. Caller supplies start/end timestamps and on-screen quote. Poll GET /api/v1/clip/{jobId}. Credits scale with length x quality.

## Request body

- object
  - `video_url` string, uri
  - `video_id` string
  - `start_seconds` number, required
  - `end_seconds` number, required
  - `quote` string, required
  - `aspect` '9:16' | '16:9'
  - `quality` '720p' | '1080p'

## Response `200`

Job enqueued: { jobId, status, poll_url, cost }

## Other responses

- `401`: Missing or invalid API key
- `402`: Insufficient credits

---

[API](https://skmtc.dev/startuphub/apis/startuphub-ai-api.md) · [All operations](https://skmtc.dev/startuphub/apis/startuphub-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/startuphub/apis/startuphub-ai-api/revisions/c9965e4ba7e2?raw)