runapi-core 0.3.5__tar.gz → 0.4.0__tar.gz

{runapi_core-0.3.5 → runapi_core-0.4.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: runapi-core
-Version: 0.3.5
+Version: 0.4.0
 Summary: RunAPI core SDK for JavaScript, Python, Ruby, Go, Java, and PHP
 Project-URL: Homepage, https://runapi.ai/models
 Project-URL: Documentation, https://runapi.ai/docs/resources/sdks
 Project-URL: Source, https://github.com/runapi-ai/core-sdk
 Project-URL: Issues, https://github.com/runapi-ai/core-sdk/issues
 Project-URL: Changelog, https://github.com/runapi-ai/core-sdk/blob/main/CHANGELOG.md
-Project-URL: Release Notes, https://github.com/runapi-ai/core-sdk/releases/tag/python%2Fv0.3.5
+Project-URL: Release Notes, https://github.com/runapi-ai/core-sdk/releases/tag/python%2Fv0.4.0
 Author-email: RunAPI <contact@runapi.ai>
 License-Expression: Apache-2.0
 Keywords: api,core,golang,gradle,java,maven,pypi,python,ruby,runapi,runapi-ai,sdk,typescript

{runapi_core-0.3.5 → runapi_core-0.4.0}/pyproject.toml

@@ -19,7 +19,7 @@ Documentation = "https://runapi.ai/docs/resources/sdks"
 Source = "https://github.com/runapi-ai/core-sdk"
 Issues = "https://github.com/runapi-ai/core-sdk/issues"
 Changelog = "https://github.com/runapi-ai/core-sdk/blob/main/CHANGELOG.md"
-"Release Notes" = "https://github.com/runapi-ai/core-sdk/releases/tag/python%2Fv0.3.5"
+"Release Notes" = "https://github.com/runapi-ai/core-sdk/releases/tag/python%2Fv0.4.0"
 
 [tool.hatch.version]
 path = "src/runapi/core/version.py"

{runapi_core-0.3.5 → runapi_core-0.4.0}/src/runapi/core/contract_gen.py

@@ -39,10 +39,41 @@ CONTRACT = {
         }
     },
     "fish-audio/text-to-speech": {
-        "models": ["s1", "s2-pro"],
+        "models": ["s1", "s2-pro", "s2.1-pro"],
         "fields_by_model": {
-            "s1": {},
-            "s2-pro": {}
+            "s1": {
+                "bitrate_kbps": {
+                    "enum": [64, 128, 192]
+                },
+                "output_format": {
+                    "enum": ["mp3", "wav"]
+                },
+                "sample_rate_hz": {
+                    "enum": [8000, 16000, 24000, 32000, 44100]
+                }
+            },
+            "s2-pro": {
+                "bitrate_kbps": {
+                    "enum": [64, 128, 192]
+                },
+                "output_format": {
+                    "enum": ["mp3", "wav"]
+                },
+                "sample_rate_hz": {
+                    "enum": [8000, 16000, 24000, 32000, 44100]
+                }
+            },
+            "s2.1-pro": {
+                "bitrate_kbps": {
+                    "enum": [64, 128, 192]
+                },
+                "output_format": {
+                    "enum": ["mp3", "wav"]
+                },
+                "sample_rate_hz": {
+                    "enum": [8000, 16000, 24000, 32000, 44100]
+                }
+            }
         }
     },
     "flux-2/remix-image": {
@@ -331,7 +362,7 @@ CONTRACT = {
                     "enum": ["1:1", "16:9", "9:16", "3:2", "2:3", "auto"]
                 },
                 "output_resolution": {
-                    "enum": ["480p", "720p"]
+                    "enum": ["480p", "720p", "1080p"]
                 }
             }
         }
@@ -373,7 +404,7 @@ CONTRACT = {
                     "enum": ["1:1", "16:9", "9:16", "3:2", "2:3", "auto"]
                 },
                 "output_resolution": {
-                    "enum": ["480p", "720p"]
+                    "enum": ["480p", "720p", "1080p"]
                 }
             }
         }
@@ -893,6 +924,35 @@ CONTRACT = {
             "midjourney-v8.1": {}
         }
     },
+    "minimax-h3/image-to-video": {
+        "models": ["minimax-h3"],
+        "fields_by_model": {
+            "minimax-h3": {
+                "duration_seconds": {
+                    "enum": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]
+                },
+                "output_resolution": {
+                    "enum": ["768p", "2k"]
+                }
+            }
+        }
+    },
+    "minimax-h3/text-to-video": {
+        "models": ["minimax-h3"],
+        "fields_by_model": {
+            "minimax-h3": {
+                "aspect_ratio": {
+                    "enum": ["adaptive", "21:9", "16:9", "4:3", "1:1", "3:4", "9:16"]
+                },
+                "duration_seconds": {
+                    "enum": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]
+                },
+                "output_resolution": {
+                    "enum": ["768p", "2k"]
+                }
+            }
+        }
+    },
     "nano-banana/edit-image": {
         "models": ["nano-banana-2-lite", "nano-banana-edit"],
         "fields_by_model": {
@@ -973,6 +1033,27 @@ CONTRACT = {
             "omnihuman-1.5-subject-detection": {}
         }
     },
+    "openai-transcription/speech-to-text": {
+        "models": ["gpt-transcribe", "whisper-1"],
+        "fields_by_model": {
+            "gpt-transcribe": {
+                "model": {
+                    "enum": ["gpt-transcribe"]
+                },
+                "response_format": {
+                    "enum": ["json", "text"]
+                }
+            },
+            "whisper-1": {
+                "model": {
+                    "enum": ["whisper-1"]
+                },
+                "response_format": {
+                    "enum": ["json", "text", "srt", "verbose_json", "vtt"]
+                }
+            }
+        }
+    },
     "openai-tts/text-to-speech": {
         "models": ["tts-1", "tts-1-hd"],
         "fields_by_model": {
@@ -987,6 +1068,9 @@ CONTRACT = {
                 "aspect_ratio": {
                     "enum": ["16:9", "4:3", "1:1", "3:4", "9:16", "2:3", "3:2", "21:9"]
                 },
+                "enable_audio": {
+                    "enum": [True, False]
+                },
                 "output_resolution": {
                     "enum": ["360p", "540p", "720p", "1080p"]
                 }
@@ -997,6 +1081,9 @@ CONTRACT = {
         "models": ["pixverse-v6"],
         "fields_by_model": {
             "pixverse-v6": {
+                "enable_audio": {
+                    "enum": [True, False]
+                },
                 "output_resolution": {
                     "enum": ["360p", "540p", "720p", "1080p"]
                 }
@@ -1007,6 +1094,9 @@ CONTRACT = {
         "models": ["pixverse-v6"],
         "fields_by_model": {
             "pixverse-v6": {
+                "enable_audio": {
+                    "enum": [True, False]
+                },
                 "output_resolution": {
                     "enum": ["360p", "540p", "720p", "1080p"]
                 }
@@ -1020,6 +1110,9 @@ CONTRACT = {
                 "aspect_ratio": {
                     "enum": ["16:9", "4:3", "1:1", "3:4", "9:16", "2:3", "3:2", "21:9"]
                 },
+                "enable_audio": {
+                    "enum": [True, False]
+                },
                 "output_resolution": {
                     "enum": ["360p", "540p", "720p", "1080p"]
                 }
@@ -1030,6 +1123,9 @@ CONTRACT = {
         "models": ["pixverse-v6"],
         "fields_by_model": {
             "pixverse-v6": {
+                "enable_audio": {
+                    "enum": [True, False]
+                },
                 "output_resolution": {
                     "enum": ["360p", "540p", "720p", "1080p"]
                 }
@@ -1107,6 +1203,60 @@ CONTRACT = {
             }
         }
     },
+    "qwen-3/edit-image": {
+        "models": ["qwen-3-edit-image", "qwen-3-pro-edit-image"],
+        "fields_by_model": {
+            "qwen-3-edit-image": {
+                "aspect_ratio": {
+                    "enum": ["1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16", "21:9"]
+                },
+                "output_format": {
+                    "enum": ["png", "jpeg"]
+                },
+                "output_resolution": {
+                    "enum": ["1k", "2k"]
+                }
+            },
+            "qwen-3-pro-edit-image": {
+                "aspect_ratio": {
+                    "enum": ["1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16", "21:9"]
+                },
+                "output_format": {
+                    "enum": ["png", "jpeg"]
+                },
+                "output_resolution": {
+                    "enum": ["1k", "2k"]
+                }
+            }
+        }
+    },
+    "qwen-3/text-to-image": {
+        "models": ["qwen-3-pro-text-to-image", "qwen-3-text-to-image"],
+        "fields_by_model": {
+            "qwen-3-pro-text-to-image": {
+                "aspect_ratio": {
+                    "enum": ["1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16", "21:9"]
+                },
+                "output_format": {
+                    "enum": ["png", "jpeg"]
+                },
+                "output_resolution": {
+                    "enum": ["1k", "2k"]
+                }
+            },
+            "qwen-3-text-to-image": {
+                "aspect_ratio": {
+                    "enum": ["1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16", "21:9"]
+                },
+                "output_format": {
+                    "enum": ["png", "jpeg"]
+                },
+                "output_resolution": {
+                    "enum": ["1k", "2k"]
+                }
+            }
+        }
+    },
     "qwen-image/edit-image": {
         "models": ["qwen-image-edit-image"],
         "fields_by_model": {
@@ -1359,6 +1509,16 @@ CONTRACT = {
             }
         }
     },
+    "suno/add-samples": {
+        "models": ["suno-v4", "suno-v4.5", "suno-v4.5-plus", "suno-v5", "suno-v5.5"],
+        "fields_by_model": {
+            "suno-v4": {},
+            "suno-v4.5": {},
+            "suno-v4.5-plus": {},
+            "suno-v5": {},
+            "suno-v5.5": {}
+        }
+    },
     "suno/add-vocals": {
         "models": ["suno-v4.5-plus", "suno-v5"],
         "fields_by_model": {
@@ -1657,6 +1817,16 @@ CONTRACT = {
             "_": {}
         }
     },
+    "suno/remaster-audio": {
+        "models": ["suno-v4", "suno-v4.5", "suno-v4.5-plus", "suno-v5", "suno-v5.5"],
+        "fields_by_model": {
+            "suno-v4": {},
+            "suno-v4.5": {},
+            "suno-v4.5-plus": {},
+            "suno-v5": {},
+            "suno-v5.5": {}
+        }
+    },
     "suno/replace-section": {
         "models": [],
         "fields_by_model": {
@@ -1680,6 +1850,16 @@ CONTRACT = {
             }
         }
     },
+    "suno/stitch-audio": {
+        "models": ["suno-v4", "suno-v4.5", "suno-v4.5-plus", "suno-v5", "suno-v5.5"],
+        "fields_by_model": {
+            "suno-v4": {},
+            "suno-v4.5": {},
+            "suno-v4.5-plus": {},
+            "suno-v5": {},
+            "suno-v5.5": {}
+        }
+    },
     "suno/text-to-music": {
         "models": ["suno-v4", "suno-v4.5", "suno-v4.5-all", "suno-v4.5-plus", "suno-v5", "suno-v5.5"],
         "fields_by_model": {

{runapi_core-0.3.5 → runapi_core-0.4.0}/src/runapi/core/http_client.py

@@ -123,18 +123,20 @@ class HttpClient:
         self, body: Any
     ) -> Tuple[Any, Optional[Dict[str, Any]], Optional[Dict[str, Any]], List[Any]]:
         if isinstance(body, MultipartBody):
-            data = {key: str(value) for key, value in body.fields.items()}
-            files: Dict[str, Any] = {}
+            files = []
+            for key, value in body.fields.items():
+                values = value if isinstance(value, (list, tuple)) else [value]
+                files.extend((key, (None, str(item))) for item in values)
             opened: List[Any] = []
             for key, part in body.files.items():
                 handle = open(part.path, "rb")
                 opened.append(handle)
                 filename = part.filename
                 if part.content_type:
-                    files[key] = (filename, handle, part.content_type)
+                    files.append((key, (filename, handle, part.content_type)))
                 else:
-                    files[key] = (filename, handle)
-            return None, data, files, opened
+                    files.append((key, (filename, handle)))
+            return None, None, files, opened
         if body is not None:
             return body, None, None, []
         return None, None, None, []

{runapi_core-0.3.5 → runapi_core-0.4.0}/src/runapi/core/resource.py

@@ -162,8 +162,10 @@ class Resource:
     def _enum_allowed(enum: Sequence[Any], value: Any) -> bool:
         value_is_num = isinstance(value, (int, float)) and not isinstance(value, bool)
         for allowed in enum:
-            allowed_is_num = isinstance(allowed, (int, float)) and not isinstance(allowed, bool)
-            if allowed_is_num:
+            if isinstance(allowed, bool):
+                if isinstance(value, bool) and value is allowed:
+                    return True
+            elif isinstance(allowed, (int, float)):
                 if value_is_num and value == allowed:
                     return True
             elif value_is_num:
@@ -175,32 +177,65 @@ class Resource:
 
     def _enforce_rule(self, params: Dict[str, Any], rule: Dict[str, Any]) -> None:
         conditions = rule.get("when", {})
-        if not all(self._rule_condition_met(params, key, val) for key, val in conditions.items()):
+        if not all(
+            self._rule_condition_met(params, key, val) for key, val in conditions.items()
+        ):
             return
 
-        context = " and ".join(f"{key} is {val}" for key, val in conditions.items())
+        context = " and ".join(
+            self._rule_condition_label(key, val) for key, val in conditions.items()
+        )
+        qualifier = f" when {context}" if context else ""
+
         for field in rule.get("required", []):
             if not self._field_present(params, field):
-                raise ValidationError(f"{field} is required when {context}")
+                raise ValidationError(f"{field} is required{qualifier}")
+
+        required_any = rule.get("required_any", [])
+        if required_any and not any(self._field_present(params, f) for f in required_any):
+            raise ValidationError(f"one of {', '.join(required_any)} is required{qualifier}")
+
         for field in rule.get("forbidden", []):
             if self._field_present(params, field):
-                raise ValidationError(f"{field} is not allowed when {context}")
+                raise ValidationError(f"{field} is not allowed{qualifier}")
+
+        for field, allowed in (rule.get("enum") or {}).items():
+            if not self._field_present(params, field):
+                continue
+            if any(str(candidate) == str(params[field]) for candidate in allowed):
+                continue
+            joined = ", ".join(str(candidate) for candidate in allowed)
+            raise ValidationError(f"{field} must be one of: {joined}{qualifier}")
+
+    def _rule_condition_met(self, params: Dict[str, Any], field: str, condition: Any) -> bool:
+        """A ``when`` entry is either ``{"present": bool}`` or a scalar the supplied
+        value must equal. Rules never resolve declared defaults."""
+        if self._is_presence_condition(condition):
+            return self._field_present(params, field) is (condition["present"] is True)
 
-    @staticmethod
-    def _rule_condition_met(params: Dict[str, Any], field: str, value: Any) -> bool:
         if field not in params:
             return False
-        return str(params[field]) == str(value)
+        return str(params[field]) == str(condition)
+
+    @staticmethod
+    def _is_presence_condition(condition: Any) -> bool:
+        return isinstance(condition, dict) and "present" in condition
+
+    def _rule_condition_label(self, field: str, condition: Any) -> str:
+        if self._is_presence_condition(condition):
+            return f"{field} is present" if condition["present"] is True else f"{field} is absent"
+        return f"{field} is {condition}"
 
-    def _field_present(self, params: Dict[str, Any], field: str) -> bool:
+    @classmethod
+    def _field_present(cls, params: Dict[str, Any], field: str) -> bool:
         if field not in params:
             return False
         value = params[field]
         if value is False:
             return True
         if isinstance(value, (list, tuple)):
-            return any(self._present(item) for item in value)
-        return self._present(value)
+            return any(cls._present(item) for item in value)
+        return cls._present(value)
 
     @staticmethod
     def _present(value: Any) -> bool:

runapi_core-0.4.0/src/runapi/core/version.py

@@ -0,0 +1 @@
+__version__ = "0.4.0"

{runapi_core-0.3.5 → runapi_core-0.4.0}/tests/test_http_client.py

@@ -133,7 +133,7 @@ def test_sends_multipart_without_json_content_type():
         path = handle.name
     try:
         body = MultipartBody(
-            fields={"file_name": "image.png"},
+            fields={"file_name": "image.png", "languages[]": ["en", "zh"]},
             files={"file": MultipartFile(path=path, filename="image.png", content_type="image/png")},
         )
         make_client(handler).request("post", "/api/v1/files", body=body)
@@ -142,6 +142,7 @@ def test_sends_multipart_without_json_content_type():
 
     assert captured["content_type"].startswith("multipart/form-data")
     assert b"image.png" in captured["body"]
+    assert captured["body"].count(b'name="languages[]"') == 2
     assert b"png" in captured["body"]
 
 

{runapi_core-0.3.5 → runapi_core-0.4.0}/tests/test_resource.py

@@ -135,6 +135,16 @@ def test_validate_integer_rejects_bool_and_whole_float():
     assert _run_validate({"model": "m", "tolerance": 5}) == ""
 
 
+def test_validate_boolean_enum_requires_boolean_value():
+    schema = {"models": ["m"], "fields_by_model": {"m": {"flag": {"enum": [True, False]}}}}
+    resource = SampleResource(FakeHttp())
+
+    resource._validate_contract(schema, {"model": "m", "flag": True})
+    resource._validate_contract(schema, {"model": "m", "flag": False})
+    with pytest.raises(ValidationError, match="^flag must be one of: True, False$"):
+        resource._validate_contract(schema, {"model": "m", "flag": "true"})
+
+
 def test_validate_array_item_count_constraints():
     schema = {
         "models": ["m"],

runapi_core-0.3.5/src/runapi/core/version.py

@@ -1 +0,0 @@
-__version__ = "0.3.5"