YouTube to Clips
POST/clip6+ credits

YouTube to Clips

Render a vertical or landscape clip from a YouTube video with on-screen quote captions. Async: returns jobId; poll GET /clip/{jobId}. Credits scale with clip length and quality (typically 6 to 15+). You supply start/end timestamps and the quote text; use the web tool at /youtube-to-clips to discover clip timestamps. API renders are never watermarked.

POSThttps://www.startuphub.ai/api/v1/clip

Request

curl -X POST "https://www.startuphub.ai/api/v1/clip" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"video_url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","start_seconds":30,"end_seconds":55,"quote":"The key insight is distribution beats product alone."}'

Parameters

video_urlstringoptional

YouTube URL. Provide video_url OR video_id.

video_idstringoptional

YouTube video id.

start_secondsnumberrequired

Clip start time in seconds.

end_secondsnumberrequired

Clip end time in seconds.

quotestringrequired

On-screen caption text (min 8 chars).

aspectstringoptionaldefault: 9:16

9:16 (default) or 16:9.

qualitystringoptional

720p (default) or 1080p (Pro Mini+).

stylestringoptionaldefault: twitter

quotes | twitter | shorts | all

Response

json
{
  "jobId": "uuid",
  "status": "queued",
  "poll_url": "/api/v1/clip/uuid",
  "retry_after_seconds": 15,
  "cost": 9,
  "credits_remaining": 991
}

Errors

400Invalid video, quote, or time range
401Invalid or missing API key
402Insufficient credits
4031080p requires Pro Mini or higher