pip install golpo==2.0.0

from golpo import Golpo

golpo_client = Golpo(api_key="your-api-key")

job = golpo_client.create_video(
    prompt="Explain supply and demand",
    style="solo-female-3",
    timing="1",
)
print(job.video_id)
print(job.status)

import time
from golpo import Golpo

client = Golpo(api_key="your-api-key")

# v1-style expectation (older docs)
# result = client.create_video(prompt="Explain gravity")
# print(result.url)
# print(result.script)

# v2.0 flow: submit job first
job = client.create_video(prompt="Explain gravity")
print(f"Submitted job: {job.video_id} ({job.status})")

# then poll status until terminal state
while True:
    status = client.get_video_status(job.video_id)
    print(f"Current status: {status.status}")

    if status.status == "completed":
        print(f"Video URL: {status.url}")
        print(f"Script: {status.script}")
        break

    if status.status == "failed":
        raise RuntimeError(status.error or "Video generation failed")

    time.sleep(2)

job = golpo_client.create_video(
    prompt: str,
    uploads: Optional[Union[str, Path, Iterable[Union[str, Path]]]] = None,
    *,
    voice_instructions: Optional[str] = None,
    language: Optional[str] = None,
    style: Optional[str] = "solo-female-3",
    bg_music: Optional[str] = "engaging",
    video_type: Optional[str] = "long",
    include_watermark: bool = False,
    new_script: Optional[str] = None,
    just_return_script: bool = False,
    video_id: Optional[str] = None,
    logo: Optional[Union[str, Path]] = None,
    timing: Union[str, float] = "1",
    video_instructions: Optional[str] = None,
    use_color: bool = True,
    logo_placement: Optional[str] = None,
    use_lineart_2_style: Optional[str] = None,
    audio_clip: Optional[Union[str, Path]] = None,
    is_public: Optional[bool] = None,
    use_as_is: Optional[Union[str, List[bool]]] = None,
    skip_animation: Optional[Union[str, List[bool]]] = None,
    user_images: Optional[Union[str, Path, List[Union[str, Path]]]] = None,
    user_images_descriptions: Optional[Union[str, List[str]]] = None,
    user_videos: Optional[Union[str, Path, List[Union[str, Path]]]] = None,
    user_videos_description: Optional[Union[str, List[str]]] = None,
    user_audio_in_video: Optional[Union[str, List[int]]] = None,
    use_2_style: bool = False,
    image_style: Optional[str] = None,
    input_images: Optional[Union[str, Path, List[Union[str, Path]]]] = None,
    pen_style: Optional[str] = None,
    show_pencil_cursor: bool = False,
    pacing: str = "normal",
    display_language: Optional[str] = None,
    # ── New in v2.0 ──
    onscreen_text_from_script_only: bool = False,
    visual_animation_style: Optional[str] = None,
    language_variants: Optional[List[str]] = None,
    variant_visuals_mode: Optional[str] = None,
    own_narration_video_layout: Optional[str] = None,
    own_narration_video_position: Optional[str] = None,
    own_narration_split_size: Optional[str] = None,
    own_narration_video_fit: Optional[str] = None,
    own_narration_focus_position: Optional[float] = None,
) -> VideoJobResult

# returns VideoJobResult
# job.video_id, job.status, job.variant_job_ids (optional)

job = golpo_client.create_podcast(
    prompt: str,
    uploads: Optional[Union[str, Path, Iterable[Union[str, Path]]]] = None,
    *,
    voice_instructions: Optional[str] = None,
    language: Optional[str] = None,
    style: Optional[str] = "conversational",
    bg_music: Optional[str] = None,
    new_script: Optional[str] = None,
    timing: Union[str, float] = "1",
) -> VideoJobResult

# returns VideoJobResult
# job.video_id, job.status

status = golpo_client.get_video_status(
    job_id: str,
) -> VideoStatusResult

# returns VideoStatusResult
# status.video_id, status.status, status.url, status.script, status.error (optional)

frame_animations: Dict[str, str] = golpo_client.get_frame_animations(video_id: str)

result = golpo_client.create_video(prompt="Explain AI in 2 minutes")
animations = golpo_client.get_frame_animations(result.video_id)

for frame_id, url in sorted(animations.items(), key=lambda x: int(x[0])):
    print(f"Frame {frame_id}: {url}")

result = golpo_client.edit_video(
    video_id:         str,
    frame_ids:        List[str],
    edit_prompts:     List[str],
    video_url:        str,
    *,
    reference_images: Optional[List[str]] = None,
    user_id:          Optional[str] = None,
    poll_interval_ms: int = 2000,
    auto_combine:     bool = False,
) -> VideoEditResult  # .video_url, .job_id

video_result = golpo_client.create_video(prompt="Product demo in 3 scenes")
edit_result  = golpo_client.edit_video(
    video_id=video_result.video_id,
    frame_ids=["1"],
    edit_prompts=["Replace the background with a beach sunset"],
    video_url=video_result.url,
    auto_combine=True,
)
print(f"Edited video URL: {edit_result.video_url}")

result = golpo_client.combine_videos(
    mp4_urls:         List[str],
    *,
    video_url:        Optional[str] = None,
    poll_interval_ms: int = 2000,
) -> CombinedVideoResult  # .url

animations = golpo_client.get_frame_animations(video_id)
mp4_urls   = [animations[k] for k in sorted(animations.keys(), key=int)]
combined   = golpo_client.combine_videos(mp4_urls, video_url=original_video_url)
print(f"Combined video: {combined.url}")

result = golpo_client.update_video(
    video_id: str,
    *,
    prompt:           Optional[str] = None,
    context:          Optional[str] = None,
    scenes:           Optional[int] = None,
    video_url:        Optional[str] = None,
    frame_animations: Optional[Dict[str, Any]] = None,
    jwt_token:        str,  # Required
) -> Dict[str, Any]

updated = golpo_client.update_video(
    video_id=result.video_id,
    prompt="Updated: comprehensive product overview",
    context="Q1 2025 product launch",
    scenes=5,
    jwt_token="your-jwt-token",
)
print(f"Updated video: {updated}")

from golpo import Golpo

client = Golpo(api_key="your-api-key")

job = client.create_video(
    prompt="Explain photosynthesis in simple terms",
    style="solo-female-3",
    timing="1",
)
print(job.video_id)
print(job.status)

status = client.get_video_status(job.video_id)
print(status.status)
print(status.url)
print(status.script)

from golpo import Golpo

client = Golpo(api_key="your-api-key")

job = client.create_podcast(
    prompt="Summarize the latest AI trends",
    style="solo-male-3",
    bg_music="lofi",
    timing="1",
)
print(job.video_id)
print(job.status)

status = client.get_video_status(job.video_id)
print(status.status)
print(status.url)
print(status.script)

result = golpo_client.create_video(
    prompt="Summarize these privacy documents",
    uploads=["~/Documents/privacy_policy.pdf"],
    voice_instructions="calm professional female",
    bg_music="engaging",
)
print(f"Video URL: {result.url}")

result = golpo_client.create_video(
    prompt="Explain the solar system for students",
    use_2_style=True,
    # Supported image_style values:
    # chalkboard_white(_compact), chalkboard_black_on_white(_compact), neon(_compact),
    # whiteboard(_compact), modern_minimal(_compact), playful(_compact), technical(_compact),
    # editorial(_compact), marker(_compact), vox(_compact), notebook_infographic
    image_style="modern_minimal_compact",
    # Supported pen_style values: "stylus", "marker", "pen"
    pen_style="stylus",
)
print(f"Video URL: {result.url}")

result = golpo_client.create_video(
    prompt="Explain supply and demand with examples",
    # Supported use_lineart_2_style values:
    # "false", "true", "advanced", "whiteboard", "modern_minimal",
    # "storytelling", "creative", "vox", "chalkboard_black_on_white"
    use_lineart_2_style="advanced",
    # Supported pacing values: "normal", "fast"
    pacing="normal",
)
print(f"Video URL: {result.url}")

job = golpo_client.create_video(
    prompt="Explain electric vehicles and battery technology",
    language="English",
    language_variants=["Spanish", "French"],
    variant_visuals_mode="shared",  # "shared" or "per_language"
    style="solo-female-3",
    timing="1",
)
print(job.video_id)
print(job.status)
print(job.variant_job_ids)

job = golpo_client.create_video(
    prompt="Explain the product onboarding flow",
    audio_clip="~/narration.mp4",
    own_narration_video_layout="side_by_side",
    own_narration_video_position="right-bottom",
    own_narration_split_size="35%",
    own_narration_video_fit="crop",
    own_narration_focus_position=50,
    style="solo-female-3",
)
print(job.video_id)
print(job.status)

result = golpo_client.create_video(
    prompt="Flower Structure for Reproduction",
    language="Hindi",           # narrator speaks in Hindi
    display_language="English", # on-screen text, titles, and labels appear in English
    style="solo-female-4",
    use_color=True,
    video_type="long",
)
print(f"Video URL: {result.url}")

result = golpo_client.create_video(
    prompt="Create a product showcase video",
    user_images=["~/product_photo_1.png", "~/product_photo_2.png"],
    user_images_descriptions=["Front view of the product", "Side view with packaging"],
    use_2_style=True,
    image_style="modern_minimal_compact",
    pen_style="stylus",
)
print(f"Video URL: {result.url}")

result = golpo_client.create_video(
    prompt="Create an explainer incorporating these demo clips",
    user_videos=["~/demo_clip_1.mp4", "https://example.com/clip2.mp4"],
    user_videos_description=["App walkthrough demo", "Feature highlight reel"],
    user_audio_in_video=[2],  # video 2 gets AI narration; video 1 keeps its original audio
    audio_clip="~/background_music.mp3",
    is_public=True,
)
print(f"Video URL: {result.url}")