Golpo/API Reference

API Documentation

Everything you need to integrate Golpo's AI video generation into your application — REST endpoints, Python SDK, and Node.js SDK.

Explore REST APIPython SDKNode SDK

Choose your integration

v1

REST API

HTTP endpoints for video generation and status polling. Language-agnostic — use any HTTP client.

Quick links

v1.0.2v1.0.0

Python SDK

Official Python client for Golpo API. Synchronous and async support. Works with Python 3.8+.

Quick links

v1.0.2v1.0.0

Node SDK

Official TypeScript/JavaScript client for Golpo API. First-class types, Promise-based, ESM + CJS.

Quick links

Latest releasePython SDK v1.0.2Apr 2026

Python SDK v1.0.2 adds List[int] support for user_audio_in_video — specify which user videos get AI-generated narration by index. Do not use List[bool].

Changelog

Release history for all SDKs and the REST API.

Python SDKv1.0.2Apr 2026

Python SDK v1.0.2

  • user_audio_in_video now accepts List[int] — specify which user videos should be replaced with AI-generated narration audio (e.g., [1, 3] replaces audio on videos 1 and 3; unlisted user videos keep their original audio). Previously only accepted str. Note: use List[int] (e.g., [1, 2]) — do not use List[bool].
Python SDKv1.0.0Mar 2026

Python SDK v1.0.0 — Major Release

  • New update_video() method — update video metadata (prompt, context, scenes, frame animations)
  • Golpo Canvas support — use_2_style with 8 image styles: chalkboard_white, neon, whiteboard, modern_minimal, playful, technical, editorial, marker
  • Golpo Sketch modes — use_lineart_2_style with classic, improved (beta), and advanced styles plus pacing control
  • Pen styles — pen_style (stylus, marker, pen)
  • User media — user_images and user_videos with descriptions for custom content
  • display_language — independently control the language used for on-screen text, separate from the narration language
  • The following parameters are now deprecated and no longer supported: personality_1, personality_2, do_research, tts_model, bg_volume, output_volume, add_music, no_voice_chunking, max_workers
Node SDKv1.0.2Apr 2026

Node SDK v1.0.2

  • userAudioInVideo now accepts number[] — specify which user videos should be replaced with AI-generated narration audio (e.g., [1, 3] replaces audio on videos 1 and 3; unlisted user videos keep their original audio). Defaults to [] when userVideos is provided.
Node SDKv1.0.0Mar 2026

Node SDK v1.0.0 — Major Release

  • New parameter support added in createPodcast() — generate audio-only podcasts from prompts or documents
  • 21 new createVideo options: Golpo Sketch (useLineart2Style), Golpo Canvas (use2Style, imageStyle, penStyle), user assets (userImages, userVideos), videoInstructions, newScript, audioClip, pacing, and more
  • Updated voice styles: solo-female-3, solo-female-4, solo-male-3, solo-male-4
  • Expanded timing options: 0.25, 0.5, 1, 2, 4, 8, 10 minutes
  • Background music expanded to 8 genres: jazz, lofi, dramatic, whimsical, engaging, hyper, inspirational, documentary
  • Logo now supports both file paths and URLs
  • displayLanguage — independently control the language used for on-screen text, separate from the narration language
  • The following parameters are now deprecated and no longer supported: personality1, doResearch, ttsModel, bgVolume, outputVolume, concurrency
REST APIv1Mar 2026

Deprecated Parameters & Upload Limit

  • The following parameters are now deprecated and no longer supported: personality_1, personality_2, do_research, length, white_bg, flat_background_color, tts_model, add_music, bg_volume, output_volume, no_voice_chunking
  • Upload file (/api/v1/videos/upload-file) now enforces a maximum file size of 15 MB
REST APIv1Mar 2026

Voice Style Options Updated

  • Removed "conversational" style — multi-speaker podcast format is no longer available via the API
  • New voice options: solo-female-3 (Female 1), solo-female-4 (Female 2), solo-male-3 (Male 1), solo-male-4 (Male 2)
  • Deprecated old voices: solo-male, solo-male-2, solo-female, solo-female-2
  • Default style is now "solo-female-3"
Python SDKv0.9.9Feb 2026

Python SDK v0.9.9 — Stable Release

  • Stable release with full API coverage
  • New parameters: use_color, video_instructions, output_volume
  • combine_videos() method added
  • create_video, get_frame_animations, edit_video, combine_videos
  • Async-first design with full sync wrappers
REST APIv1Jan 2026

REST API v1 — Generally Available

  • POST /api/v1/videos/generate — generate a new video job
  • POST /api/v1/videos/upload-file — upload a file (audio, video, or document) and get its URL
  • GET /api/v1/videos — retrieve videos for the authenticated user
  • GET /api/v1/videos/{video_id} — retrieve a specific video
  • PATCH /api/v1/videos/{video_id} — update video metadata (title, is_public)
  • DELETE /api/v1/videos/{video_id} — soft delete a video
  • GET /api/v1/videos/status/{job_id} — check status of a generation job
  • x-api-key header authentication for all endpoints
Usage-Based Plan

API Only Tier

Usage-based pricing with volume discounts

About this plan

This plan is for using Golpo within your program or application. You will not be able to use the Golpo platform to generate videos manually.

This is a usage-based plan with a minimum cost of $200 to enter. Perfect for developers and businesses who need programmatic access to video generation.

Pay only for what you use — volume-based pricing that gets better as you scale.

Platform access (manual video creation via the dashboard) is not included in this plan. If you need both platform + API access, please consider buying an enterprise plan or business plan with an API add-on.

Pricing Rates

Credit Conversion

$1

USD

1 Credit

Golpo credit

ResourceCost
1 min videoVideo generation2 Credits= $2.00

Volume discounts apply at higher usage tiers. Contact us for enterprise rates.

Minimum entry: $200 (200 credits = ~100 minutes of video)

Questions? Reach out at founders@golpoai.com

REST API v1Python SDKNode SDK