sonilo-cli 0.9.0__tar.gz → 0.10.0__tar.gz

sonilo_cli-0.9.0/README.md → sonilo_cli-0.10.0/PKG-INFO

@@ -1,3 +1,19 @@
+Metadata-Version: 2.4
+Name: sonilo-cli
+Version: 0.10.0
+Summary: Command-line interface for the Sonilo API: generate music and sound effects from text or video
+Project-URL: Repository, https://github.com/sonilo-ai/sonilo-python
+Author: Sonilo AI
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,cli,music,sfx,sonilo,text-to-music,video-to-music
+Requires-Python: >=3.9
+Requires-Dist: sonilo<0.13,>=0.12.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Description-Content-Type: text/markdown
+
 # sonilo-cli
 
 Command-line interface for the [Sonilo API](https://github.com/sonilo-ai/sonilo-python) — generate music and sound effects from text or video.
@@ -90,6 +106,17 @@ request — and values above 1 are never covered by the free trial.
 - On `video-to-sound` / `video-to-video-sound`, `--stem` is applied per variant too, e.g.
   `take.0.music.m4a`.
 
+### Prompt influence
+
+`--prompt-influence` (0-1, API default 0.5) sets how strongly the generated music follows the
+prompt, on `video-to-music` and `video-to-video-music` only. Lower values let the video lead;
+higher values follow the prompt more literally. It is free of charge, and unlike `--format wav` it
+does not force the async path — it works on the streaming default too. Left unset, the field is
+not sent at all and the API's own 0.5 default applies; `--prompt-influence 0` is a real value
+("let the video lead entirely") and is sent. Out-of-range values earn a `422` from the API.
+
+    sonilo video-to-music --video clip.mp4 --prompt "tense synths" --prompt-influence 0.8
+
 ### Scored video
 
 `video-to-video-music` and `video-to-video-sfx` are the video-out counterparts of `video-to-music`
@@ -112,6 +139,8 @@ file (default `output.mp4`):
 - For music *and* effects in one call, use `video-to-video-sound` below.
 - `video-to-video-music` also takes `--variants` — see [Variants](#variants) above.
   `video-to-video-sfx` does not.
+- `video-to-video-music` also takes `--prompt-influence` — see
+  [Prompt influence](#prompt-influence) above. `video-to-video-sfx` does not.
 
 ### Combined soundtracks
 

sonilo_cli-0.9.0/PKG-INFO → sonilo_cli-0.10.0/README.md

@@ -1,19 +1,3 @@
-Metadata-Version: 2.4
-Name: sonilo-cli
-Version: 0.9.0
-Summary: Command-line interface for the Sonilo API: generate music and sound effects from text or video
-Project-URL: Repository, https://github.com/sonilo-ai/sonilo-python
-Author: Sonilo AI
-License-Expression: MIT
-License-File: LICENSE
-Keywords: ai,cli,music,sfx,sonilo,text-to-music,video-to-music
-Requires-Python: >=3.9
-Requires-Dist: sonilo<0.12,>=0.11.0
-Provides-Extra: dev
-Requires-Dist: pytest>=8; extra == 'dev'
-Requires-Dist: respx>=0.21; extra == 'dev'
-Description-Content-Type: text/markdown
-
 # sonilo-cli
 
 Command-line interface for the [Sonilo API](https://github.com/sonilo-ai/sonilo-python) — generate music and sound effects from text or video.
@@ -106,6 +90,17 @@ request — and values above 1 are never covered by the free trial.
 - On `video-to-sound` / `video-to-video-sound`, `--stem` is applied per variant too, e.g.
   `take.0.music.m4a`.
 
+### Prompt influence
+
+`--prompt-influence` (0-1, API default 0.5) sets how strongly the generated music follows the
+prompt, on `video-to-music` and `video-to-video-music` only. Lower values let the video lead;
+higher values follow the prompt more literally. It is free of charge, and unlike `--format wav` it
+does not force the async path — it works on the streaming default too. Left unset, the field is
+not sent at all and the API's own 0.5 default applies; `--prompt-influence 0` is a real value
+("let the video lead entirely") and is sent. Out-of-range values earn a `422` from the API.
+
+    sonilo video-to-music --video clip.mp4 --prompt "tense synths" --prompt-influence 0.8
+
 ### Scored video
 
 `video-to-video-music` and `video-to-video-sfx` are the video-out counterparts of `video-to-music`
@@ -128,6 +123,8 @@ file (default `output.mp4`):
 - For music *and* effects in one call, use `video-to-video-sound` below.
 - `video-to-video-music` also takes `--variants` — see [Variants](#variants) above.
   `video-to-video-sfx` does not.
+- `video-to-video-music` also takes `--prompt-influence` — see
+  [Prompt influence](#prompt-influence) above. `video-to-video-sfx` does not.
 
 ### Combined soundtracks
 

{sonilo_cli-0.9.0 → sonilo_cli-0.10.0}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sonilo-cli"
-version = "0.9.0"
+version = "0.10.0"
 description = "Command-line interface for the Sonilo API: generate music and sound effects from text or video"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.9"
 authors = [{ name = "Sonilo AI" }]
-dependencies = ["sonilo>=0.11.0,<0.12"]
+dependencies = ["sonilo>=0.12.0,<0.13"]
 keywords = ["sonilo", "cli", "music", "sfx", "text-to-music", "video-to-music", "ai"]
 
 [project.urls]

{sonilo_cli-0.9.0 → sonilo_cli-0.10.0}/src/sonilo_cli/__init__.py

@@ -1,3 +1,3 @@
-__version__ = "0.9.0"
+__version__ = "0.10.0"
 
 __all__ = ["__version__"]

{sonilo_cli-0.9.0 → sonilo_cli-0.10.0}/src/sonilo_cli/__main__.py

@@ -309,12 +309,15 @@ def cmd_video_to_music(client: Sonilo, args: argparse.Namespace) -> None:
             preserve_speech=args.preserve_speech or None,
             output_format=fmt if fmt != "m4a" else None,
             variants_num=args.variants,
+            prompt_influence=args.prompt_influence,
         )
         _save_music_variants(result, out)
     else:
+        # prompt_influence rides the streaming path too — it is a generation
+        # parameter, not a finalize-time one, so it never forces async.
         track = client.video_to_music.generate(
             video=args.video, video_url=args.video_url, prompt=args.prompt,
-            segments=segments,
+            segments=segments, prompt_influence=args.prompt_influence,
         )
         path = track.save(out)
         _wrote(path, len(track.audio))
@@ -435,6 +438,7 @@ def cmd_video_to_video_music(client: Sonilo, args: argparse.Namespace) -> None:
         preserve_speech=True if args.preserve_speech else None,
         isolate_vocals=True if args.isolate_vocals else None,
         variants_num=args.variants,
+        prompt_influence=args.prompt_influence,
     )
 
 
@@ -543,6 +547,19 @@ def _add_segments(parser: argparse.ArgumentParser, shape: _SegmentShape) -> None
     parser.set_defaults(segments_shape=shape)
 
 
+def _add_prompt_influence(parser: argparse.ArgumentParser) -> None:
+    # Only the two music-from-video commands take this — the API accepts it
+    # nowhere else. type=float so 0 arrives as 0.0, a real value ("let the
+    # video lead entirely"), distinct from the unset None that keeps the
+    # field off the wire and leaves the API its own 0.5 default.
+    parser.add_argument(
+        "--prompt-influence", dest="prompt_influence", type=float, default=None,
+        help="How strongly the generated music follows the prompt, 0-1 "
+             "(API default 0.5). Lower values let the video lead; higher "
+             "values follow the prompt more literally. Free of charge.",
+    )
+
+
 def _add_variants(parser: argparse.ArgumentParser) -> None:
     parser.add_argument(
         "--variants", type=int, default=None,
@@ -601,6 +618,7 @@ def build_parser() -> argparse.ArgumentParser:
     p_v2m.add_argument("--async", dest="use_async", action="store_true",
                        help="Submit and poll instead of streaming.")
     _add_variants(p_v2m)
+    _add_prompt_influence(p_v2m)
     p_v2m.set_defaults(func=cmd_video_to_music)
 
     p_t2s = sub.add_parser("text-to-sfx", help="Generate a sound effect from a text prompt")
@@ -677,6 +695,7 @@ def build_parser() -> argparse.ArgumentParser:
                         help="Legacy alias for --preserve-speech; no separate stem.")
     p_v2vm.add_argument("--output", default=None, help="Where to save the scored video.")
     _add_variants(p_v2vm)
+    _add_prompt_influence(p_v2vm)
     p_v2vm.set_defaults(func=cmd_video_to_video_music)
 
     p_v2vfx = sub.add_parser(

{sonilo_cli-0.9.0 → sonilo_cli-0.10.0}/tests/test_cli.py

@@ -1096,3 +1096,64 @@ def test_video_to_video_commands_are_listed_in_top_level_help(command, capsys):
     with pytest.raises(SystemExit):
         main(["--help"])
     assert command in capsys.readouterr().out
+
+
+# --- --prompt-influence -------------------------------------------------------
+#
+# Only video-to-music and video-to-video-music offer the flag — the API
+# accepts prompt_influence nowhere else. Unset forwards None (field absent,
+# API default 0.5 stands); 0 is a real value and must be sent as 0.0.
+
+
+@respx.mock
+def test_video_to_music_prompt_influence_rides_the_streaming_path(tmp_path):
+    """prompt_influence is a generation parameter, valid on stream and async
+    alike, so unlike --format wav it must NOT force the async path."""
+    route = respx.post(f"{BASE}/v1/video-to-music").mock(
+        return_value=httpx.Response(200, text=_music_stream_body())
+    )
+    run(["video-to-music", "--video-url", "http://x/y.mp4",
+         "--prompt-influence", "0.8", "--output", str(tmp_path / "song.m4a")])
+    body = route.calls.last.request.content.decode()
+    assert "prompt_influence=0.8" in body
+
+
+@respx.mock
+def test_video_to_music_prompt_influence_zero_is_sent(tmp_path):
+    """0 means "let the video lead entirely" — a real request, distinct from
+    unset, so it goes on the wire (as 0.0: argparse's float parse)."""
+    route = respx.post(f"{BASE}/v1/video-to-music").mock(
+        return_value=httpx.Response(200, text=_music_stream_body())
+    )
+    run(["video-to-music", "--video-url", "http://x/y.mp4",
+         "--prompt-influence", "0", "--output", str(tmp_path / "song.m4a")])
+    body = route.calls.last.request.content.decode()
+    assert "prompt_influence=0.0" in body
+
+
+@respx.mock
+def test_video_to_music_omits_prompt_influence_when_unset(tmp_path):
+    route = respx.post(f"{BASE}/v1/video-to-music").mock(
+        return_value=httpx.Response(200, text=_music_stream_body())
+    )
+    run(["video-to-music", "--video-url", "http://x/y.mp4",
+         "--output", str(tmp_path / "song.m4a")])
+    # Absent, not "None" and not an explicit 0.5 pinning the API's default.
+    assert b"prompt_influence" not in route.calls.last.request.content
+
+
+@respx.mock
+def test_video_to_video_music_prompt_influence_reaches_the_request_body(tmp_path):
+    route = _mock_video_task("video-to-video-music", "vmpi1", "video_to_video_music")
+    run(["video-to-video-music", "--video-url", "http://x/y.mp4",
+         "--prompt-influence", "0.3", "--output", str(tmp_path / "s.mp4")])
+    body = route.calls.last.request.content.decode()
+    assert "prompt_influence=0.3" in body
+
+
+@respx.mock
+def test_video_to_video_music_omits_prompt_influence_when_unset(tmp_path):
+    route = _mock_video_task("video-to-video-music", "vmpi2", "video_to_video_music")
+    run(["video-to-video-music", "--video-url", "http://x/y.mp4",
+         "--output", str(tmp_path / "s.mp4")])
+    assert b"prompt_influence" not in route.calls.last.request.content