PyPI - runapi-kling - Versions diffs - 0.2.0__tar.gz → 0.2.2__tar.gz - Mend

runapi-kling 0.2.0tar.gz → 0.2.2tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

{runapi_kling-0.2.0 → runapi_kling-0.2.2}/PKG-INFO RENAMED Viewed

@@ -1,25 +1,25 @@
 Metadata-Version: 2.4
 Name: runapi-kling
-Version: 0.2.0
+Version: 0.2.2
 Summary: RunAPI Kling SDK for text-to-video, image-to-video, avatar, and motion-control workflows in JavaScript, Python, Ruby, Go, Java, and PHP
 Project-URL: Homepage, https://runapi.ai/models/kling
-Project-URL: Documentation, https://runapi.ai/docs#sdk-kling
+Project-URL: Documentation, https://runapi.ai/docs/resources/sdks
 Project-URL: Source, https://github.com/runapi-ai/kling-sdk
 Project-URL: Issues, https://github.com/runapi-ai/kling-sdk/issues
 Project-URL: Changelog, https://github.com/runapi-ai/kling-sdk/blob/main/CHANGELOG.md
-Project-URL: Release Notes, https://github.com/runapi-ai/kling-sdk/releases/tag/python%2Fv0.2.0
+Project-URL: Release Notes, https://github.com/runapi-ai/kling-sdk/releases/tag/python%2Fv0.2.2
 Author-email: RunAPI <contact@runapi.ai>
 License-Expression: Apache-2.0
 Keywords: api,golang,gradle,java,kling,kling-ai-api,maven,python,ruby,runapi,runapi-ai,sdk,text-to-video,typescript,video-api,video-generation
 Requires-Python: >=3.9
-Requires-Dist: runapi-core>=0.3.0
+Requires-Dist: runapi-core>=0.3.3
 Description-Content-Type: text/markdown
 # Kling API Python SDK for RunAPI
 The Kling Python SDK is the language-specific package for Kling on RunAPI. Use this package for video generation, animation, and video editing workflows when your application needs request bodies, task status lookup, and consistent RunAPI errors in Python.
-This README is the Python package guide inside the public `kling-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/kling; for API reference, use https://runapi.ai/docs#kling; for SDK docs, use https://runapi.ai/docs#sdk-kling.
+This README is the Python package guide inside the public `kling-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/kling; for API reference, use https://runapi.ai/docs/api/kling/text-to-video; for SDK docs, use https://runapi.ai/docs/resources/sdks.
 ## Install
@@ -48,6 +48,23 @@ avatar = client.ai_avatar.create(
 )
 ```
+## Kling O1 reference media
+```python
+result = client.text_to_video.run(
+    model="kling-o1",
+    prompt="Keep <<<image_1>>> beside the performer from <<<video_1>>>",
+    reference_image_urls=["https://cdn.runapi.ai/public/samples/portrait.jpg"],
+    reference_video_url="https://cdn.runapi.ai/public/samples/video.mp4",
+    reference_video_type="feature",
+    preserve_reference_video_audio=True,
+    mode="pro",
+    duration_seconds=5,
+)
+```
+Number reference images in prompt order as `<<<image_1>>>`, `<<<image_2>>>`, and so on; the optional video is `<<<video_1>>>`. With a video, send at most four images. Do not combine `last_frame_image_url` with reference images or a reference video. A `feature` reference video may be used with the required first frame; `base` cannot be combined with frame inputs. O1 requests are five seconds and keep sound disabled. Pricing and limits: https://runapi.ai/models/kling/o1.
 Use `create` when you want to submit a task and return quickly, `get` when you need the latest task state, and `run` when a script should create and poll until completion:
 ```python
@@ -69,8 +86,8 @@ Pass parameters as keyword arguments and catch the `runapi.kling` error classes
 ## Links
 - Model page: https://runapi.ai/models/kling
-- SDK docs: https://runapi.ai/docs#sdk-kling
-- Product docs: https://runapi.ai/docs#kling
+- SDK docs: https://runapi.ai/docs/resources/sdks
+- Product docs: https://runapi.ai/docs/api/kling/text-to-video
 - Pricing and rate limits: https://runapi.ai/models/kling/3.0
 - Provider comparison: https://runapi.ai/providers/kuaishou
 - Full catalog: https://runapi.ai/models

{runapi_kling-0.2.0 → runapi_kling-0.2.2}/README.md RENAMED Viewed

@@ -2,7 +2,7 @@
 The Kling Python SDK is the language-specific package for Kling on RunAPI. Use this package for video generation, animation, and video editing workflows when your application needs request bodies, task status lookup, and consistent RunAPI errors in Python.
-This README is the Python package guide inside the public `kling-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/kling; for API reference, use https://runapi.ai/docs#kling; for SDK docs, use https://runapi.ai/docs#sdk-kling.
+This README is the Python package guide inside the public `kling-sdk` repository. For the repository overview, start at `../README.md`; for model details, use https://runapi.ai/models/kling; for API reference, use https://runapi.ai/docs/api/kling/text-to-video; for SDK docs, use https://runapi.ai/docs/resources/sdks.
 ## Install
@@ -31,6 +31,23 @@ avatar = client.ai_avatar.create(
 )
 ```
+## Kling O1 reference media
+```python
+result = client.text_to_video.run(
+    model="kling-o1",
+    prompt="Keep <<<image_1>>> beside the performer from <<<video_1>>>",
+    reference_image_urls=["https://cdn.runapi.ai/public/samples/portrait.jpg"],
+    reference_video_url="https://cdn.runapi.ai/public/samples/video.mp4",
+    reference_video_type="feature",
+    preserve_reference_video_audio=True,
+    mode="pro",
+    duration_seconds=5,
+)
+```
+Number reference images in prompt order as `<<<image_1>>>`, `<<<image_2>>>`, and so on; the optional video is `<<<video_1>>>`. With a video, send at most four images. Do not combine `last_frame_image_url` with reference images or a reference video. A `feature` reference video may be used with the required first frame; `base` cannot be combined with frame inputs. O1 requests are five seconds and keep sound disabled. Pricing and limits: https://runapi.ai/models/kling/o1.
 Use `create` when you want to submit a task and return quickly, `get` when you need the latest task state, and `run` when a script should create and poll until completion:
 ```python
@@ -52,8 +69,8 @@ Pass parameters as keyword arguments and catch the `runapi.kling` error classes
 ## Links
 - Model page: https://runapi.ai/models/kling
-- SDK docs: https://runapi.ai/docs#sdk-kling
-- Product docs: https://runapi.ai/docs#kling
+- SDK docs: https://runapi.ai/docs/resources/sdks
+- Product docs: https://runapi.ai/docs/api/kling/text-to-video
 - Pricing and rate limits: https://runapi.ai/models/kling/3.0
 - Provider comparison: https://runapi.ai/providers/kuaishou
 - Full catalog: https://runapi.ai/models

{runapi_kling-0.2.0 → runapi_kling-0.2.2}/pyproject.toml RENAMED Viewed

@@ -4,22 +4,22 @@ build-backend = "hatchling.build"
 [project]
 name = "runapi-kling"
-version = "0.2.0"
+version = "0.2.2"
 description = "RunAPI Kling SDK for text-to-video, image-to-video, avatar, and motion-control workflows in JavaScript, Python, Ruby, Go, Java, and PHP"
 readme = "README.md"
 requires-python = ">=3.9"
 license = "Apache-2.0"
 authors = [{ name = "RunAPI", email = "contact@runapi.ai" }]
 keywords = ["runapi", "runapi-ai", "kling", "api", "sdk", "typescript", "python", "ruby", "golang", "java", "maven", "gradle", "video-generation", "text-to-video", "video-api", "kling-ai-api"]
-dependencies = ["runapi-core>=0.3.0"]
+dependencies = ["runapi-core>=0.3.3"]
 [project.urls]
 Homepage = "https://runapi.ai/models/kling"
-Documentation = "https://runapi.ai/docs#sdk-kling"
+Documentation = "https://runapi.ai/docs/resources/sdks"
 Source = "https://github.com/runapi-ai/kling-sdk"
 Issues = "https://github.com/runapi-ai/kling-sdk/issues"
 Changelog = "https://github.com/runapi-ai/kling-sdk/blob/main/CHANGELOG.md"
-"Release Notes" = "https://github.com/runapi-ai/kling-sdk/releases/tag/python%2Fv0.2.0"
+"Release Notes" = "https://github.com/runapi-ai/kling-sdk/releases/tag/python%2Fv0.2.2"
 [tool.hatch.build.targets.wheel]
 packages = ["src/runapi"]

{runapi_kling-0.2.0 → runapi_kling-0.2.2}/src/runapi/kling/contract_gen.py RENAMED Viewed

@@ -82,8 +82,39 @@ CONTRACT = {
         }
     },
     "image-to-video": {
-        "models": ["kling-v2.1-master-image-to-video", "kling-v2.1-pro", "kling-v2.1-standard", "kling-v2.5-turbo-image-to-video-pro", "kling-v2.6", "kling-v3-omni", "kling-v3-turbo-image-to-video"],
+        "models": ["kling-o1", "kling-v2.1-master-image-to-video", "kling-v2.1-pro", "kling-v2.1-standard", "kling-v2.5-turbo-image-to-video-pro", "kling-v2.6", "kling-v3-omni", "kling-v3-turbo-image-to-video"],
         "fields_by_model": {
+            "kling-o1": {
+                "aspect_ratio": {
+                    "enum": ["16:9", "9:16", "1:1"]
+                },
+                "duration_seconds": {
+                    "enum": [5],
+                    "type": "integer"
+                },
+                "first_frame_image_url": {
+                    "required": True
+                },
+                "mode": {
+                    "enum": ["std", "pro"]
+                },
+                "model": {
+                    "required": True
+                },
+                "prompt": {
+                    "required": True,
+                    "min": 1,
+                    "max": 2500,
+                    "length": True
+                },
+                "reference_image_urls": {
+                    "min_items": 1,
+                    "max_items": 7
+                },
+                "reference_video_type": {
+                    "enum": ["base", "feature"]
+                }
+            },
             "kling-v2.1-master-image-to-video": {
                 "duration_seconds": {
                     "enum": [5, 10],
@@ -215,40 +246,45 @@ CONTRACT = {
             }
         },
         "rules": [{
+            "when": {
+                "model": "kling-o1"
+            },
+            "forbidden": ["output_resolution", "negative_prompt", "cfg_scale"]
+        }, {
             "when": {
                 "model": "kling-v2.1-master-image-to-video"
             },
-            "forbidden": ["output_resolution", "enable_sound"]
+            "forbidden": ["output_resolution", "enable_sound", "reference_image_urls", "reference_video_url", "reference_video_type", "preserve_reference_video_audio"]
         }, {
             "when": {
                 "model": "kling-v2.1-pro"
             },
-            "forbidden": ["output_resolution", "enable_sound"]
+            "forbidden": ["output_resolution", "enable_sound", "reference_image_urls", "reference_video_url", "reference_video_type", "preserve_reference_video_audio"]
         }, {
             "when": {
                 "model": "kling-v2.1-standard"
             },
-            "forbidden": ["output_resolution", "enable_sound"]
+            "forbidden": ["output_resolution", "enable_sound", "reference_image_urls", "reference_video_url", "reference_video_type", "preserve_reference_video_audio"]
         }, {
             "when": {
                 "model": "kling-v2.5-turbo-image-to-video-pro"
             },
-            "forbidden": ["output_resolution", "enable_sound"]
+            "forbidden": ["output_resolution", "enable_sound", "reference_image_urls", "reference_video_url", "reference_video_type", "preserve_reference_video_audio"]
         }, {
             "when": {
                 "model": "kling-v2.6"
             },
-            "forbidden": ["output_resolution", "negative_prompt", "cfg_scale"]
+            "forbidden": ["output_resolution", "negative_prompt", "cfg_scale", "reference_image_urls", "reference_video_url", "reference_video_type", "preserve_reference_video_audio"]
         }, {
             "when": {
                 "model": "kling-v3-omni"
             },
-            "forbidden": ["negative_prompt", "cfg_scale"]
+            "forbidden": ["negative_prompt", "cfg_scale", "reference_image_urls", "reference_video_url", "reference_video_type", "preserve_reference_video_audio"]
         }, {
             "when": {
                 "model": "kling-v3-turbo-image-to-video"
             },
-            "forbidden": ["enable_sound", "aspect_ratio", "negative_prompt", "cfg_scale", "last_frame_image_url"]
+            "forbidden": ["enable_sound", "aspect_ratio", "negative_prompt", "cfg_scale", "last_frame_image_url", "reference_image_urls", "reference_video_url", "reference_video_type", "preserve_reference_video_audio"]
         }]
     },
     "motion-control": {
@@ -306,7 +342,7 @@ CONTRACT = {
         }]
     },
     "text-to-video": {
-        "models": ["kling-3.0", "kling-v2.1-master-text-to-video", "kling-v2.5-turbo-text-to-video-pro", "kling-v2.6", "kling-v3-omni", "kling-v3-turbo-text-to-video"],
+        "models": ["kling-3.0", "kling-o1", "kling-v2.1-master-text-to-video", "kling-v2.5-turbo-text-to-video-pro", "kling-v2.6", "kling-v3-omni", "kling-v3-turbo-text-to-video"],
         "fields_by_model": {
             "kling-3.0": {
                 "aspect_ratio": {
@@ -323,6 +359,34 @@ CONTRACT = {
                     "enum": ["720p", "1080p", "4k"]
                 }
             },
+            "kling-o1": {
+                "aspect_ratio": {
+                    "enum": ["16:9", "9:16", "1:1"]
+                },
+                "duration_seconds": {
+                    "enum": [5],
+                    "type": "integer"
+                },
+                "mode": {
+                    "enum": ["std", "pro"]
+                },
+                "model": {
+                    "required": True
+                },
+                "prompt": {
+                    "required": True,
+                    "min": 1,
+                    "max": 2500,
+                    "length": True
+                },
+                "reference_image_urls": {
+                    "min_items": 1,
+                    "max_items": 7
+                },
+                "reference_video_type": {
+                    "enum": ["base", "feature"]
+                }
+            },
             "kling-v2.1-master-text-to-video": {
                 "aspect_ratio": {
                     "enum": ["16:9", "9:16", "1:1"]
@@ -412,25 +476,40 @@ CONTRACT = {
             }
         },
         "rules": [{
+            "when": {
+                "model": "kling-3.0"
+            },
+            "forbidden": ["reference_image_urls", "reference_video_url", "reference_video_type", "preserve_reference_video_audio"]
+        }, {
+            "when": {
+                "model": "kling-o1"
+            },
+            "forbidden": ["output_resolution", "negative_prompt", "cfg_scale", "multi_shots", "multi_prompt", "first_frame_image_url", "last_frame_image_url", "kling_elements"]
+        }, {
+            "when": {
+                "model": "kling-v2.1-master-text-to-video"
+            },
+            "forbidden": ["mode", "reference_image_urls", "reference_video_url", "reference_video_type", "preserve_reference_video_audio"]
+        }, {
             "when": {
                 "model": "kling-v2.5-turbo-text-to-video-pro"
             },
-            "forbidden": ["mode"]
+            "forbidden": ["mode", "reference_image_urls", "reference_video_url", "reference_video_type", "preserve_reference_video_audio"]
         }, {
             "when": {
                 "model": "kling-v2.6"
             },
-            "forbidden": ["output_resolution", "negative_prompt", "cfg_scale", "multi_shots", "multi_prompt", "first_frame_image_url", "last_frame_image_url", "kling_elements"]
+            "forbidden": ["output_resolution", "negative_prompt", "cfg_scale", "multi_shots", "multi_prompt", "first_frame_image_url", "last_frame_image_url", "kling_elements", "reference_image_urls", "reference_video_url", "reference_video_type", "preserve_reference_video_audio"]
         }, {
             "when": {
                 "model": "kling-v3-omni"
             },
-            "forbidden": ["negative_prompt", "cfg_scale", "multi_shots", "multi_prompt", "first_frame_image_url", "last_frame_image_url", "kling_elements"]
+            "forbidden": ["negative_prompt", "cfg_scale", "multi_shots", "multi_prompt", "first_frame_image_url", "last_frame_image_url", "kling_elements", "reference_image_urls", "reference_video_url", "reference_video_type", "preserve_reference_video_audio"]
         }, {
             "when": {
                 "model": "kling-v3-turbo-text-to-video"
             },
-            "forbidden": ["enable_sound", "negative_prompt", "cfg_scale", "multi_shots", "multi_prompt", "first_frame_image_url", "last_frame_image_url", "kling_elements"]
+            "forbidden": ["enable_sound", "negative_prompt", "cfg_scale", "multi_shots", "multi_prompt", "first_frame_image_url", "last_frame_image_url", "kling_elements", "reference_image_urls", "reference_video_url", "reference_video_type", "preserve_reference_video_audio"]
         }]
     }
 }

{runapi_kling-0.2.0 → runapi_kling-0.2.2}/src/runapi/kling/resources/image_to_video.py RENAMED Viewed

@@ -11,6 +11,7 @@ from ..types import (
     CompletedImageToVideoResponse,
     ImageToVideoResponse,
 )
+from .o1_reference_validation import O1_MODEL, validate_kling_o1_references
 V26_MODEL = "kling-v2.6"
 V3_OMNI_MODEL = "kling-v3-omni"
@@ -70,6 +71,7 @@ class ImageToVideo(Resource):
     def _validate_params(self, params: Dict[str, Any]) -> None:
         self._reject_unsupported_v3_turbo_fields(params)
         self._validate_contract(CONTRACT["image-to-video"], params)
+        validate_kling_o1_references(params)
         # Bespoke last-frame rules that the generated contract cannot express.
         model = params.get("model")
@@ -82,6 +84,7 @@ class ImageToVideo(Resource):
                     f"last_frame_image_url requires duration_seconds 5 for {V3_OMNI_MODEL}"
                 )
         elif last_frame_image_url and model not in (
+            O1_MODEL,
             "kling-v2.5-turbo-image-to-video-pro",
             "kling-v2.1-pro",
         ):

runapi_kling-0.2.2/src/runapi/kling/resources/o1_reference_validation.py ADDED Viewed

@@ -0,0 +1,178 @@
+"""Cross-field validation shared by Kling O1 video resources."""
+from __future__ import annotations
+import ipaddress
+import re
+from pathlib import PurePosixPath
+from typing import Any, Dict
+from urllib.parse import urlparse
+from runapi.core import ValidationError
+O1_MODEL = "kling-o1"
+IMAGE_EXTENSIONS = {".jpg", ".jpeg", ".png"}
+VIDEO_EXTENSIONS = {".mp4", ".mov"}
+NONCANONICAL_IPV4_LITERAL = re.compile(
+    r"(?:0x[0-9a-f]+|\d+)(?:\.(?:0x[0-9a-f]+|\d+)){0,3}",
+    re.IGNORECASE,
+)
+BLOCKED_IP_NETWORKS = tuple(
+    ipaddress.ip_network(cidr)
+    for cidr in (
+        "0.0.0.0/8",
+        "10.0.0.0/8",
+        "100.64.0.0/10",
+        "127.0.0.0/8",
+        "169.254.0.0/16",
+        "172.16.0.0/12",
+        "192.0.0.0/24",
+        "192.0.2.0/24",
+        "192.88.99.0/24",
+        "192.168.0.0/16",
+        "198.18.0.0/15",
+        "198.51.100.0/24",
+        "203.0.113.0/24",
+        "224.0.0.0/4",
+        "240.0.0.0/4",
+        "255.255.255.255/32",
+        "::/128",
+        "::1/128",
+        "64:ff9b::/96",
+        "64:ff9b:1::/48",
+        "100::/64",
+        "2001::/32",
+        "2001:2::/48",
+        "2001:db8::/32",
+        "2002::/16",
+        "3fff::/20",
+        "fc00::/7",
+        "fe80::/10",
+        "ff00::/8",
+    )
+)
+def validate_kling_o1_references(params: Dict[str, Any]) -> None:
+    if params.get("model") != O1_MODEL:
+        return
+    if params.get("enable_sound") is True:
+        raise ValidationError(f"enable_sound is not supported by {O1_MODEL}")
+    for field in ("first_frame_image_url", "last_frame_image_url"):
+        value = params.get(field)
+        if value and not _is_public_http_url(value):
+            raise ValidationError(f"{field} must be a public HTTP or HTTPS URL")
+        if value and _url_extension(value) not in IMAGE_EXTENSIONS:
+            raise ValidationError(f"{field} must use a JPG, JPEG, or PNG URL")
+    prompt = params.get("prompt")
+    if not isinstance(prompt, str):
+        raise ValidationError("prompt must be a string")
+    reference_images = params.get("reference_image_urls") or []
+    reference_video_url = params.get("reference_video_url")
+    if reference_video_url is not None and not isinstance(reference_video_url, str):
+        raise ValidationError("reference_video_url must be a string")
+    if params.get("last_frame_image_url") and (
+        reference_images or reference_video_url
+    ):
+        raise ValidationError(
+            "last_frame_image_url cannot be combined with "
+            "reference_image_urls or reference_video_url"
+        )
+    if reference_video_url and len(reference_images) > 4:
+        raise ValidationError(
+            "reference_image_urls must contain at most 4 items when "
+            "reference_video_url is present"
+        )
+    for index, image_url in enumerate(reference_images):
+        if not isinstance(image_url, str):
+            raise ValidationError(
+                f"reference_image_urls[{index}] must be a string"
+            )
+        if not _is_public_http_url(image_url):
+            raise ValidationError(
+                f"reference_image_urls[{index}] must be a public HTTP or HTTPS URL"
+            )
+        if _url_extension(image_url) not in IMAGE_EXTENSIONS:
+            raise ValidationError(
+                f"reference_image_urls[{index}] must use a JPG, JPEG, or PNG URL"
+            )
+        marker = f"<<<image_{index + 1}>>>"
+        if marker not in prompt:
+            raise ValidationError(
+                f"prompt must reference reference_image_urls[{index}] as {marker}"
+            )
+    for marker_index in re.findall(r"<<<image_(\d+)>>>", prompt):
+        index = int(marker_index)
+        if index < 1 or index > len(reference_images):
+            raise ValidationError(f"prompt references missing image_{index}")
+    if not reference_video_url:
+        if "reference_video_type" in params:
+            raise ValidationError("reference_video_type requires reference_video_url")
+        if "preserve_reference_video_audio" in params:
+            raise ValidationError(
+                "preserve_reference_video_audio requires reference_video_url"
+            )
+        missing_marker = re.search(r"<<<video_([^>]+)>>>", prompt)
+        if missing_marker:
+            raise ValidationError(
+                f"prompt references missing video_{missing_marker.group(1)}"
+            )
+        return
+    if not _is_public_http_url(reference_video_url):
+        raise ValidationError(
+            "reference_video_url must be a public HTTP or HTTPS URL"
+        )
+    if _url_extension(reference_video_url) not in VIDEO_EXTENSIONS:
+        raise ValidationError("reference_video_url must use an MP4 or MOV URL")
+    if "<<<video_1>>>" not in prompt:
+        raise ValidationError(
+            "prompt must reference reference_video_url as <<<video_1>>>"
+        )
+    if any(index != "1" for index in re.findall(r"<<<video_([^>]+)>>>", prompt)):
+        raise ValidationError("prompt may only reference video_1")
+    reference_video_type = params.get("reference_video_type") or "base"
+    if reference_video_type == "base" and (
+        params.get("first_frame_image_url") or params.get("last_frame_image_url")
+    ):
+        raise ValidationError(
+            "reference_video_type base cannot be combined with "
+            "first_frame_image_url or last_frame_image_url"
+        )
+def _url_extension(value: str) -> str:
+    return PurePosixPath(urlparse(str(value)).path).suffix.lower()
+def _is_public_http_url(value: str) -> bool:
+    try:
+        parsed = urlparse(value)
+        return (
+            parsed.scheme.lower() in {"http", "https"}
+            and bool(parsed.hostname)
+            and parsed.username is None
+            and parsed.password is None
+            and not _is_blocked_host(parsed.hostname)
+        )
+    except (TypeError, ValueError):
+        return False
+def _is_blocked_host(hostname: str) -> bool:
+    host = hostname.lower().rstrip(".")
+    if host == "localhost" or host.endswith(".localhost"):
+        return True
+    try:
+        address = ipaddress.ip_address(host)
+    except ValueError:
+        return NONCANONICAL_IPV4_LITERAL.fullmatch(host) is not None
+    if isinstance(address, ipaddress.IPv6Address) and address.ipv4_mapped:
+        address = address.ipv4_mapped
+    return any(address in network for network in BLOCKED_IP_NETWORKS)

{runapi_kling-0.2.0 → runapi_kling-0.2.2}/src/runapi/kling/resources/text_to_video.py RENAMED Viewed

@@ -13,6 +13,7 @@ from ..types import (
     CompletedTextToVideoResponse,
     TextToVideoResponse,
 )
+from .o1_reference_validation import validate_kling_o1_references
 V26_MODEL = "kling-v2.6"
 V3_TURBO_MODEL = "kling-v3-turbo-text-to-video"
@@ -76,6 +77,7 @@ class TextToVideo(Resource):
         self._reject_unsupported_v3_turbo_fields(params)
         self._validate_contract(CONTRACT["text-to-video"], params)
         self._validate_v26_params(params)
+        validate_kling_o1_references(params)
         # Bespoke cross-field rules the contract cannot express.
         multi_shots = params.get("multi_shots") is True

{runapi_kling-0.2.0 → runapi_kling-0.2.2}/tests/test_client.py RENAMED Viewed

@@ -410,6 +410,57 @@ def test_text_to_video_v26_rejects_sound_outside_pro_mode():
     assert fake.calls == []
+def test_text_to_video_o1_posts_reference_fields():
+    fake = FakeHttp({"id": "t1", "status": "pending"})
+    client = KlingClient(api_key="k", http_client=fake)
+    client.text_to_video.create(
+        model="kling-o1",
+        prompt="Keep <<<image_1>>> beside <<<video_1>>>",
+        reference_image_urls=["https://cdn.runapi.ai/public/samples/portrait.jpg"],
+        reference_video_url="https://cdn.runapi.ai/public/samples/video.mp4",
+        reference_video_type="feature",
+        preserve_reference_video_audio=True,
+        duration_seconds=5,
+    )
+    assert fake.calls == [
+        (
+            "post",
+            "/api/v1/kling/text_to_video",
+            {
+                "model": "kling-o1",
+                "prompt": "Keep <<<image_1>>> beside <<<video_1>>>",
+                "reference_image_urls": [
+                    "https://cdn.runapi.ai/public/samples/portrait.jpg"
+                ],
+                "reference_video_url": "https://cdn.runapi.ai/public/samples/video.mp4",
+                "reference_video_type": "feature",
+                "preserve_reference_video_audio": True,
+                "duration_seconds": 5,
+            },
+        )
+    ]
+def test_text_to_video_o1_rejects_reference_without_prompt_marker():
+    fake = FakeHttp()
+    client = KlingClient(api_key="k", http_client=fake)
+    with pytest.raises(
+        ValidationError,
+        match=r"prompt must reference reference_image_urls\[0\] as <<<image_1>>>",
+    ):
+        client.text_to_video.create(
+            model="kling-o1",
+            prompt="Keep the same subject",
+            reference_image_urls=[
+                "https://cdn.runapi.ai/public/samples/portrait.jpg"
+            ],
+        )
+    assert fake.calls == []
 # --- ai_avatar ------------------------------------------------------------
@@ -756,6 +807,83 @@ def test_image_to_video_v3_omni_rejects_final_frame_outside_five_seconds():
             last_frame_image_url="https://cdn.runapi.ai/public/samples/image.jpg",
             duration_seconds=7,
         )
+def test_image_to_video_o1_rejects_base_video_with_frame_input():
+    fake = FakeHttp()
+    client = KlingClient(api_key="k", http_client=fake)
+    with pytest.raises(
+        ValidationError,
+        match="reference_video_type base cannot be combined with first_frame_image_url or last_frame_image_url",
+    ):
+        client.image_to_video.create(
+            model="kling-o1",
+            prompt="Use <<<video_1>>> as the base",
+            first_frame_image_url="https://cdn.runapi.ai/public/samples/image-to-video.jpg",
+            reference_video_url="https://cdn.runapi.ai/public/samples/video.mp4",
+            reference_video_type="base",
+        )
+    assert fake.calls == []
+def test_image_to_video_o1_rejects_tail_frame_with_reference_media():
+    fake = FakeHttp()
+    client = KlingClient(api_key="k", http_client=fake)
+    with pytest.raises(
+        ValidationError,
+        match="last_frame_image_url cannot be combined with reference_image_urls or reference_video_url",
+    ):
+        client.image_to_video.create(
+            model="kling-o1",
+            prompt="Move toward <<<image_1>>>",
+            first_frame_image_url="https://cdn.runapi.ai/public/samples/image-to-video.jpg",
+            last_frame_image_url="https://cdn.runapi.ai/public/samples/last-frame.jpg",
+            reference_image_urls=["https://cdn.runapi.ai/public/samples/portrait.jpg"],
+        )
+    assert fake.calls == []
+def test_text_to_video_o1_rejects_missing_video_reference():
+    fake = FakeHttp()
+    client = KlingClient(api_key="k", http_client=fake)
+    with pytest.raises(ValidationError, match="prompt references missing video_1"):
+        client.text_to_video.create(
+            model="kling-o1",
+            prompt="Follow <<<video_1>>>",
+        )
+    assert fake.calls == []
+@pytest.mark.parametrize(
+    "reference_url",
+    [
+        "file:///etc/passwd.jpg",
+        "http://localhost/reference.jpg",
+        "http://127.0.0.1/reference.jpg",
+        "http://169.254.169.254/reference.jpg",
+        "http://[::ffff:127.0.0.1]/reference.jpg",
+        "http://2130706433/reference.jpg",
+        "http://127.1/reference.jpg",
+        "http://0177.0.0.1/reference.jpg",
+        "http://0x7f000001/reference.jpg",
+    ],
+)
+def test_text_to_video_o1_rejects_non_public_reference_media(reference_url):
+    fake = FakeHttp()
+    client = KlingClient(api_key="k", http_client=fake)
+    with pytest.raises(
+        ValidationError,
+        match=r"reference_image_urls\[0\] must be a public HTTP or HTTPS URL",
+    ):
+        client.text_to_video.create(
+            model="kling-o1",
+            prompt="Use <<<image_1>>>",
+            reference_image_urls=[reference_url],
+        )
     assert fake.calls == []

{runapi_kling-0.2.0 → runapi_kling-0.2.2}/src/runapi/kling/__init__.py RENAMED Viewed

File without changes

{runapi_kling-0.2.0 → runapi_kling-0.2.2}/src/runapi/kling/client.py RENAMED Viewed

File without changes

{runapi_kling-0.2.0 → runapi_kling-0.2.2}/src/runapi/kling/py.typed RENAMED Viewed

File without changes

{runapi_kling-0.2.0 → runapi_kling-0.2.2}/src/runapi/kling/resources/__init__.py RENAMED Viewed

File without changes

{runapi_kling-0.2.0 → runapi_kling-0.2.2}/src/runapi/kling/resources/ai_avatar.py RENAMED Viewed

File without changes

{runapi_kling-0.2.0 → runapi_kling-0.2.2}/src/runapi/kling/resources/extend_video.py RENAMED Viewed

File without changes

{runapi_kling-0.2.0 → runapi_kling-0.2.2}/src/runapi/kling/resources/motion_control.py RENAMED Viewed

File without changes

{runapi_kling-0.2.0 → runapi_kling-0.2.2}/src/runapi/kling/types.py RENAMED Viewed

File without changes

runapi-kling 0.2.0__tar.gz → 0.2.2__tar.gz

runapi-kling 0.2.0tar.gz → 0.2.2tar.gz