Video Studio API

curl -X POST https://www.subclip.app/api/v1/media-render/uploads \
  -H "Authorization: Bearer $SUBCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectName": "Launch montage",
    "files": [
      {
        "fileName": "intro.mp4",
        "contentType": "video/mp4",
        "fileSize": 52428800,
        "durationSeconds": 12,
        "width": 1920,
        "height": 1080
      },
      {
        "fileName": "product.png",
        "contentType": "image/png",
        "fileSize": 2048000,
        "width": 1600,
        "height": 1200
      },
      {
        "fileName": "music.mp3",
        "contentType": "audio/mpeg",
        "fileSize": 8192000,
        "durationSeconds": 90
      }
    ]
  }'

Images:
- image/jpeg
- image/png
- image/gif
- image/webp
- image/svg+xml
- image/heic
- image/heif

Videos:
- video/mp4
- video/mpeg
- video/quicktime
- video/x-msvideo
- video/webm
- video/x-matroska

Audio:
- audio/mpeg
- audio/mp3
- audio/mp4
- audio/m4a
- audio/x-m4a
- audio/wav
- audio/x-wav
- audio/webm
- audio/ogg
- audio/aac

curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  -H "Content-Length: 52428800" \
  --data-binary "@intro.mp4"

curl -X POST https://www.subclip.app/api/v1/media-render/jobs \
  -H "Authorization: Bearer $SUBCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "mrproj_...",
    "aspectRatio": "9:16",
    "outputFileName": "rendered.mp4"
  }'

curl -X POST https://www.subclip.app/api/v1/media-render/jobs \
  -H "Authorization: Bearer $SUBCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectName": "Launch montage",
    "sourceDirectoryPrefix": "user-id/media-render/mrproj_.../",
    "instructions": "Make a fast product launch montage.",
    "aspectRatio": "9:16",
    "targetDurationSeconds": 30,
    "aiAnalysis": false,
    "visionAnalysis": false,
    "audioAnalysis": false,
    "textOnScreen": false,
    "bgm": true,
    "bgmQuery": "upbeat product launch background music",
    "bgmVolume": 0.18,
    "sfx": true,
    "sfxTypes": ["click", "camera-shutter"],
    "sfxVolume": 0.55,
    "transitionTypes": ["crossfade", "slide", "pan-left"],
    "outputFileName": "launch-montage.mp4"
  }'

curl -X POST https://www.subclip.app/api/v1/media-render/jobs \
  -H "Authorization: Bearer $SUBCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectName": "Signed URL montage",
    "aspectRatio": "9:16",
    "dynamicMotion": true,
    "mediaAssets": [
      {
        "assetId": "hero_image",
        "url": "https://your-bucket.s3.amazonaws.com/hero.png?X-Amz-Signature=...",
        "fileName": "hero.png",
        "mediaType": "image",
        "contentType": "image/png",
        "durationSeconds": 4,
        "width": 1600,
        "height": 1200,
        "dynamicMotion": true
      },
      {
        "assetId": "demo_video",
        "url": "https://your-bucket.s3.amazonaws.com/demo.mp4?X-Amz-Signature=...",
        "fileName": "demo.mp4",
        "mediaType": "video",
        "contentType": "video/mp4",
        "durationSeconds": 8
      }
    ],
    "transitionTypes": ["crossfade", "pan-left", "bounce-flash"],
    "outputFileName": "signed-url-montage.mp4"
  }'

import { createReadStream, statSync } from "node:fs";

const stats = statSync("./intro.mp4");

await fetch(uploadUrl, {
  method: "PUT",
  headers: {
    "Content-Type": "video/mp4",
    "Content-Length": String(stats.size),
  },
  body: createReadStream("./intro.mp4"),
  duplex: "half",
});

curl -X POST https://www.subclip.app/api/v1/media-render/jobs \
  -H "Authorization: Bearer $SUBCLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "mrproj_...",
    "instructions": "Open with the product shot, then cut into the demo clips. Keep it energetic.",
    "aspectRatio": "9:16",
    "aiAnalysis": true,
    "visionAnalysis": true,
    "audioAnalysis": false,
    "textOnScreen": true,
    "assetDurations": [
      { "assetId": "asset_intro", "durationSeconds": 4 },
      { "fileName": "product.png", "durationSeconds": 3.5 }
    ],
    "bgm": true,
    "bgmFileName": "music.mp3",
    "bgmVolume": 0.18,
    "sfx": true,
    "sfxTypes": ["click", "camera-shutter"],
    "sfxVolume": 0.55,
    "transitionTypes": ["crossfade", "pan-left", "sway-in", "bounce-flash"],
    "outputFileName": "launch-montage.mp4"
  }'

{
  "projectId": "mrproj_...",
  "aspectRatio": "9:16",
  "aiAnalysis": false,
  "hookText": "The product finally makes sense",
  "bgm": true,
  "bgmFileName": "music.mp3",
  "sfx": true,
  "sfxTypes": ["click", "camera-shutter"],
  "sfxVolume": 0.55,
  "transitionTypes": ["crossfade", "sway-in"]
}

curl https://www.subclip.app/api/v1/media-render/jobs/mrproj_... \
  -H "Authorization: Bearer $SUBCLIP_API_KEY"

DOWNLOAD_JSON=$(curl -s https://www.subclip.app/api/v1/media-render/jobs/mrproj_.../download \
  -H "Authorization: Bearer $SUBCLIP_API_KEY")

DOWNLOAD_URL=$(echo "$DOWNLOAD_JSON" | jq -r '.downloadUrl')

curl -L "$DOWNLOAD_URL" -o rendered.mp4

const apiKey = process.env.SUBCLIP_API_KEY;

const uploads = await fetch("https://www.subclip.app/api/v1/media-render/uploads", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    projectName: "Launch montage",
    files: [
      { fileName: "intro.mp4", contentType: "video/mp4", fileSize: 52428800, durationSeconds: 12 },
      { fileName: "product.png", contentType: "image/png", fileSize: 2048000 },
    ],
  }),
}).then((r) => r.json());

// Upload every file to its matching uploads.uploads[i].uploadUrl.
// The API creates assetId, objectKey, directoryPrefix, and uploadUrl for every file in bulk.
// For Node streams, set Content-Length and duplex: "half".

await fetch("https://www.subclip.app/api/v1/media-render/jobs", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    projectId: uploads.projectId,
    instructions: "Make a fast launch montage.",
    aspectRatio: "9:16",
    aiAnalysis: true,
    visionAnalysis: true,
    textOnScreen: true,
    assetDurations: [
      { fileName: "intro.mp4", durationSeconds: 4 },
      { fileName: "product.png", durationSeconds: 3 },
    ],
    bgm: true,
    bgmQuery: "upbeat product launch background music",
    sfx: true,
    sfxTypes: ["click", "camera-shutter"],
    transitionTypes: ["crossfade", "pan-left", "sway-in", "bounce-flash"],
  }),
});

let job;
do {
  await new Promise((resolve) => setTimeout(resolve, 5000));
  job = await fetch(`https://www.subclip.app/api/v1/media-render/jobs/${uploads.projectId}`, {
    headers: { Authorization: `Bearer ${apiKey}` },
  }).then((r) => r.json());
} while (job.status !== "completed" && job.status !== "failed");

if (job.status === "failed") throw new Error(job.errorMessage || "Render failed");

const download = await fetch(`https://www.subclip.app/api/v1/media-render/jobs/${uploads.projectId}/download`, {
  headers: { Authorization: `Bearer ${apiKey}` },
}).then((r) => r.json());

console.log(download.downloadUrl);