AI clipping

curl -X POST "https://api.heygen.com/v3/clips" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": { "type": "url", "url": "https://example.com/interview.mp4" },
    "max_clips": 5,
    "instruction": "Pull the moments where the founder talks about pricing and growth.",
    "aspect_ratio": "9:16",
    "enable_caption": true
  }'

curl -X GET "https://api.heygen.com/v3/clips/clip_abc123" \
  -H "X-Api-Key: $HEYGEN_API_KEY"

{
  "data": {
    "id": "clip_abc123",
    "title": "Founder interview",
    "status": "completed",
    "transcript_source": "auto",
    "clips": [
      {
        "id": "c_7f2e91ac",
        "label": "Why we changed our pricing",
        "url": "https://heygen-product.s3-accelerate.amazonaws.com/clips/c_7f2e91ac...mp4?X-Amz-Algorithm=...",
        "start": 142.0,
        "end": 168.4,
        "duration": 26.4,
        "aspect_ratio": "9:16",
        "score": 0.93,
        "caption_url": "https://heygen-product.s3-accelerate.amazonaws.com/clips/c_7f2e91ac...vtt?X-Amz-Algorithm=..."
      }
    ],
    "created_at": 1717000000,
    "failure_message": null
  }
}

curl -X GET "https://api.heygen.com/v3/clips?limit=10" \
  -H "X-Api-Key: $HEYGEN_API_KEY"

{
  "data": [
    {
      "id": "clip_abc123",
      "title": "Founder interview",
      "status": "completed",
      "created_at": 1717000000
    }
  ],
  "has_more": false,
  "next_token": null
}

curl -X DELETE "https://api.heygen.com/v3/clips/clip_abc123" \
  -H "X-Api-Key: $HEYGEN_API_KEY"

{
  "data": {
    "id": "clip_abc123"
  }
}

while true; do
  STATUS=$(curl -s "https://api.heygen.com/v3/clips/clip_abc123" \
    -H "X-Api-Key: $HEYGEN_API_KEY" | jq -r '.data.status')
  echo "Status: $STATUS"
  [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ] && break
  sleep 10
done

{ "type": "url", "url": "https://example.com/recording.mp4" }

{ "type": "asset_id", "asset_id": "asset_xyz789" }

import time
import requests

API_KEY = "YOUR_API_KEY"
BASE = "https://api.heygen.com"
HEADERS = {"x-api-key": API_KEY, "Content-Type": "application/json"}


def clip_video(video_url, max_clips=5, instruction=None):
    """Start a clip job, wait for it, and return the finished clips."""
    body = {
        "video": {"type": "url", "url": video_url},
        "max_clips": max_clips,
        "aspect_ratio": "9:16",
        "enable_caption": True,
    }
    if instruction:
        body["instruction"] = instruction

    job_id = requests.post(f"{BASE}/v3/clips", headers=HEADERS, json=body).json()["data"]["clip_job_id"]

    while True:
        job = requests.get(f"{BASE}/v3/clips/{job_id}", headers=HEADERS).json()["data"]
        if job["status"] in ("completed", "failed"):
            break
        time.sleep(10)

    if job["status"] == "failed":
        raise RuntimeError(job.get("failure_message") or "clip job failed")
    return job["clips"]


for clip in clip_video("https://example.com/interview.mp4", instruction="Best product moments"):
    print(f"{clip['label']} ({clip['duration']}s) -> {clip['url']}")