feat: skip_gcs_upload for faster video response (avoids 502 proxy timeout)

- videos.generate(skip_gcs_upload=True): return provider URL directly
- Examples 04, 12: use skip_gcs_upload to stay under Cloudflare 100s limit

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: uzunenes

examples/04_videos_all_providers.py

@@ -11,20 +11,23 @@ def main() -> None:
 
     with create_client() as client:
         set_provider_headers(client)
+        # Veo 3 via Visgate API → Fal
         managed = client.videos.generate(
-            model="fal-ai/flux-pro",
+            model="fal-ai/veo3",
             prompt=prompt,
-            duration_seconds=5.0,
+            duration_seconds=6.0,
+            skip_gcs_upload=True,
         )
         print(f"managed_video_id={managed.id}")
 
         fal = provider_key("fal")
         if fal:
             set_provider_headers(client, fal_key=fal)
             result = client.videos.generate(
-                model="fal-ai/flux-pro",
+                model="fal-ai/veo3",
                 prompt=prompt,
-                duration_seconds=5.0,
+                duration_seconds=6.0,
+                skip_gcs_upload=True,
             )
             print(f"fal_video_id={result.id}")
         else:
@@ -37,6 +40,7 @@ def main() -> None:
                 model="replicate/lucataco/cogvideox-5b",
                 prompt=prompt,
                 duration_seconds=5.0,
+                skip_gcs_upload=True,
             )
             print(f"replicate_video_id={result.id}")
         else:
@@ -49,6 +53,7 @@ def main() -> None:
                 model="runway/gen4_turbo",
                 prompt=prompt,
                 duration_seconds=5.0,
+                skip_gcs_upload=True,
             )
             print(f"runway_video_id={result.id}")
         else:

examples/12_veo_from_catalog.py

@@ -69,10 +69,12 @@ def main() -> None:
     print(f"  Generating video (prompt={PROMPT[:50]}...) ...")
     # Note: Veo expects duration as "4s"/"6s"/"8s". Visgate API should convert
     # duration_seconds to that format. If validation fails, try another provider.
+    # skip_gcs_upload=True: faster response, avoids Cloudflare 100s proxy timeout
     result = client.videos.generate(
         model=model_id,
         prompt=PROMPT,
         duration_seconds=6.0,
+        skip_gcs_upload=True,
     )
     if not result.video_url:
         print("  No video_url in response.")

src/visgate_sdk/resources/videos.py

@@ -72,6 +72,7 @@ def generate(
         *,
         image_url: Optional[str] = None,
         duration_seconds: float = 5.0,
+        skip_gcs_upload: bool = False,
         params: Optional[Dict[str, Any]] = None,
     ) -> VideoResult:
         """Generate a video.
@@ -81,6 +82,7 @@ def generate(
             prompt: Text description of the desired video.
             image_url: Optional image URL to animate (image-to-video).
             duration_seconds: Video duration in seconds. Defaults to 5.0.
+            skip_gcs_upload: If True, return provider URL directly (faster; avoids proxy timeout).
             params: Additional model-specific parameters.
 
         Returns:
@@ -93,6 +95,8 @@ def generate(
         }
         if image_url:
             payload["image_url"] = image_url
+        if skip_gcs_upload:
+            payload["skip_gcs_upload"] = True
         if params:
             payload.update(params)
 
@@ -113,6 +117,7 @@ async def generate(
         *,
         image_url: Optional[str] = None,
         duration_seconds: float = 5.0,
+        skip_gcs_upload: bool = False,
         params: Optional[Dict[str, Any]] = None,
     ) -> VideoResult:
         """Generate a video (async). See :meth:`Videos.generate` for details."""
@@ -123,6 +128,8 @@ async def generate(
         }
         if image_url:
             payload["image_url"] = image_url
+        if skip_gcs_upload:
+            payload["skip_gcs_upload"] = True
         if params:
             payload.update(params)