Create a clipping/captions project

POSTapi.vdclip.com/v1/projects

AuthAuthorization: Bearer <token>scope: vdclip:projects:write

Credit-bearing: debits credits on accept. Send Idempotency-Key to make retries safe.

Headers

idempotency-keystringoptional

Body

ai_typeAiTyperequired

AI processing mode: clipping (split into clips) or captions (transcribe only).

aspect_ratiostringoptional

Target aspect ratio for output clips. Omit for auto (9:16 portrait).

categorystringoptional

Content category for AI processing hints. Omit for auto-detection.

clip_durationsstringoptional

Desired duration range(s) for generated clips. Omit for auto.

languageVideoLanguagerequired

Language code of the source video audio. Must be a supported ISO 639-1 code.

preset_idstringoptional

A known caption preset id. Stable ids include: vdclip-impact, hormozi, tiktok-viral. The catalog can grow over time.

range_endstringoptional

End timestamp in seconds. Omit to process through the end.

range_startstringoptional

Start timestamp in seconds to process only a portion of the source. Omit to process from the beginning.

template_idstringoptional

Template id to apply saved settings. Omit to use defaults.

video_urlstringrequired

Public URL of the source video. YouTube, Vimeo, and direct MP4 links are supported.

curl -X POST 'https://api.vdclip.com/v1/projects' \
  -H 'Authorization: Bearer eyJraWQiOiJrMSIsInR5cCI6ImF0K2p3dCIsImFsZyI6IkVTMjU2In0.eyJzdWIiOiJ1c2VyX2ExYjJjM2Q0ZTVmNmczZCJ9.demo-signature' \
  -H 'Content-Type: application/json' \
  -d '{
  "ai_type": [],
  "aspect_ratio": [],
  "category": [],
  "clip_durations": [],
  "language": [],
  "preset_id": [],
  "range_end": [],
  "range_start": [],
  "template_id": [],
  "video_url": "string"
}'

{
  "ai_type": "clipping",
  "aspect_ratio": "9:16",
  "created_at": "2026-06-20T14:32:00Z",
  "id": "proj_a1b2c3d4",
  "source_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "status": "processing",
  "thumbnail": "https://assets.vdclip.com/proj_a1b2c3d4/thumb.jpg",
  "title": "The future of AI in media"
}