videogen 2.2.0__tar.gz → 2.5.3__tar.gz

{videogen-2.2.0 → videogen-2.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: videogen
-Version: 2.2.0
+Version: 2.5.3
 Summary: Official Python SDK for the VideoGen API
 Author-email: VideoGen <support@videogen.io>
 License: MIT
@@ -101,7 +101,7 @@ print(run.download_url)
 | Area | Client surface | Typical entry points |
 | --- | --- | --- |
 | Account | `vg.account` | `get_me` |
-| Workflows | `vg.workflows` | `script_to_video_and_wait`, `prompt_to_video_clip_and_wait`, `voiceover_to_video_and_wait`, `slideshow_to_video_and_wait` |
+| Workflows | `vg.workflows` | `script_to_video_and_wait`, `prompt_to_video_clip_and_wait`, `voiceover_to_video_and_wait`, `slideshow_to_video_and_wait`, `video_to_video_and_wait` |
 | Tools | `vg.tools` | `generate_image_and_wait`, `generate_video_clip_and_wait`, `text_to_speech_and_wait`, … |
 | Files | helpers on `vg` | `upload_file`, `download_file`, `create_public_preview` |
 | Projects | `vg.projects` | `export_and_wait`, `remix_and_wait`, `create_timeline_interchange_and_wait` |
@@ -136,7 +136,7 @@ run = vg.workflows.prompt_to_video_clip_and_wait(
 print(run.download_url)
 ```
 
-Other workflow starters: `voiceover_to_video_and_wait` (uploaded audio `file_id`), `slideshow_to_video_and_wait` (deck `file_id`).
+Other workflow starters: `voiceover_to_video_and_wait` (uploaded audio `file_id`), `slideshow_to_video_and_wait` (deck `file_id`), `video_to_video_and_wait` (restyles an uploaded `video_file_id` or a public `video_url` from a `prompt`).
 
 ## Tools
 
@@ -284,8 +284,8 @@ Exported as module functions and bound on the client:
 | Helper | Purpose |
 | --- | --- |
 | `poll_assistant_message` / `async_poll_assistant_message` | Poll an assistant message to a terminal status |
-| `poll_executed_tool` / `async_poll_executed_tool` | Poll a tool execution to a terminal status |
-| `poll_workflow_run` / `async_poll_workflow_run` | Poll a workflow run |
+| `poll_executed_tool` / `async_poll_executed_tool` | Poll a tool execution to a terminal status or `awaiting_approval` |
+| `poll_workflow_run` / `async_poll_workflow_run` | Poll a workflow run to a terminal status or `awaiting_approval` |
 | `poll_project_export` / `async_poll_project_export` | Poll a project export |
 | `poll_timeline_interchange` / `async_poll_timeline_interchange` | Poll a timeline interchange job |
 | `poll_remix_actions` / `async_poll_remix_actions` | Poll remix actions until all are terminal |
@@ -296,6 +296,8 @@ Exported as module functions and bound on the client:
 | `create_public_preview` / `async_create_public_preview` | Enable + poll public preview |
 | `verify_webhook_signature` | Verify Standard Webhooks and return the event dict |
 
+Workflow and tool pollers, including their `*_and_wait` wrappers, return `awaiting_approval` unchanged without throwing, even with the default `throw_on_failure=True`. This status means the result needs approval; it does not mean the operation succeeded. Check `status` before using the result as a completed operation.
+
 Cancellation: pass `cancel_event=threading.Event()` (sync) or `asyncio.Event()` (async) to poll helpers and thin request methods. Setting the event raises `PollCancelledError`.
 
 ## Errors

{videogen-2.2.0 → videogen-2.5.3}/README.md

@@ -80,7 +80,7 @@ print(run.download_url)
 | Area | Client surface | Typical entry points |
 | --- | --- | --- |
 | Account | `vg.account` | `get_me` |
-| Workflows | `vg.workflows` | `script_to_video_and_wait`, `prompt_to_video_clip_and_wait`, `voiceover_to_video_and_wait`, `slideshow_to_video_and_wait` |
+| Workflows | `vg.workflows` | `script_to_video_and_wait`, `prompt_to_video_clip_and_wait`, `voiceover_to_video_and_wait`, `slideshow_to_video_and_wait`, `video_to_video_and_wait` |
 | Tools | `vg.tools` | `generate_image_and_wait`, `generate_video_clip_and_wait`, `text_to_speech_and_wait`, … |
 | Files | helpers on `vg` | `upload_file`, `download_file`, `create_public_preview` |
 | Projects | `vg.projects` | `export_and_wait`, `remix_and_wait`, `create_timeline_interchange_and_wait` |
@@ -115,7 +115,7 @@ run = vg.workflows.prompt_to_video_clip_and_wait(
 print(run.download_url)
 ```
 
-Other workflow starters: `voiceover_to_video_and_wait` (uploaded audio `file_id`), `slideshow_to_video_and_wait` (deck `file_id`).
+Other workflow starters: `voiceover_to_video_and_wait` (uploaded audio `file_id`), `slideshow_to_video_and_wait` (deck `file_id`), `video_to_video_and_wait` (restyles an uploaded `video_file_id` or a public `video_url` from a `prompt`).
 
 ## Tools
 
@@ -263,8 +263,8 @@ Exported as module functions and bound on the client:
 | Helper | Purpose |
 | --- | --- |
 | `poll_assistant_message` / `async_poll_assistant_message` | Poll an assistant message to a terminal status |
-| `poll_executed_tool` / `async_poll_executed_tool` | Poll a tool execution to a terminal status |
-| `poll_workflow_run` / `async_poll_workflow_run` | Poll a workflow run |
+| `poll_executed_tool` / `async_poll_executed_tool` | Poll a tool execution to a terminal status or `awaiting_approval` |
+| `poll_workflow_run` / `async_poll_workflow_run` | Poll a workflow run to a terminal status or `awaiting_approval` |
 | `poll_project_export` / `async_poll_project_export` | Poll a project export |
 | `poll_timeline_interchange` / `async_poll_timeline_interchange` | Poll a timeline interchange job |
 | `poll_remix_actions` / `async_poll_remix_actions` | Poll remix actions until all are terminal |
@@ -275,6 +275,8 @@ Exported as module functions and bound on the client:
 | `create_public_preview` / `async_create_public_preview` | Enable + poll public preview |
 | `verify_webhook_signature` | Verify Standard Webhooks and return the event dict |
 
+Workflow and tool pollers, including their `*_and_wait` wrappers, return `awaiting_approval` unchanged without throwing, even with the default `throw_on_failure=True`. This status means the result needs approval; it does not mean the operation succeeded. Check `status` before using the result as a completed operation.
+
 Cancellation: pass `cancel_event=threading.Event()` (sync) or `asyncio.Event()` (async) to poll helpers and thin request methods. Setting the event raises `PollCancelledError`.
 
 ## Errors

{videogen-2.2.0 → videogen-2.5.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "videogen"
-version = "2.2.0"
+version = "2.5.3"
 description = "Official Python SDK for the VideoGen API"
 readme = "README.md"
 requires-python = ">=3.9"

{videogen-2.2.0 → videogen-2.5.3}/src/videogen/__init__.py

@@ -9,6 +9,7 @@ from .async_download_file import async_download_file
 from .async_get_hydrated_file import async_get_hydrated_file
 from .async_poll_assistant_message import async_poll_assistant_message
 from .async_poll_executed_tool import async_poll_executed_tool
+from .async_poll_file_url_import import async_poll_file_url_import
 from .async_poll_project_export import async_poll_project_export
 from .async_poll_public_preview import async_poll_public_preview
 from .async_poll_remix_actions import async_poll_remix_actions
@@ -22,6 +23,7 @@ from .errors import PollCancelledError, VideoGenError
 from .get_hydrated_file import get_hydrated_file
 from .poll_assistant_message import poll_assistant_message
 from .poll_executed_tool import poll_executed_tool
+from .poll_file_url_import import poll_file_url_import
 from .poll_project_export import poll_project_export
 from .poll_public_preview import poll_public_preview
 from .poll_remix_actions import poll_remix_actions
@@ -40,6 +42,7 @@ __all__ = [
     "async_get_hydrated_file",
     "async_poll_assistant_message",
     "async_poll_executed_tool",
+    "async_poll_file_url_import",
     "async_poll_project_export",
     "async_poll_public_preview",
     "async_poll_remix_actions",
@@ -51,6 +54,7 @@ __all__ = [
     "get_hydrated_file",
     "poll_assistant_message",
     "poll_executed_tool",
+    "poll_file_url_import",
     "poll_project_export",
     "poll_public_preview",
     "poll_remix_actions",

{videogen-2.2.0 → videogen-2.5.3}/src/videogen/async_poll_executed_tool.py

@@ -30,6 +30,8 @@ async def async_poll_executed_tool(
             tool_execution_id=tool_execution_id,
             cancel_event=cancel_event,
         )
+        if isinstance(executed, dict) and executed.get("status") == "awaiting_approval":
+            return executed
         if isinstance(executed, dict) and executed.get("status") in TERMINAL_STATUSES:
             raise_if_failed(executed, throw_on_failure=throw_on_failure, kind="Tool execution")
             return executed

videogen-2.5.3/src/videogen/async_poll_file_url_import.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+import time
+from typing import Any, Optional
+
+from .poll_helpers import (
+    TERMINAL_STATUSES,
+    async_poll_sleep,
+    ensure_within_timeout,
+    poll_raise_if_cancelled,
+    raise_if_failed,
+)
+
+
+async def async_poll_file_url_import(
+    client: Any,
+    file_import_id: str,
+    *,
+    poll_interval_ms: int = 1500,
+    timeout_ms: Optional[int] = 3_600_000,
+    throw_on_failure: bool = True,
+    cancel_event: Any = None,
+) -> dict:
+    """Async twin of `poll_file_url_import`."""
+    started_at = time.monotonic()
+    while True:
+        poll_raise_if_cancelled(cancel_event)
+        ensure_within_timeout(started_at=started_at, timeout_ms=timeout_ms)
+        file_url_import = await client.files.get_file_url_import(
+            file_import_id=file_import_id,
+            cancel_event=cancel_event,
+        )
+        if isinstance(file_url_import, dict) and file_url_import.get("status") in TERMINAL_STATUSES:
+            raise_if_failed(
+                file_url_import, throw_on_failure=throw_on_failure, kind="File import"
+            )
+            return file_url_import
+        await async_poll_sleep(poll_interval_ms, cancel_event)

{videogen-2.2.0 → videogen-2.5.3}/src/videogen/async_poll_workflow_run.py

@@ -35,6 +35,8 @@ async def async_poll_workflow_run(
             progress = run.get("progress_percentage")
             if on_progress is not None and isinstance(progress, (int, float)):
                 on_progress(float(progress))
+            if run.get("status") == "awaiting_approval":
+                return run
             if run.get("status") in TERMINAL_STATUSES:
                 raise_if_failed(run, throw_on_failure=throw_on_failure, kind="Workflow run")
                 return run

{videogen-2.2.0 → videogen-2.5.3}/src/videogen/async_upload_file.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import time
+import warnings
 from typing import Any, BinaryIO, Optional, Union
 
 import httpx
@@ -29,16 +30,22 @@ async def async_upload_file(
         type: Optional file type (IMAGE, VIDEO, AUDIO, PDF, SLIDESHOW, LOTTIE).
             If omitted, auto-detected. Lottie animations (Bodymovin JSON) must
             set LOTTIE explicitly.
-        hide_from_ui: When true, hide the file from the VideoGen Media page.
-            Defaults to false.
+        hide_from_ui: Deprecated and ignored. Uploaded files always appear in
+            the VideoGen app. Passing a value emits a ``DeprecationWarning``.
         timeout_ms: Maximum time in ms to wait for processing. Defaults to
             3_600_000 (1 hour).
     """
+    if hide_from_ui is not None:
+        warnings.warn(
+            "async_upload_file(hide_from_ui=...) is deprecated and ignored. "
+            "Uploaded files always appear in the VideoGen app.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
     if display_name is None:
         display_name = "upload"
     body: dict[str, Any] = {
         "display_name": display_name,
-        "hide_from_ui": False if hide_from_ui is None else hide_from_ui,
     }
     if type is not None:
         body["type"] = type

{videogen-2.2.0 → videogen-2.5.3}/src/videogen/client.py

@@ -10,6 +10,7 @@ from .async_download_file import async_download_file
 from .async_get_hydrated_file import async_get_hydrated_file
 from .async_poll_assistant_message import async_poll_assistant_message
 from .async_poll_executed_tool import async_poll_executed_tool
+from .async_poll_file_url_import import async_poll_file_url_import
 from .async_poll_project_export import async_poll_project_export
 from .async_poll_public_preview import async_poll_public_preview
 from .async_poll_remix_actions import async_poll_remix_actions
@@ -21,6 +22,7 @@ from .download_file import download_file
 from .get_hydrated_file import get_hydrated_file
 from .poll_assistant_message import poll_assistant_message
 from .poll_executed_tool import poll_executed_tool
+from .poll_file_url_import import poll_file_url_import
 from .poll_project_export import poll_project_export
 from .poll_public_preview import poll_public_preview
 from .poll_remix_actions import poll_remix_actions
@@ -112,6 +114,9 @@ class VideoGen:
     def poll_timeline_interchange(self, interchange_job_id: str, **kwargs: Any) -> dict:
         return poll_timeline_interchange(self, interchange_job_id, **kwargs)
 
+    def poll_file_url_import(self, file_import_id: str, **kwargs: Any) -> dict:
+        return poll_file_url_import(self, file_import_id, **kwargs)
+
     def poll_remix_actions(self, project_id: str, **kwargs: Any) -> dict:
         return poll_remix_actions(self, project_id, **kwargs)
 
@@ -210,6 +215,9 @@ class AsyncVideoGen:
     ) -> dict:
         return await async_poll_timeline_interchange(self, interchange_job_id, **kwargs)
 
+    async def poll_file_url_import(self, file_import_id: str, **kwargs: Any) -> dict:
+        return await async_poll_file_url_import(self, file_import_id, **kwargs)
+
     async def poll_remix_actions(self, project_id: str, **kwargs: Any) -> dict:
         return await async_poll_remix_actions(self, project_id, **kwargs)
 

{videogen-2.2.0 → videogen-2.5.3}/src/videogen/poll_executed_tool.py

@@ -21,7 +21,7 @@ def poll_executed_tool(
     throw_on_failure: bool = True,
     cancel_event: Any = None,
 ) -> dict:
-    """Poll `get_tool_execution_info` until succeeded / failed / cancelled."""
+    """Poll until succeeded / failed / cancelled or awaiting approval."""
     started_at = time.monotonic()
     while True:
         poll_raise_if_cancelled(cancel_event)
@@ -30,6 +30,8 @@ def poll_executed_tool(
             tool_execution_id=tool_execution_id,
             cancel_event=cancel_event,
         )
+        if isinstance(executed, dict) and executed.get("status") == "awaiting_approval":
+            return executed
         if isinstance(executed, dict) and executed.get("status") in TERMINAL_STATUSES:
             raise_if_failed(executed, throw_on_failure=throw_on_failure, kind="Tool execution")
             return executed

videogen-2.5.3/src/videogen/poll_file_url_import.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+import time
+from typing import Any, Optional
+
+from .poll_helpers import (
+    TERMINAL_STATUSES,
+    ensure_within_timeout,
+    poll_raise_if_cancelled,
+    poll_sleep,
+    raise_if_failed,
+)
+
+
+def poll_file_url_import(
+    client: Any,
+    file_import_id: str,
+    *,
+    poll_interval_ms: int = 1500,
+    timeout_ms: Optional[int] = 3_600_000,
+    throw_on_failure: bool = True,
+    cancel_event: Any = None,
+) -> dict:
+    """Poll `get_file_url_import` until succeeded / failed / cancelled."""
+    started_at = time.monotonic()
+    while True:
+        poll_raise_if_cancelled(cancel_event)
+        ensure_within_timeout(started_at=started_at, timeout_ms=timeout_ms)
+        file_url_import = client.files.get_file_url_import(
+            file_import_id=file_import_id,
+            cancel_event=cancel_event,
+        )
+        if isinstance(file_url_import, dict) and file_url_import.get("status") in TERMINAL_STATUSES:
+            raise_if_failed(
+                file_url_import, throw_on_failure=throw_on_failure, kind="File import"
+            )
+            return file_url_import
+        poll_sleep(poll_interval_ms, cancel_event)

{videogen-2.2.0 → videogen-2.5.3}/src/videogen/poll_workflow_run.py

@@ -22,7 +22,7 @@ def poll_workflow_run(
     on_progress: Optional[Callable[[float], None]] = None,
     cancel_event: Any = None,
 ) -> dict:
-    """Poll `get_workflow_run` until succeeded / failed / cancelled."""
+    """Poll until succeeded / failed / cancelled or awaiting approval."""
     started_at = time.monotonic()
     while True:
         poll_raise_if_cancelled(cancel_event)
@@ -35,6 +35,8 @@ def poll_workflow_run(
             progress = run.get("progress_percentage")
             if on_progress is not None and isinstance(progress, (int, float)):
                 on_progress(float(progress))
+            if run.get("status") == "awaiting_approval":
+                return run
             if run.get("status") in TERMINAL_STATUSES:
                 raise_if_failed(run, throw_on_failure=throw_on_failure, kind="Workflow run")
                 return run

{videogen-2.2.0 → videogen-2.5.3}/src/videogen/resources/files.py

@@ -4,6 +4,9 @@ from typing import Any, TYPE_CHECKING
 
 from .._http import camel_to_snake, format_path, split_request_args
 
+from ..poll_file_url_import import poll_file_url_import
+from ..async_poll_file_url_import import async_poll_file_url_import
+
 if TYPE_CHECKING:
     from ..client import AsyncVideoGen, VideoGen
 
@@ -94,6 +97,67 @@ class FilesResource:
             cancel_event=cancel_event,
         )
 
+    # @sdk-operation createFileUrlImport
+    def create_file_url_import(self, *args: Any, **kwargs: Any) -> Any:
+        if args:
+            raise TypeError(f'create_file_url_import() does not take positional arguments')
+        path_values, query_values, body, cancel_event = split_request_args(
+            kwargs,
+            path_params=[],
+            query_params=[],
+        )
+        path = format_path('/v1/files/import-url', path_values)
+        return self._client.request(
+            method='POST',
+            path=path,
+            query=query_values or None,
+            body=body if body is not None else {},
+            cancel_event=cancel_event,
+        )
+
+    def create_file_url_import_and_wait(self, *args: Any, **kwargs: Any) -> Any:
+        poll_interval_ms = kwargs.pop('poll_interval_ms', 1500)
+        timeout_ms = kwargs.pop('timeout_ms', 3_600_000)
+        throw_on_failure = kwargs.pop('throw_on_failure', True)
+        cancel_event = kwargs.get('cancel_event')
+        started = self.create_file_url_import(*args, **kwargs)
+        file_import_id = started['file_import_id']
+        return poll_file_url_import(
+            self._root,
+            file_import_id,
+            poll_interval_ms=poll_interval_ms,
+            timeout_ms=timeout_ms,
+            throw_on_failure=throw_on_failure,
+            cancel_event=cancel_event,
+        )
+
+    # @sdk-operation getFileUrlImport
+    def get_file_url_import(self, *args: Any, **kwargs: Any) -> Any:
+        path_param_names = ['file_import_id']
+        if args:
+            if len(args) > len(path_param_names):
+                raise TypeError(f'get_file_url_import() takes at most {len(path_param_names)} positional argument(s)')
+            for name, value in zip(path_param_names, args):
+                if name in kwargs:
+                    raise TypeError(f"{name} specified twice")
+                kwargs[name] = value
+        path_values, query_values, body, cancel_event = split_request_args(
+            kwargs,
+            path_params=['fileImportId'],
+            query_params=[],
+        )
+        for required in ['fileImportId']:
+            if required not in path_values:
+                raise TypeError(f"missing required argument: {camel_to_snake(required)}")
+        path = format_path('/v1/files/imports/{fileImportId}', path_values)
+        return self._client.request(
+            method='GET',
+            path=path,
+            query=query_values or None,
+            body=body,
+            cancel_event=cancel_event,
+        )
+
     # @sdk-operation hydrateFile
     def hydrate_file(self, *args: Any, **kwargs: Any) -> Any:
         path_param_names = ['file_id']
@@ -289,6 +353,67 @@ class AsyncFilesResource:
             cancel_event=cancel_event,
         )
 
+    # @sdk-operation createFileUrlImport
+    async def create_file_url_import(self, *args: Any, **kwargs: Any) -> Any:
+        if args:
+            raise TypeError(f'create_file_url_import() does not take positional arguments')
+        path_values, query_values, body, cancel_event = split_request_args(
+            kwargs,
+            path_params=[],
+            query_params=[],
+        )
+        path = format_path('/v1/files/import-url', path_values)
+        return await self._client.request(
+            method='POST',
+            path=path,
+            query=query_values or None,
+            body=body if body is not None else {},
+            cancel_event=cancel_event,
+        )
+
+    async def create_file_url_import_and_wait(self, *args: Any, **kwargs: Any) -> Any:
+        poll_interval_ms = kwargs.pop('poll_interval_ms', 1500)
+        timeout_ms = kwargs.pop('timeout_ms', 3_600_000)
+        throw_on_failure = kwargs.pop('throw_on_failure', True)
+        cancel_event = kwargs.get('cancel_event')
+        started = await self.create_file_url_import(*args, **kwargs)
+        file_import_id = started['file_import_id']
+        return await async_poll_file_url_import(
+            self._root,
+            file_import_id,
+            poll_interval_ms=poll_interval_ms,
+            timeout_ms=timeout_ms,
+            throw_on_failure=throw_on_failure,
+            cancel_event=cancel_event,
+        )
+
+    # @sdk-operation getFileUrlImport
+    async def get_file_url_import(self, *args: Any, **kwargs: Any) -> Any:
+        path_param_names = ['file_import_id']
+        if args:
+            if len(args) > len(path_param_names):
+                raise TypeError(f'get_file_url_import() takes at most {len(path_param_names)} positional argument(s)')
+            for name, value in zip(path_param_names, args):
+                if name in kwargs:
+                    raise TypeError(f"{name} specified twice")
+                kwargs[name] = value
+        path_values, query_values, body, cancel_event = split_request_args(
+            kwargs,
+            path_params=['fileImportId'],
+            query_params=[],
+        )
+        for required in ['fileImportId']:
+            if required not in path_values:
+                raise TypeError(f"missing required argument: {camel_to_snake(required)}")
+        path = format_path('/v1/files/imports/{fileImportId}', path_values)
+        return await self._client.request(
+            method='GET',
+            path=path,
+            query=query_values or None,
+            body=body,
+            cancel_event=cancel_event,
+        )
+
     # @sdk-operation hydrateFile
     async def hydrate_file(self, *args: Any, **kwargs: Any) -> Any:
         path_param_names = ['file_id']

{videogen-2.2.0 → videogen-2.5.3}/src/videogen/resources/projects.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import warnings
 from typing import Any, TYPE_CHECKING
 
 from .._http import camel_to_snake, format_path, split_request_args
@@ -15,6 +16,18 @@ if TYPE_CHECKING:
     from ..client import AsyncVideoGen, VideoGen
 
 
+def _pop_deprecated_include_ui_projects(kwargs: dict[str, Any]) -> None:
+    # Unknown kwargs become the request body, so drop this before splitting.
+    values = [kwargs.pop(key, None) for key in ('include_ui_projects', 'includeUiProjects')]
+    if any(value is not None for value in values):
+        warnings.warn(
+            "list_projects(include_ui_projects=...) is deprecated and ignored. "
+            "The list always includes projects created in the VideoGen app.",
+            DeprecationWarning,
+            stacklevel=3,
+        )
+
+
 class ProjectsResource:
     def __init__(self, client: VideoGen) -> None:
         self._root = client
@@ -24,10 +37,11 @@ class ProjectsResource:
     def list_projects(self, *args: Any, **kwargs: Any) -> Any:
         if args:
             raise TypeError(f'list_projects() does not take positional arguments')
+        _pop_deprecated_include_ui_projects(kwargs)
         path_values, query_values, body, cancel_event = split_request_args(
             kwargs,
             path_params=[],
-            query_params=['limit', 'cursor', 'selfOnly', 'includeUiProjects'],
+            query_params=['limit', 'cursor', 'selfOnly'],
         )
         path = format_path('/v1/projects', path_values)
         return self._client.request(
@@ -323,10 +337,11 @@ class AsyncProjectsResource:
     async def list_projects(self, *args: Any, **kwargs: Any) -> Any:
         if args:
             raise TypeError(f'list_projects() does not take positional arguments')
+        _pop_deprecated_include_ui_projects(kwargs)
         path_values, query_values, body, cancel_event = split_request_args(
             kwargs,
             path_params=[],
-            query_params=['limit', 'cursor', 'selfOnly', 'includeUiProjects'],
+            query_params=['limit', 'cursor', 'selfOnly'],
         )
         path = format_path('/v1/projects', path_values)
         return await self._client.request(

{videogen-2.2.0 → videogen-2.5.3}/src/videogen/resources/workflows.py

@@ -88,6 +88,24 @@ class WorkflowsResource:
             cancel_event=cancel_event,
         )
 
+    # @sdk-operation videoToVideo
+    def video_to_video(self, *args: Any, **kwargs: Any) -> Any:
+        if args:
+            raise TypeError(f'video_to_video() does not take positional arguments')
+        path_values, query_values, body, cancel_event = split_request_args(
+            kwargs,
+            path_params=[],
+            query_params=[],
+        )
+        path = format_path('/v1/workflows/video-to-video', path_values)
+        return self._client.request(
+            method='POST',
+            path=path,
+            query=query_values or None,
+            body=body if body is not None else {},
+            cancel_event=cancel_event,
+        )
+
     # @sdk-operation listWorkflowRuns
     def list_workflow_runs(self, *args: Any, **kwargs: Any) -> Any:
         if args:
@@ -232,6 +250,24 @@ class WorkflowsResource:
             cancel_event=cancel_event,
         )
 
+    def video_to_video_and_wait(self, *args: Any, **kwargs: Any) -> Any:
+        poll_interval_ms = kwargs.pop('poll_interval_ms', 1500)
+        timeout_ms = kwargs.pop('timeout_ms', 3_600_000)
+        throw_on_failure = kwargs.pop('throw_on_failure', True)
+        on_progress = kwargs.pop('on_progress', None)
+        cancel_event = kwargs.get('cancel_event')
+        started = self.video_to_video(*args, **kwargs)
+        workflow_run_id = started['workflow_run_id']
+        return poll_workflow_run(
+            self._root,
+            workflow_run_id,
+            poll_interval_ms=poll_interval_ms,
+            timeout_ms=timeout_ms,
+            throw_on_failure=throw_on_failure,
+            on_progress=on_progress,
+            cancel_event=cancel_event,
+        )
+
 class AsyncWorkflowsResource:
     def __init__(self, client: AsyncVideoGen) -> None:
         self._root = client
@@ -309,6 +345,24 @@ class AsyncWorkflowsResource:
             cancel_event=cancel_event,
         )
 
+    # @sdk-operation videoToVideo
+    async def video_to_video(self, *args: Any, **kwargs: Any) -> Any:
+        if args:
+            raise TypeError(f'video_to_video() does not take positional arguments')
+        path_values, query_values, body, cancel_event = split_request_args(
+            kwargs,
+            path_params=[],
+            query_params=[],
+        )
+        path = format_path('/v1/workflows/video-to-video', path_values)
+        return await self._client.request(
+            method='POST',
+            path=path,
+            query=query_values or None,
+            body=body if body is not None else {},
+            cancel_event=cancel_event,
+        )
+
     # @sdk-operation listWorkflowRuns
     async def list_workflow_runs(self, *args: Any, **kwargs: Any) -> Any:
         if args:
@@ -452,3 +506,21 @@ class AsyncWorkflowsResource:
             on_progress=on_progress,
             cancel_event=cancel_event,
         )
+
+    async def video_to_video_and_wait(self, *args: Any, **kwargs: Any) -> Any:
+        poll_interval_ms = kwargs.pop('poll_interval_ms', 1500)
+        timeout_ms = kwargs.pop('timeout_ms', 3_600_000)
+        throw_on_failure = kwargs.pop('throw_on_failure', True)
+        on_progress = kwargs.pop('on_progress', None)
+        cancel_event = kwargs.get('cancel_event')
+        started = await self.video_to_video(*args, **kwargs)
+        workflow_run_id = started['workflow_run_id']
+        return await async_poll_workflow_run(
+            self._root,
+            workflow_run_id,
+            poll_interval_ms=poll_interval_ms,
+            timeout_ms=timeout_ms,
+            throw_on_failure=throw_on_failure,
+            on_progress=on_progress,
+            cancel_event=cancel_event,
+        )

{videogen-2.2.0 → videogen-2.5.3}/src/videogen/upload_file.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import time
+import warnings
 from typing import Any, BinaryIO, Optional, Union
 
 import httpx
@@ -58,8 +59,8 @@ def upload_file(
         type: Optional file type (IMAGE, VIDEO, AUDIO, PDF, SLIDESHOW, LOTTIE).
             If omitted, auto-detected. Lottie animations (Bodymovin JSON) must
             set LOTTIE explicitly.
-        hide_from_ui: When true, hide the file from the VideoGen Media page.
-            Defaults to false.
+        hide_from_ui: Deprecated and ignored. Uploaded files always appear in
+            the VideoGen app. Passing a value emits a ``DeprecationWarning``.
         timeout_ms: Maximum time in ms to wait for processing. Defaults to
             3_600_000 (1 hour).
 
@@ -72,11 +73,17 @@ def upload_file(
         source means the upload is usable; only fail when something failed and
         nothing is ready.
     """
+    if hide_from_ui is not None:
+        warnings.warn(
+            "upload_file(hide_from_ui=...) is deprecated and ignored. "
+            "Uploaded files always appear in the VideoGen app.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
     if display_name is None:
         display_name = "upload"
     body: dict[str, Any] = {
         "display_name": display_name,
-        "hide_from_ui": False if hide_from_ui is None else hide_from_ui,
     }
     if type is not None:
         body["type"] = type

{videogen-2.2.0 → videogen-2.5.3}/src/videogen.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: videogen
-Version: 2.2.0
+Version: 2.5.3
 Summary: Official Python SDK for the VideoGen API
 Author-email: VideoGen <support@videogen.io>
 License: MIT
@@ -101,7 +101,7 @@ print(run.download_url)
 | Area | Client surface | Typical entry points |
 | --- | --- | --- |
 | Account | `vg.account` | `get_me` |
-| Workflows | `vg.workflows` | `script_to_video_and_wait`, `prompt_to_video_clip_and_wait`, `voiceover_to_video_and_wait`, `slideshow_to_video_and_wait` |
+| Workflows | `vg.workflows` | `script_to_video_and_wait`, `prompt_to_video_clip_and_wait`, `voiceover_to_video_and_wait`, `slideshow_to_video_and_wait`, `video_to_video_and_wait` |
 | Tools | `vg.tools` | `generate_image_and_wait`, `generate_video_clip_and_wait`, `text_to_speech_and_wait`, … |
 | Files | helpers on `vg` | `upload_file`, `download_file`, `create_public_preview` |
 | Projects | `vg.projects` | `export_and_wait`, `remix_and_wait`, `create_timeline_interchange_and_wait` |
@@ -136,7 +136,7 @@ run = vg.workflows.prompt_to_video_clip_and_wait(
 print(run.download_url)
 ```
 
-Other workflow starters: `voiceover_to_video_and_wait` (uploaded audio `file_id`), `slideshow_to_video_and_wait` (deck `file_id`).
+Other workflow starters: `voiceover_to_video_and_wait` (uploaded audio `file_id`), `slideshow_to_video_and_wait` (deck `file_id`), `video_to_video_and_wait` (restyles an uploaded `video_file_id` or a public `video_url` from a `prompt`).
 
 ## Tools
 
@@ -284,8 +284,8 @@ Exported as module functions and bound on the client:
 | Helper | Purpose |
 | --- | --- |
 | `poll_assistant_message` / `async_poll_assistant_message` | Poll an assistant message to a terminal status |
-| `poll_executed_tool` / `async_poll_executed_tool` | Poll a tool execution to a terminal status |
-| `poll_workflow_run` / `async_poll_workflow_run` | Poll a workflow run |
+| `poll_executed_tool` / `async_poll_executed_tool` | Poll a tool execution to a terminal status or `awaiting_approval` |
+| `poll_workflow_run` / `async_poll_workflow_run` | Poll a workflow run to a terminal status or `awaiting_approval` |
 | `poll_project_export` / `async_poll_project_export` | Poll a project export |
 | `poll_timeline_interchange` / `async_poll_timeline_interchange` | Poll a timeline interchange job |
 | `poll_remix_actions` / `async_poll_remix_actions` | Poll remix actions until all are terminal |
@@ -296,6 +296,8 @@ Exported as module functions and bound on the client:
 | `create_public_preview` / `async_create_public_preview` | Enable + poll public preview |
 | `verify_webhook_signature` | Verify Standard Webhooks and return the event dict |
 
+Workflow and tool pollers, including their `*_and_wait` wrappers, return `awaiting_approval` unchanged without throwing, even with the default `throw_on_failure=True`. This status means the result needs approval; it does not mean the operation succeeded. Check `status` before using the result as a completed operation.
+
 Cancellation: pass `cancel_event=threading.Event()` (sync) or `asyncio.Event()` (async) to poll helpers and thin request methods. Setting the event raises `PollCancelledError`.
 
 ## Errors

{videogen-2.2.0 → videogen-2.5.3}/src/videogen.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ src/videogen/async_download_file.py
 src/videogen/async_get_hydrated_file.py
 src/videogen/async_poll_assistant_message.py
 src/videogen/async_poll_executed_tool.py
+src/videogen/async_poll_file_url_import.py
 src/videogen/async_poll_project_export.py
 src/videogen/async_poll_public_preview.py
 src/videogen/async_poll_remix_actions.py
@@ -20,6 +21,7 @@ src/videogen/errors.py
 src/videogen/get_hydrated_file.py
 src/videogen/poll_assistant_message.py
 src/videogen/poll_executed_tool.py
+src/videogen/poll_file_url_import.py
 src/videogen/poll_helpers.py
 src/videogen/poll_project_export.py
 src/videogen/poll_public_preview.py