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.

Choose your integration

v1v2

REST API

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

Python SDK

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

Node SDK

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

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.

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