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

v1v2

REST API

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

Quick links

v0.9.9

Python SDK

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

Quick links

v0.1.9

Node SDK

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

Quick links

Latest releasePython SDK v0.9.9Feb 2026

Python SDK v0.9.9 is a stable release with full API coverage, new parameters like use_color, video_instructions, and combine_videos() method. Async-first design with full sync wrappers.

Changelog

Release history for all SDKs and the REST API.

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, contact us.

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