npm install @golpoai/sdk

import Golpo from '@golpoai/sdk';

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

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;
  language?:              string;
  style?:                 'solo-male-3' | 'solo-female-3' | 'solo-male-4' | 'solo-female-4';
  bgMusic?:               'jazz' | 'lofi' | 'dramatic' | 'engaging' | 'hyper' | 'inspirational' | 'documentary' | null;
  videoType?:             'short' | 'long';
  includeWatermark?:      boolean;
  logo?:                  string;
  timing?:                0.25 | 0.5 | 1 | 2 | 4 | 8 | 10 | 15;
  pollIntervalMs?:        number;

  // Color / background
  useColor?:              boolean;

  // Script
  newScript?:             string;

  // Visual styles
  useLineart2Style?:      string;
  use2Style?:             boolean;
  // Published v1.0.2 declaration. See the Canvas compatibility note below.
  imageStyle?:            'neon' | 'whiteboard' | 'modern_minimal' | 'playful' | 'technical' | 'editorial';
  penStyle?:              'stylus' | 'marker' | 'pen';
  showPencilCursor?:      boolean;
  pacing?:                'normal' | 'fast';

  // Branding
  logoPlacement?:         string;
  videoInstructions?:     string;

  // Audio
  audioClip?:             string | string[];
  userAudioInVideo?:      number[] | string;

  // User assets
  userImages?:            string | string[];
  userImagesDescriptions?: string | string[];
  userVideos?:            string | string[];
  userVideosDescription?: string | string[];
  inputImages?:           string | string[];
  useAsIs?:               string | boolean[];
  skipAnimation?:         string | boolean[];

  // Workflow
  isPublic?:              boolean;
  justReturnScript?:      boolean;
}

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

interface CreatePodcastOptions {
  uploads?:           string | Iterable<string>;
  voiceInstructions?: string;
  language?:          string;
  style?:             'solo-male-4' | 'solo-female-4' | 'solo-male-3' | 'solo-female-3';
  bgMusic?:           'jazz' | 'lofi' | 'dramatic' | 'engaging' | 'hyper' | 'inspirational' | 'documentary' | null;
  pollIntervalMs?:    number;

  newScript?:         string;
  timing?:            0.25 | 0.5 | 1 | 2 | 4 | 8 | 10 | 15;
}

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);

const result = await golpo.createVideo('Explain quantum computing basics', {
  voiceInstructions: 'Speak in a warm British accent with a calm, professorial tone. Pause slightly between key concepts for emphasis.',
  style: 'solo-male-3',
});

const result = await golpo.createVideo('Company quarterly results overview', {
  videoInstructions: 'Use clean corporate visuals with data charts and graphs. Include stock footage of modern office environments. Prefer blue and white color palette.',
  style: 'solo-female-3',
});

import type { CreateVideoOptions } from '@golpoai/sdk';

const result = await golpo.createVideo('How solar panels convert sunlight to electricity', {
  use2Style: true,
  imageStyle: 'modern_minimal_compact' as unknown as NonNullable<CreateVideoOptions['imageStyle']>,
  penStyle: 'stylus',
  timing: 2,
});

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);
  }
}