licos-dev-cli 0.2.10__tar.gz → 0.2.12__tar.gz

{licos_dev_cli-0.2.10 → licos_dev_cli-0.2.12}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: licos-dev-cli
-Version: 0.2.10
+Version: 0.2.12
 Summary: LICOS Dev CLI - generate files and call model capabilities
 Requires-Python: >=3.10
 Requires-Dist: click>=8.1
-Requires-Dist: licos-dev-sdk>=0.2.11
+Requires-Dist: licos-dev-sdk>=0.2.13

{licos_dev_cli-0.2.10 → licos_dev_cli-0.2.12}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "hatchling.build"
 
 [project]
 name = "licos-dev-cli"
-version = "0.2.10"
+version = "0.2.12"
 description = "LICOS Dev CLI - generate files and call model capabilities"
 requires-python = ">=3.10"
 dependencies = [
-    "licos-dev-sdk>=0.2.11",
+    "licos-dev-sdk>=0.2.13",
     "click>=8.1",
 ]
 

{licos_dev_cli-0.2.10 → licos_dev_cli-0.2.12}/src/licos_dev_cli/main.py

@@ -432,27 +432,32 @@ def vision_group():
     pass
 
 
-@vision_group.command("understand")
-@click.option("--image-url", multiple=True, help="Image URL. Can be repeated.")
-@click.option("-p", "--prompt", default="Describe this image.")
-@click.option("--model", default=None)
-@click.option("--raw-request", default=None, help="Raw JSON request body")
-def vision_understand(image_url, prompt, model, raw_request):
-    """Understand one or more images with the catalog vision model."""
-    from licos_dev_sdk import VisionClient
-
-    raw_payload = _json_option(raw_request, "--raw-request")
-    if raw_payload is not None and not isinstance(raw_payload, dict):
-        raise click.BadParameter("--raw-request must be a JSON object")
-    if raw_payload is None and not image_url:
-        raise click.UsageError("Provide --image-url or --raw-request.")
-    result = VisionClient().understand(
-        image_urls=list(image_url),
-        prompt=prompt,
-        model=model,
-        raw_request=raw_payload,
-    )
-    _echo_json(result)
+@vision_group.command("understand")
+@click.option("--image", "image", multiple=True, help="Image URL, Base64 data URI, or plain Base64 image data. Can be repeated.")
+@click.option("--image-url", "image_url", multiple=True, help="Alias for --image. Can be repeated.")
+@click.option("--file-path", "file_path", multiple=True, help="Local image file path. Can be repeated.")
+@click.option("-p", "--prompt", default="Describe this image.")
+@click.option("--model", default=None)
+@click.option("--mime-type", default=None, help="MIME type for plain Base64 image inputs. Defaults to image/png.")
+@click.option("--raw-request", default=None, help="Raw JSON request body")
+def vision_understand(image, image_url, file_path, prompt, model, mime_type, raw_request):
+    """Understand one or more images with the catalog vision model."""
+    from licos_dev_sdk import VisionClient
+
+    raw_payload = _json_option(raw_request, "--raw-request")
+    if raw_payload is not None and not isinstance(raw_payload, dict):
+        raise click.BadParameter("--raw-request must be a JSON object")
+    if raw_payload is None and not image_url and not image and not file_path:
+        raise click.UsageError("Provide --image, --image-url, --file-path, or --raw-request.")
+    result = VisionClient().understand(
+        images=[*image, *image_url],
+        file_paths=list(file_path),
+        prompt=prompt,
+        model=model,
+        mime_type=mime_type,
+        raw_request=raw_payload,
+    )
+    _echo_json(result)
 
 
 # ── Image Generation ─────────────────────────────────────────────────────────
@@ -464,16 +469,35 @@ def image_generation_group():
 
 
 @image_generation_group.command("generate")
-@click.option("-p", "--prompt")
-@click.option("--negative-prompt", default=None)
-@click.option("--count", default=1, type=int)
-@click.option("--size", default=None)
+@click.option("-p", "--prompt")
+@click.option("--image", "image", multiple=True, help="Source/reference image URL or Base64 data URI")
+@click.option("--image-url", "image_url", multiple=True, help="Alias for --image")
+@click.option("--reference-image", default=None, help="Alias for --image")
+@click.option("--file-path", "file_path", multiple=True, help="Local source/reference image path")
+@click.option("--input-capabilities", default=None, help="Override image model input filter: text or image")
+@click.option("--negative-prompt", default=None)
+@click.option("--count", default=1, type=int)
+@click.option("--size", default=None)
 @click.option("--model", default=None)
-@click.option("--parameters", default=None, help="Parameters JSON object")
-@click.option("--raw-request", default=None, help="Raw JSON request body")
-@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
-def image_generate(prompt, negative_prompt, count, size, model, parameters, raw_request, no_wait):
-    """Generate images from a text prompt."""
+@click.option("--parameters", default=None, help="Parameters JSON object")
+@click.option("--raw-request", default=None, help="Raw JSON request body")
+@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
+def image_generate(
+    prompt,
+    image,
+    image_url,
+    reference_image,
+    file_path,
+    input_capabilities,
+    negative_prompt,
+    count,
+    size,
+    model,
+    parameters,
+    raw_request,
+    no_wait,
+):
+    """Generate images from text, image URLs/Base64, or local image files."""
     from licos_dev_sdk import ImageGenerationClient
 
     parameter_payload = _json_option(parameters, "--parameters") or {}
@@ -486,12 +510,16 @@ def image_generate(prompt, negative_prompt, count, size, model, parameters, raw_
         raise click.UsageError("Provide --prompt or --raw-request.")
     result = ImageGenerationClient().generate(
         prompt or "",
-        negative_prompt=negative_prompt,
-        count=count,
-        size=size,
-        model=model,
-        parameters=parameter_payload,
-        raw_request=raw_payload,
+        negative_prompt=negative_prompt,
+        count=count,
+        size=size,
+        images=[*image, *image_url],
+        reference_image=reference_image,
+        file_paths=list(file_path),
+        input_capabilities=input_capabilities,
+        model=model,
+        parameters=parameter_payload,
+        raw_request=raw_payload,
         wait=not no_wait,
     )
     _echo_json(result)
@@ -505,18 +533,36 @@ def video_generation_group():
     pass
 
 
-@video_generation_group.command("generate")
-@click.option("-p", "--prompt")
-@click.option("--image-url", default=None)
-@click.option("--model", default=None)
-@click.option("--input-capabilities", default=None, help="Override video model input filter: text or image")
-@click.option("--parameters", default=None, help="Parameters JSON object")
-@click.option("--raw-request", default=None, help="Raw JSON request body")
-@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
-def video_generate(prompt, image_url, model, input_capabilities, parameters, raw_request, no_wait):
-    """Generate a video from a text prompt and optional first-frame image."""
-    from licos_dev_sdk import VideoGenerationClient
-
+@video_generation_group.command("generate")
+@click.option("-p", "--prompt")
+@click.option("--image", default=None, help="Source/reference image URL, Base64 data URI, or plain Base64 image data")
+@click.option("--image-url", default=None, help="Alias for --image")
+@click.option("--reference-image", default=None, help="Alias for --image")
+@click.option("--first-frame-url", default=None, help="Alias for --image")
+@click.option("--file-path", default=None, help="Local source/reference image path")
+@click.option("--model", default=None)
+@click.option("--input-capabilities", default=None, help="Override video model input filter: text or image")
+@click.option("--mime-type", default=None, help="MIME type for plain Base64 image inputs. Defaults to image/png.")
+@click.option("--parameters", default=None, help="Parameters JSON object")
+@click.option("--raw-request", default=None, help="Raw JSON request body")
+@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
+def video_generate(
+    prompt,
+    image,
+    image_url,
+    reference_image,
+    first_frame_url,
+    file_path,
+    model,
+    input_capabilities,
+    mime_type,
+    parameters,
+    raw_request,
+    no_wait,
+):
+    """Generate a video from a text prompt and optional first-frame image."""
+    from licos_dev_sdk import VideoGenerationClient
+
     parameter_payload = _json_option(parameters, "--parameters") or {}
     raw_payload = _json_option(raw_request, "--raw-request")
     if not isinstance(parameter_payload, dict):
@@ -525,14 +571,19 @@ def video_generate(prompt, image_url, model, input_capabilities, parameters, raw
         raise click.BadParameter("--raw-request must be a JSON object")
     if raw_payload is None and not prompt:
         raise click.UsageError("Provide --prompt or --raw-request.")
-    result = VideoGenerationClient().generate(
-        prompt or "",
-        image_url=image_url,
-        model=model,
-        input_capabilities=input_capabilities,
-        parameters=parameter_payload,
-        raw_request=raw_payload,
-        wait=not no_wait,
+    result = VideoGenerationClient().generate(
+        prompt or "",
+        image=image,
+        image_url=image_url,
+        reference_image=reference_image,
+        first_frame_url=first_frame_url,
+        file_path=file_path,
+        model=model,
+        input_capabilities=input_capabilities,
+        mime_type=mime_type,
+        parameters=parameter_payload,
+        raw_request=raw_payload,
+        wait=not no_wait,
     )
     _echo_json(result)
 
@@ -545,30 +596,35 @@ def audio_group():
     pass
 
 
-@audio_group.command("recognize")
-@click.option("--audio-url", multiple=True, help="Audio URL. Can be repeated.")
-@click.option("--model", default=None)
-@click.option("--parameters", default=None, help="Parameters JSON object")
-@click.option("--raw-request", default=None, help="Raw JSON request body")
-@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
-def audio_recognize(audio_url, model, parameters, raw_request, no_wait):
-    """Recognize speech from one or more audio URLs."""
-    from licos_dev_sdk import SpeechRecognitionClient
-
+@audio_group.command("recognize")
+@click.option("--audio", "audio", multiple=True, help="Audio URL, Base64 data URI, or plain Base64 audio data. Can be repeated.")
+@click.option("--audio-url", "audio_url", multiple=True, help="Alias for --audio. Can be repeated.")
+@click.option("--file-path", "file_path", multiple=True, help="Local audio file path. Can be repeated.")
+@click.option("--model", default=None)
+@click.option("--mime-type", default=None, help="MIME type for plain Base64 audio inputs. Defaults to audio/wav.")
+@click.option("--parameters", default=None, help="Parameters JSON object")
+@click.option("--raw-request", default=None, help="Raw JSON request body")
+@click.option("--no-wait", is_flag=True, help="Return submit response without polling async tasks")
+def audio_recognize(audio, audio_url, file_path, model, mime_type, parameters, raw_request, no_wait):
+    """Recognize speech from one or more audio inputs."""
+    from licos_dev_sdk import SpeechRecognitionClient
+
     parameter_payload = _json_option(parameters, "--parameters") or {}
     raw_payload = _json_option(raw_request, "--raw-request")
     if not isinstance(parameter_payload, dict):
         raise click.BadParameter("--parameters must be a JSON object")
     if raw_payload is not None and not isinstance(raw_payload, dict):
         raise click.BadParameter("--raw-request must be a JSON object")
-    if raw_payload is None and not audio_url:
-        raise click.UsageError("Provide --audio-url or --raw-request.")
-    result = SpeechRecognitionClient().recognize(
-        audio_urls=list(audio_url),
-        model=model,
-        parameters=parameter_payload,
-        raw_request=raw_payload,
-        wait=not no_wait,
+    if raw_payload is None and not audio and not audio_url and not file_path:
+        raise click.UsageError("Provide --audio, --audio-url, --file-path, or --raw-request.")
+    result = SpeechRecognitionClient().recognize(
+        audios=[*audio, *audio_url],
+        file_paths=list(file_path),
+        model=model,
+        mime_type=mime_type,
+        parameters=parameter_payload,
+        raw_request=raw_payload,
+        wait=not no_wait,
     )
     _echo_json(result)