SDK Overview

npm install vidjutsu

import { createClient } from "vidjutsu";

const vj = createClient();

// Watch a video
const { data } = await vj.watchMedia({
  mediaUrl: "https://cdn.example.com/video.mp4",
  prompt: "Is the hook strong enough for fitness TikTok?",
});
console.log(data.response);

// Extract frames and audio
const { data: extract } = await vj.extractMedia({
  mediaUrl: "https://cdn.example.com/video.mp4",
  frames: "auto",
  audio: true,
});

// Transcribe speech
const { data: transcript } = await vj.transcribeMedia({
  mediaUrl: "https://cdn.example.com/video.mp4",
});
console.log(transcript.transcript);

// Scan a caption against Instagram's policies
const { data: compliance } = await vj.checkCompliancePrompt({
  text: "Get rich in 30 days guaranteed",
  platform: "instagram",
});

// Reads from env var or config file automatically
const vj = createClient();

// Or pass explicitly
const vj = createClient({ apiKey: "vj_live_..." });

// Custom base URL (for staging, self-hosted, etc.)
const vj = createClient({ baseUrl: "https://staging.api.vidjutsu.ai" });

const { data, error } = await vj.api.GET("/v1/usage");
const { data, error } = await vj.api.POST("/v1/watch", {
  body: { mediaUrl: "...", prompt: "..." },
});