npm install @golpoai/sdk

import Golpo from '@golpoai/sdk';

const golpo = new Golpo("api-key"); // Replace with your actual API key

// Optional: custom base URL
const golpoCustom = new Golpo("api-key", "https://custom-api.golpoai.com");

async createVideo(
  prompt: string,
  options?: CreateVideoOptions
): Promise<GenerationResult>  // { url, script, videoId }

interface GenerationResult {
  url:     string;  // URL to download/stream the generated video
  script:  string;  // Full transcript/script of the video
  videoId: string;  // Job ID for getFrameAnimations / editVideo
}

interface CreateVideoOptions {
  uploads?:           string | Iterable<string>;
  voiceInstructions?: string;
  personality1?:      string;
  doResearch?:        boolean;
  ttsModel?:          'accurate' | 'fast';
  language?:          string;
  style?:             'solo-male' | 'solo-female';
  bgMusic?:           'engaging' | 'lofi' | null;
  bgVolume?:          number;
  outputVolume?:      number;
  videoType?:         'short' | 'long';
  includeWatermark?:  boolean;
  logo?:              string;
  timing?:            '1' | '2';
  pollIntervalMs?:    number;
  concurrency?:       number;
}

async getFrameAnimations(videoId: string): Promise<Record<string, string>>

const result     = await golpo.createVideo('Explain AI in 2 minutes');
const animations = await golpo.getFrameAnimations(result.videoId);

for (const [frameId, url] of Object.entries(animations)
    .sort(([a], [b]) => parseInt(a) - parseInt(b))) {
  console.log(`Frame ${frameId}: ${url}`);
}

async editVideo(
  videoId: string,
  opts: EditVideoOptions
): Promise<VideoEditResult>  // { videoUrl, jobId }

const videoResult = await golpo.createVideo('Product demo in 3 scenes');
const editResult  = await golpo.editVideo(videoResult.videoId, {
  frameIds:    ['1'],
  editPrompts: ['Replace the background with a beach sunset'],
  videoUrl:    videoResult.url,
  autoCombine: true,
});
console.log('Edited video URL:', editResult.videoUrl);

async combineVideos(opts: CombineVideosOptions): Promise<CombinedVideoResult>  // { url }

const animations = await golpo.getFrameAnimations(videoId);
const mp4Urls    = Object.entries(animations)
  .sort(([a], [b]) => parseInt(a) - parseInt(b))
  .map(([, url]) => url);

const combined = await golpo.combineVideos({ mp4Urls, videoUrl: originalVideoUrl });
console.log('Combined video:', combined.url);

try {
  const result = await golpo.createVideo('My prompt', options);
  console.log(result.url);
} catch (error: any) {
  if (error.response?.data?.detail) {
    // API validation error
    console.error('API Error:', error.response.data.detail);
  } else {
    // Network, file not found, etc.
    console.error('Error:', error.message);
  }
}