runapi-kling 0.3.4__tar.gz → 0.4.0__tar.gz

{runapi_kling-0.3.4 → runapi_kling-0.4.0}/PKG-INFO

@@ -1,18 +1,18 @@
 Metadata-Version: 2.5
 Name: runapi-kling
-Version: 0.3.4
+Version: 0.4.0
 Summary: RunAPI Kling SDK for text-to-video, image-to-video, source-video editing, 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/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.3.4
+Project-URL: Release Notes, https://github.com/runapi-ai/kling-sdk/releases/tag/python%2Fv0.4.0
 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.8.2
+Requires-Dist: runapi-core>=0.9.1
 Description-Content-Type: text/markdown
 
 # Kling API Python SDK for RunAPI

{runapi_kling-0.3.4 → runapi_kling-0.4.0}/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "hatchling.build"
 
 [project]
 name = "runapi-kling"
-version = "0.3.4"
+version = "0.4.0"
 description = "RunAPI Kling SDK for text-to-video, image-to-video, source-video editing, 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.8.2"]
+dependencies = ["runapi-core>=0.9.1"]
 
 [project.urls]
 Homepage = "https://runapi.ai/models/kling"
@@ -19,7 +19,7 @@ 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.3.4"
+"Release Notes" = "https://github.com/runapi-ai/kling-sdk/releases/tag/python%2Fv0.4.0"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/runapi"]

{runapi_kling-0.3.4 → runapi_kling-0.4.0}/src/runapi/kling/contract_gen.py

@@ -500,11 +500,29 @@ CONTRACT = {
                 "model": "kling-v2.5-turbo-image-to-video-pro"
             },
             "forbidden": ["output_resolution", "enable_sound", "reference_image_urls", "reference_video_url", "reference_video_type", "preserve_reference_video_audio"]
+        }, {
+            "enum": {
+                "enable_sound": [False]
+            },
+            "when": {
+                "mode": "std",
+                "model": "kling-v2.6"
+            }
         }, {
             "when": {
                 "model": "kling-v2.6"
             },
             "forbidden": ["output_resolution", "negative_prompt", "cfg_scale", "reference_image_urls", "reference_video_url", "reference_video_type", "preserve_reference_video_audio"]
+        }, {
+            "enum": {
+                "enable_sound": [False]
+            },
+            "when": {
+                "mode": {
+                    "present": False
+                },
+                "model": "kling-v2.6"
+            }
         }, {
             "when": {
                 "model": "kling-v3-omni"
@@ -531,7 +549,8 @@ CONTRACT = {
                     "required": True
                 },
                 "output_resolution": {
-                    "enum": ["720p", "1080p"]
+                    "enum": ["720p", "1080p"],
+                    "required": True
                 },
                 "reference_video_url": {
                     "required": True
@@ -757,6 +776,24 @@ CONTRACT = {
                 "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", "reference_image_urls", "reference_video_url", "reference_video_type", "preserve_reference_video_audio"]
+        }, {
+            "enum": {
+                "enable_sound": [False]
+            },
+            "when": {
+                "mode": "std",
+                "model": "kling-v2.6"
+            }
+        }, {
+            "enum": {
+                "enable_sound": [False]
+            },
+            "when": {
+                "mode": {
+                    "present": False
+                },
+                "model": "kling-v2.6"
+            }
         }, {
             "when": {
                 "model": "kling-v3-omni"

{runapi_kling-0.3.4 → runapi_kling-0.4.0}/src/runapi/kling/resources/image_to_video.py

@@ -96,12 +96,9 @@ class ImageToVideo(Resource):
     def _validate_v26_params(
         self, params: Dict[str, Any], last_frame_image_url: Any
     ) -> None:
-        mode = params.get("mode") or "std"
-        if params.get("enable_sound") is True and mode != "pro":
-            raise ValidationError(f"enable_sound requires mode pro for {V26_MODEL}")
         if not last_frame_image_url:
             return
-        if mode != "pro":
+        if (params.get("mode") or "std") != "pro":
             raise ValidationError(f"last_frame_image_url requires mode pro for {V26_MODEL}")
         if params.get("duration_seconds", 5) != 5:
             raise ValidationError(

{runapi_kling-0.3.4 → runapi_kling-0.4.0}/src/runapi/kling/resources/text_to_video.py

@@ -15,7 +15,6 @@ from ..types import (
 )
 from .o1_reference_validation import validate_kling_o1_references
 
-V26_MODEL = "kling-v2.6"
 V3_TURBO_MODEL = "kling-v3-turbo-text-to-video"
 V3_TURBO_UNSUPPORTED_FIELDS = (
     "enable_sound",
@@ -76,7 +75,6 @@ class TextToVideo(Resource):
     def _validate_params(self, params: Dict[str, Any]) -> None:
         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.
@@ -93,14 +91,6 @@ class TextToVideo(Resource):
             if not params.get("prompt"):
                 raise ValidationError("prompt is required")
 
-    def _validate_v26_params(self, params: Dict[str, Any]) -> None:
-        if (
-            params.get("model") == V26_MODEL
-            and params.get("enable_sound") is True
-            and params.get("mode") != "pro"
-        ):
-            raise ValidationError(f"enable_sound requires mode pro for {V26_MODEL}")
-
     def _reject_unsupported_v3_turbo_fields(self, params: Dict[str, Any]) -> None:
         if params.get("model") != V3_TURBO_MODEL:
             return

{runapi_kling-0.3.4 → runapi_kling-0.4.0}/tests/test_client.py

@@ -97,8 +97,7 @@ def test_text_to_video_create_posts_compacted_body():
             "post",
             "/api/v1/kling/text_to_video",
             {"model": "kling-3.0", "prompt": "a cat in a garden", "aspect_ratio": "16:9"},
-        ),
-    ]
+        )]
     assert isinstance(result, TextToVideoResponse)
 
 
@@ -114,18 +113,14 @@ def test_text_to_video_create_posts_element_audio_and_time_fields():
                 "description": "dog",
                 "element_input_urls": [
                     "https://upload.wikimedia.org/wikipedia/commons/6/6e/Golde33443.jpg",
-                    "https://upload.wikimedia.org/wikipedia/commons/9/9a/Pug_600.jpg",
-                ],
-                "element_input_audio_urls": ["https://cdn.runapi.ai/public/samples/music.mp3"],
-            },
+                    "https://upload.wikimedia.org/wikipedia/commons/9/9a/Pug_600.jpg"],
+                "element_input_audio_urls": ["https://cdn.runapi.ai/public/samples/music.mp3"]},
             {
                 "name": "element_run",
                 "description": "running dog",
                 "element_input_urls": ["https://cdn.runapi.ai/public/samples/video.mp4"],
                 "start_time": 1000,
-                "end_time": 6000,
-            },
-        ],
+                "end_time": 6000}],
     )
     assert fake.calls == [
         (
@@ -140,12 +135,10 @@ def test_text_to_video_create_posts_element_audio_and_time_fields():
                         "description": "dog",
                         "element_input_urls": [
                             "https://upload.wikimedia.org/wikipedia/commons/6/6e/Golde33443.jpg",
-                            "https://upload.wikimedia.org/wikipedia/commons/9/9a/Pug_600.jpg",
-                        ],
+                            "https://upload.wikimedia.org/wikipedia/commons/9/9a/Pug_600.jpg"],
                         "element_input_audio_urls": [
                             "https://cdn.runapi.ai/public/samples/music.mp3"
-                        ],
-                    },
+                        ]},
                     {
                         "name": "element_run",
                         "description": "running dog",
@@ -153,12 +146,8 @@ def test_text_to_video_create_posts_element_audio_and_time_fields():
                             "https://cdn.runapi.ai/public/samples/video.mp4"
                         ],
                         "start_time": 1000,
-                        "end_time": 6000,
-                    },
-                ],
-            },
-        ),
-    ]
+                        "end_time": 6000}]},
+        )]
     assert isinstance(result, TextToVideoResponse)
 
 
@@ -172,7 +161,7 @@ def test_text_to_video_get_fetches_by_id():
 def test_text_to_video_run_narrows_completed_type():
     fake = FakeHttp(
         {"id": "t1", "status": "pending"},
-        {"id": "t1", "status": "completed", "videos": [{"url": "https://x/y.mp4"}]},
+        {"id": "t1", "status": "completed", "usage": {"cost": 0.05}, "videos": [{"url": "https://x/y.mp4"}]},
     )
     client = KlingClient(api_key="k", http_client=fake)
     result = client.text_to_video.run(model="kling-3.0", prompt="a serene forest")
@@ -322,10 +311,8 @@ def test_text_to_video_v3_turbo_posts_body():
                 "prompt": "a silver train crossing a moonlit bridge",
                 "duration_seconds": 7,
                 "aspect_ratio": "16:9",
-                "output_resolution": "1080p",
-            },
-        ),
-    ]
+                "output_resolution": "1080p"},
+        )]
 
 
 def test_text_to_video_v3_turbo_rejects_unsupported_fields():
@@ -365,8 +352,7 @@ def test_text_to_video_v26_posts_mode_and_sound_fields():
                 "mode": "pro",
                 "duration_seconds": 10,
                 "enable_sound": True,
-                "aspect_ratio": "16:9",
-            },
+                "aspect_ratio": "16:9"},
         )
     ]
 
@@ -394,8 +380,7 @@ def test_text_to_video_v3_omni_posts_resolution_and_sound_fields():
                 "output_resolution": "1080p",
                 "duration_seconds": 10,
                 "enable_sound": True,
-                "aspect_ratio": "16:9",
-            },
+                "aspect_ratio": "16:9"},
         )
     ]
 
@@ -405,11 +390,18 @@ def test_text_to_video_v26_rejects_sound_outside_pro_mode():
     client = KlingClient(api_key="k", http_client=fake)
 
     with pytest.raises(
-        ValidationError, match="enable_sound requires mode pro for kling-v2.6"
+        ValidationError, match="enable_sound must be one of: false when .*model is kling-v2.6"
     ):
         client.text_to_video.create(
             model="kling-v2.6", prompt="test", enable_sound=True
         )
+    with pytest.raises(
+        ValidationError,
+        match="enable_sound must be one of: false when mode is std and model is kling-v2.6",
+    ):
+        client.text_to_video.create(
+            model="kling-v2.6", prompt="test", mode="std", enable_sound=True
+        )
     assert fake.calls == []
 
 
@@ -440,8 +432,7 @@ def test_text_to_video_o1_posts_reference_fields():
                 "reference_video_url": "https://cdn.runapi.ai/public/samples/video.mp4",
                 "reference_video_type": "feature",
                 "preserve_reference_video_audio": True,
-                "duration_seconds": 5,
-            },
+                "duration_seconds": 5},
         )
     ]
 
@@ -484,10 +475,8 @@ def test_ai_avatar_create_posts_body():
                 "model": "kling-ai-avatar-pro",
                 "prompt": "a host greeting",
                 "source_image_url": "https://x/p.jpg",
-                "source_audio_url": "https://x/a.mp3",
-            },
-        ),
-    ]
+                "source_audio_url": "https://x/a.mp3"},
+        )]
     assert isinstance(result, AiAvatarResponse)
 
 
@@ -501,7 +490,7 @@ def test_ai_avatar_get_fetches_by_id():
 def test_ai_avatar_run_narrows_completed_type():
     fake = FakeHttp(
         {"id": "t1", "status": "pending"},
-        {"id": "t1", "status": "completed", "videos": [{"url": "https://x/a.mp4"}]},
+        {"id": "t1", "status": "completed", "usage": {"cost": 0.05}, "videos": [{"url": "https://x/a.mp4"}]},
     )
     client = KlingClient(api_key="k", http_client=fake)
     result = client.ai_avatar.run(
@@ -568,10 +557,8 @@ def test_image_to_video_create_posts_body():
             {
                 "model": "kling-v2.1-pro",
                 "prompt": "zoom out slowly",
-                "first_frame_image_url": "https://x/f.jpg",
-            },
-        ),
-    ]
+                "first_frame_image_url": "https://x/f.jpg"},
+        )]
     assert isinstance(result, ImageToVideoResponse)
 
 
@@ -585,7 +572,7 @@ def test_image_to_video_get_fetches_by_id():
 def test_image_to_video_run_narrows_completed_type():
     fake = FakeHttp(
         {"id": "t1", "status": "pending"},
-        {"id": "t1", "status": "completed", "videos": [{"url": "https://x/i.mp4"}]},
+        {"id": "t1", "status": "completed", "usage": {"cost": 0.05}, "videos": [{"url": "https://x/i.mp4"}]},
     )
     client = KlingClient(api_key="k", http_client=fake)
     result = client.image_to_video.run(
@@ -671,10 +658,8 @@ def test_image_to_video_v3_turbo_posts_body():
                 "prompt": "camera glides toward the lighthouse",
                 "first_frame_image_url": "https://x/lighthouse.jpg",
                 "duration_seconds": 7,
-                "output_resolution": "720p",
-            },
-        ),
-    ]
+                "output_resolution": "720p"},
+        )]
 
 
 def test_image_to_video_v3_turbo_rejects_unsupported_fields():
@@ -719,8 +704,7 @@ def test_image_to_video_v26_posts_mode_sound_and_final_frame_fields():
                 "mode": "pro",
                 "duration_seconds": 5,
                 "enable_sound": True,
-                "aspect_ratio": "16:9",
-            },
+                "aspect_ratio": "16:9"},
         )
     ]
 
@@ -752,8 +736,7 @@ def test_image_to_video_v3_omni_posts_resolution_sound_and_final_frame_fields():
                 "output_resolution": "4k",
                 "duration_seconds": 5,
                 "enable_sound": False,
-                "aspect_ratio": "9:16",
-            },
+                "aspect_ratio": "9:16"},
         )
     ]
 
@@ -762,12 +745,23 @@ def test_image_to_video_v26_rejects_sound_outside_pro_mode():
     client = KlingClient(api_key="k", http_client=FakeHttp())
 
     with pytest.raises(
-        ValidationError, match="enable_sound requires mode pro for kling-v2.6"
+        ValidationError, match="enable_sound must be one of: false when .*model is kling-v2.6"
+    ):
+        client.image_to_video.create(
+            model="kling-v2.6",
+            prompt="test",
+            first_frame_image_url="https://x/first.jpg",
+            enable_sound=True,
+        )
+    with pytest.raises(
+        ValidationError,
+        match="enable_sound must be one of: false when mode is std and model is kling-v2.6",
     ):
         client.image_to_video.create(
             model="kling-v2.6",
             prompt="test",
             first_frame_image_url="https://x/first.jpg",
+            mode="std",
             enable_sound=True,
         )
 
@@ -779,8 +773,7 @@ def test_image_to_video_v26_rejects_sound_outside_pro_mode():
         (
             {"mode": "pro", "duration_seconds": 10},
             "last_frame_image_url requires duration_seconds 5 for kling-v2.6",
-        ),
-    ],
+        )],
 )
 def test_image_to_video_v26_rejects_invalid_final_frame_combinations(extra, message):
     client = KlingClient(api_key="k", http_client=FakeHttp())
@@ -871,8 +864,7 @@ def test_text_to_video_o1_rejects_missing_video_reference():
         "http://2130706433/reference.jpg",
         "http://127.1/reference.jpg",
         "http://0177.0.0.1/reference.jpg",
-        "http://0x7f000001/reference.jpg",
-    ],
+        "http://0x7f000001/reference.jpg"],
 )
 def test_text_to_video_o1_rejects_non_public_reference_media(reference_url):
     fake = FakeHttp()
@@ -900,6 +892,7 @@ def test_motion_control_create_posts_body():
         model="kling-3.0",
         source_image_url="https://x/s.jpg",
         reference_video_url="https://x/r.mp4",
+        output_resolution="720p",
     )
     assert fake.calls == [
         (
@@ -909,12 +902,23 @@ def test_motion_control_create_posts_body():
                 "model": "kling-3.0",
                 "source_image_url": "https://x/s.jpg",
                 "reference_video_url": "https://x/r.mp4",
-            },
-        ),
-    ]
+                "output_resolution": "720p"},
+        )]
     assert isinstance(result, MotionControlResponse)
 
 
+def test_motion_control_kling_3_requires_output_resolution():
+    fake = FakeHttp()
+    client = KlingClient(api_key="k", http_client=fake)
+    with pytest.raises(ValidationError, match="output_resolution is required"):
+        client.motion_control.create(
+            model="kling-3.0",
+            source_image_url="https://x/s.jpg",
+            reference_video_url="https://x/r.mp4",
+        )
+    assert fake.calls == []
+
+
 def test_motion_control_create_posts_v26_body():
     fake = FakeHttp({"id": "t26", "status": "pending"})
     client = KlingClient(api_key="k", http_client=fake)
@@ -934,8 +938,7 @@ def test_motion_control_create_posts_v26_body():
     ("missing", "message"),
     [
         ("output_resolution", "output_resolution is required"),
-        ("character_orientation", "character_orientation is required"),
-    ],
+        ("character_orientation", "character_orientation is required")],
 )
 def test_motion_control_v26_requires_model_fields(missing, message):
     fake = FakeHttp()
@@ -945,8 +948,7 @@ def test_motion_control_v26_requires_model_fields(missing, message):
         "source_image_url": "https://x/s.jpg",
         "reference_video_url": "https://x/r.mp4",
         "output_resolution": "720p",
-        "character_orientation": "video",
-    }
+        "character_orientation": "video"}
     del params[missing]
 
     with pytest.raises(ValidationError, match=message):
@@ -982,13 +984,14 @@ def test_motion_control_get_fetches_by_id():
 def test_motion_control_run_narrows_completed_type():
     fake = FakeHttp(
         {"id": "t1", "status": "pending"},
-        {"id": "t1", "status": "completed", "videos": [{"url": "https://x/m.mp4"}]},
+        {"id": "t1", "status": "completed", "usage": {"cost": 0.05}, "videos": [{"url": "https://x/m.mp4"}]},
     )
     client = KlingClient(api_key="k", http_client=fake)
     result = client.motion_control.run(
         model="kling-3.0",
         source_image_url="https://x/s.jpg",
         reference_video_url="https://x/r.mp4",
+        output_resolution="720p",
     )
     assert isinstance(result, CompletedMotionControlResponse)
     assert result.videos[0].url == "https://x/m.mp4"
@@ -1022,14 +1025,16 @@ def test_motion_control_requires_source_image_url():
     client = KlingClient(api_key="k", http_client=FakeHttp())
     with pytest.raises(ValidationError, match="source_image_url is required"):
         client.motion_control.create(
-            model="kling-3.0", reference_video_url="https://x/r.mp4"
+            model="kling-3.0", reference_video_url="https://x/r.mp4", output_resolution="720p"
         )
 
 
 def test_motion_control_requires_reference_video_url():
     client = KlingClient(api_key="k", http_client=FakeHttp())
     with pytest.raises(ValidationError, match="reference_video_url is required"):
-        client.motion_control.create(model="kling-3.0", source_image_url="https://x/s.jpg")
+        client.motion_control.create(
+            model="kling-3.0", source_image_url="https://x/s.jpg", output_resolution="720p"
+        )
 
 
 def test_text_to_video_non_numeric_duration_raises_validation_error():
@@ -1058,8 +1063,7 @@ def test_text_to_video_accepts_reference_image_model():
         "model": "kling-v3-omni-reference",
         "prompt": "Keep the subject from the reference image",
         "reference_image_urls": ["https://cdn.runapi.ai/public/samples/image.jpg"],
-        "aspect_ratio": "16:9",
-    }
+        "aspect_ratio": "16:9"}
 
     client.text_to_video.create(**params)
     assert fake.calls == [("post", "/api/v1/kling/text_to_video", params)]
@@ -1070,15 +1074,14 @@ def test_edit_video_create_get_and_run_for_edit_model():
         {"id": "edit-create", "status": "processing"},
         {"id": "edit-get", "status": "processing"},
         {"id": "edit-run", "status": "processing"},
-        {"id": "edit-run", "status": "completed", "videos": [{"url": "https://file.runapi.ai/edit.mp4"}]},
+        {"id": "edit-run", "status": "completed", "usage": {"cost": 0.05}, "videos": [{"url": "https://file.runapi.ai/edit.mp4"}]},
     )
     client = KlingClient(api_key="k", http_client=fake)
     params = {
         "model": "kling-v3-omni-edit",
         "prompt": "Turn the source video into a watercolor scene",
         "source_video_url": "https://cdn.runapi.ai/public/samples/video.mp4",
-        "aspect_ratio": "auto",
-    }
+        "aspect_ratio": "auto"}
 
     client.edit_video.create(**params)
     client.edit_video.get("edit-get")
@@ -1088,8 +1091,7 @@ def test_edit_video_create_get_and_run_for_edit_model():
         ("post", "/api/v1/kling/edit_video", params),
         ("get", "/api/v1/kling/edit_video/edit-get", None),
         ("post", "/api/v1/kling/edit_video", params),
-        ("get", "/api/v1/kling/edit_video/edit-run", None),
-    ]
+        ("get", "/api/v1/kling/edit_video/edit-run", None)]
     assert result.status == "completed"
 
 
@@ -1102,8 +1104,7 @@ def test_edit_video_accepts_reference_model_and_requires_model():
         "source_video_url": "https://cdn.runapi.ai/public/samples/video.mp4",
         "reference_image_urls": ["https://cdn.runapi.ai/public/samples/image.jpg"],
         "aspect_ratio": "16:9",
-        "enable_sound": False,
-    }
+        "enable_sound": False}
 
     client.edit_video.create(**params)
     assert fake.calls == [("post", "/api/v1/kling/edit_video", params)]