runapi-core 0.1.5__tar.gz → 0.2.0__tar.gz

{runapi_core-0.1.5 → runapi_core-0.2.0}/PKG-INFO

@@ -1,12 +1,16 @@
 Metadata-Version: 2.4
 Name: runapi-core
-Version: 0.1.5
-Summary: Core module for the RunAPI Python SDK
-Project-URL: Homepage, https://runapi.ai
-Project-URL: Documentation, https://runapi.ai/docs#sdk
+Version: 0.2.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#runapi-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.2.0
 Author-email: RunAPI <contact@runapi.ai>
 License-Expression: Apache-2.0
-Keywords: ai,api,runapi,sdk
+Keywords: api,core,golang,gradle,java,maven,pypi,python,ruby,runapi,runapi-ai,sdk,typescript
 Requires-Python: >=3.9
 Requires-Dist: httpx>=0.27
 Description-Content-Type: text/markdown

runapi_core-0.2.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "runapi-core"
+dynamic = ["version"]
+description = "RunAPI core SDK for 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", "core", "api", "sdk", "typescript", "python", "ruby", "golang", "java", "pypi", "maven", "gradle"]
+dependencies = ["httpx>=0.27"]
+
+[project.urls]
+Homepage = "https://runapi.ai/models"
+Documentation = "https://runapi.ai/docs#runapi-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.2.0"
+
+[tool.hatch.version]
+path = "src/runapi/core/version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/runapi"]
+
+[tool.uv]
+package = true
+
+[dependency-groups]
+dev = ["pytest>=8", "httpx>=0.27"]
+
+[tool.runapi]
+slug = "core"

{runapi_core-0.1.5 → runapi_core-0.2.0}/src/runapi/core/contract_gen.py

@@ -38,6 +38,13 @@ CONTRACT = {
             "text-to-speech-turbo-v2.5": {}
         }
     },
+    "fish-audio/text-to-speech": {
+        "models": ["s1", "s2-pro"],
+        "fields_by_model": {
+            "s1": {},
+            "s2-pro": {}
+        }
+    },
     "flux-2/remix-image": {
         "models": ["flux-2-flex-remix-image", "flux-2-pro-remix-image"],
         "fields_by_model": {
@@ -114,8 +121,16 @@ CONTRACT = {
         }
     },
     "gemini-omni/text-to-video": {
-        "models": ["gemini-omni-text-to-video"],
+        "models": ["gemini-omni-flash-preview", "gemini-omni-text-to-video"],
         "fields_by_model": {
+            "gemini-omni-flash-preview": {
+                "aspect_ratio": {
+                    "enum": ["16:9", "9:16"]
+                },
+                "output_resolution": {
+                    "enum": ["720p"]
+                }
+            },
             "gemini-omni-text-to-video": {
                 "aspect_ratio": {
                     "enum": ["16:9", "9:16"]
@@ -129,6 +144,13 @@ CONTRACT = {
             }
         }
     },
+    "gemini-tts/text-to-speech": {
+        "models": ["gemini-2.5-pro-tts", "gemini-3.1-flash-tts"],
+        "fields_by_model": {
+            "gemini-2.5-pro-tts": {},
+            "gemini-3.1-flash-tts": {}
+        }
+    },
     "gpt-4o-image/text-to-image": {
         "models": ["gpt-4o-image"],
         "fields_by_model": {
@@ -211,7 +233,7 @@ CONTRACT = {
         }
     },
     "grok-imagine/image-to-video": {
-        "models": ["grok-imagine-image-to-video", "grok-imagine-video-1.5-preview"],
+        "models": ["grok-imagine-image-to-video", "grok-imagine-video-1.5-fast", "grok-imagine-video-1.5-preview"],
         "fields_by_model": {
             "grok-imagine-image-to-video": {
                 "aspect_ratio": {
@@ -224,6 +246,14 @@ CONTRACT = {
                     "enum": ["480p", "720p"]
                 }
             },
+            "grok-imagine-video-1.5-fast": {
+                "aspect_ratio": {
+                    "enum": ["1:1", "16:9", "9:16", "3:2", "2:3"]
+                },
+                "output_resolution": {
+                    "enum": ["480p", "720p"]
+                }
+            },
             "grok-imagine-video-1.5-preview": {
                 "aspect_ratio": {
                     "enum": ["1:1", "16:9", "9:16", "3:2", "2:3", "auto"]
@@ -245,7 +275,7 @@ CONTRACT = {
         }
     },
     "grok-imagine/text-to-video": {
-        "models": ["grok-imagine-text-to-video", "grok-imagine-video-1.5-preview"],
+        "models": ["grok-imagine-text-to-video", "grok-imagine-video-1.5-fast", "grok-imagine-video-1.5-preview"],
         "fields_by_model": {
             "grok-imagine-text-to-video": {
                 "aspect_ratio": {
@@ -258,6 +288,14 @@ CONTRACT = {
                     "enum": ["480p", "720p"]
                 }
             },
+            "grok-imagine-video-1.5-fast": {
+                "aspect_ratio": {
+                    "enum": ["1:1", "16:9", "9:16", "3:2", "2:3"]
+                },
+                "output_resolution": {
+                    "enum": ["480p", "720p"]
+                }
+            },
             "grok-imagine-video-1.5-preview": {
                 "aspect_ratio": {
                     "enum": ["1:1", "16:9", "9:16", "3:2", "2:3", "auto"]
@@ -649,6 +687,12 @@ CONTRACT = {
             }
         }
     },
+    "midjourney/shorten-prompt": {
+        "models": [],
+        "fields_by_model": {
+            "_": {}
+        }
+    },
     "midjourney/text-to-image": {
         "models": ["midjourney-v8.1"],
         "fields_by_model": {
@@ -735,6 +779,13 @@ CONTRACT = {
             "omnihuman-1.5-subject-detection": {}
         }
     },
+    "openai-tts/text-to-speech": {
+        "models": ["tts-1", "tts-1-hd"],
+        "fields_by_model": {
+            "tts-1": {},
+            "tts-1-hd": {}
+        }
+    },
     "qwen-2/edit-image": {
         "models": ["qwen-2-edit-image"],
         "fields_by_model": {
@@ -890,7 +941,7 @@ CONTRACT = {
         }
     },
     "seedream/edit-image": {
-        "models": ["seedream-4.5-edit", "seedream-5-lite-edit", "seedream-v4-edit"],
+        "models": ["seedream-4.5-edit", "seedream-5-lite-edit", "seedream-5-pro-edit", "seedream-v4-edit"],
         "fields_by_model": {
             "seedream-4.5-edit": {
                 "aspect_ratio": {
@@ -904,6 +955,20 @@ CONTRACT = {
                 "aspect_ratio": {
                     "enum": ["1:1", "4:3", "3:4", "16:9", "9:16", "2:3", "3:2", "21:9"]
                 },
+                "output_format": {
+                    "enum": ["png", "jpeg"]
+                },
+                "output_quality": {
+                    "enum": ["basic", "high"]
+                }
+            },
+            "seedream-5-pro-edit": {
+                "aspect_ratio": {
+                    "enum": ["1:1", "4:3", "3:4", "16:9", "9:16", "2:3", "3:2", "21:9"]
+                },
+                "output_format": {
+                    "enum": ["png", "jpeg"]
+                },
                 "output_quality": {
                     "enum": ["basic", "high"]
                 }
@@ -922,7 +987,7 @@ CONTRACT = {
         }
     },
     "seedream/text-to-image": {
-        "models": ["seedream-4.5-text-to-image", "seedream-5-lite-text-to-image", "seedream-v4-text-to-image"],
+        "models": ["seedream-4.5-text-to-image", "seedream-5-lite-text-to-image", "seedream-5-pro-text-to-image", "seedream-v4-text-to-image"],
         "fields_by_model": {
             "seedream-4.5-text-to-image": {
                 "aspect_ratio": {
@@ -936,6 +1001,20 @@ CONTRACT = {
                 "aspect_ratio": {
                     "enum": ["1:1", "4:3", "3:4", "16:9", "9:16", "2:3", "3:2", "21:9"]
                 },
+                "output_format": {
+                    "enum": ["png", "jpeg"]
+                },
+                "output_quality": {
+                    "enum": ["basic", "high"]
+                }
+            },
+            "seedream-5-pro-text-to-image": {
+                "aspect_ratio": {
+                    "enum": ["1:1", "4:3", "3:4", "16:9", "9:16", "2:3", "3:2", "21:9"]
+                },
+                "output_format": {
+                    "enum": ["png", "jpeg"]
+                },
                 "output_quality": {
                     "enum": ["basic", "high"]
                 }
@@ -1278,7 +1357,14 @@ CONTRACT = {
     "suno/separate-audio-stems": {
         "models": [],
         "fields_by_model": {
-            "_": {}
+            "_": {
+                "stem_name": {
+                    "enum": ["Lead Vocal", "Drum Kit", "Kick", "Snare", "Risers", "Bass", "Backing Vocals", "Piano", "Electric Guitar", "Percussion", "String Section", "Synth", "Acoustic Guitar", "Sound Effects", "Synth Pad", "Synth Bass", "Guitar", "Brass Section", "Organ", "Electronic Drum Kit", "Lead Electric Guitar", "Synth Keys", "Rhythm Electric Guitar", "Electric Piano", "Upright Bass", "Keyboards", "Distorted Electric Guitar", "Synth Strings", "Synth Lead", "Woodwinds", "Rhythm Acoustic Guitar", "Flute", "Harp", "Tambourine", "Trumpet", "Arpeggiator", "Accordion", "Fiddle", "Pedal Steel Guitar", "Synth Voice", "Violin", "Digital Piano", "Synth Brass", "Mandolin", "Choir", "Banjo", "Bells", "Clarinet", "Tenor Saxophone", "Trombone", "Shaker", "French Horn", "Glockenspiel", "Electric Bass", "Cello", "Timpani", "Harmonica", "Marimba", "Vibraphone", "Lap Steel Guitar", "Saxophone", "Orchestra", "Horns", "Cymbals", "Hand Clap", "Oboe", "Celesta", "Congas", "Drone", "Alto Saxophone", "Double Bass", "Ukulele", "Harpsichord", "Baritone Saxophone", "Xylophone", "Tuba", "Bass Guitar", "Whistle", "Lead Guitar", "Rhodes", "808", "Bongos", "Bassoon", "Cowbell", "Viola", "Sitar", "Steel Drums", "Piccolo", "Theremin", "Bagpipes", "Hi-Hat", "Music Box", "Melodica", "Tabla", "Koto", "Djembe", "Taiko", "Didgeridoo"]
+                },
+                "type": {
+                    "enum": ["separate_vocal", "split_stem", "split_stem_advanced"]
+                }
+            }
         }
     },
     "suno/text-to-music": {

{runapi_core-0.1.5 → runapi_core-0.2.0}/src/runapi/core/errors.py

@@ -28,6 +28,7 @@ class Error(Exception):
         self,
         message: Optional[str] = None,
         *,
+        code: Optional[str] = None,
         status: Optional[int] = None,
         request_id: Optional[str] = None,
         details: Any = None,
@@ -35,6 +36,7 @@ class Error(Exception):
     ) -> None:
         super().__init__(message)
         self.message = message
+        self.code = code
         self.status = status
         self.request_id = request_id
         self.details = details
@@ -53,6 +55,7 @@ class Error(Exception):
         data = {
             "error": type(self).__name__,
             "message": self.message,
+            "code": self.code,
             "status": self.status,
             "request_id": self.request_id,
             "details": self.details,
@@ -64,6 +67,7 @@ class AuthenticationError(Error):
     """API key is missing or invalid (HTTP 401)."""
 
     def __init__(self, message: str = "Unauthorized", *, status: int = 401, **kwargs: Any) -> None:
+        kwargs.setdefault("code", "authentication")
         super().__init__(message, status=status, **kwargs)
 
 
@@ -78,6 +82,7 @@ class RateLimitError(Error):
         retry_after: Optional[float] = None,
         **kwargs: Any,
     ) -> None:
+        kwargs.setdefault("code", "rate_limit")
         super().__init__(message, status=status, **kwargs)
         self.retry_after = retry_after
 
@@ -86,6 +91,7 @@ class InsufficientCreditsError(Error):
     """Account has insufficient credits (HTTP 402)."""
 
     def __init__(self, message: str = "Insufficient credits", *, status: int = 402, **kwargs: Any) -> None:
+        kwargs.setdefault("code", "insufficient_credits")
         super().__init__(message, status=status, **kwargs)
 
 
@@ -93,6 +99,7 @@ class NotFoundError(Error):
     """Requested resource does not exist (HTTP 404)."""
 
     def __init__(self, message: str = "Not found", *, status: int = 404, **kwargs: Any) -> None:
+        kwargs.setdefault("code", "not_found")
         super().__init__(message, status=status, **kwargs)
 
 
@@ -100,6 +107,7 @@ class ValidationError(Error):
     """Request validation failed (HTTP 400 / 422), or a client-side check failed."""
 
     def __init__(self, message: str = "Validation failed", **kwargs: Any) -> None:
+        kwargs.setdefault("code", "validation")
         super().__init__(message, **kwargs)
 
 
@@ -107,6 +115,7 @@ class ServiceUnavailableError(Error):
     """Service is temporarily unavailable (HTTP 503)."""
 
     def __init__(self, message: str = "Service unavailable", *, status: Optional[int] = None, **kwargs: Any) -> None:
+        kwargs.setdefault("code", "service_unavailable")
         super().__init__(message, status=503 if status is None else status, **kwargs)
 
 
@@ -114,6 +123,7 @@ class ConflictError(Error):
     """Request conflicts with the current resource state (HTTP 409)."""
 
     def __init__(self, message: str = "Conflict", *, status: int = 409, **kwargs: Any) -> None:
+        kwargs.setdefault("code", "conflict")
         super().__init__(message, status=status, **kwargs)
 
 
@@ -121,6 +131,7 @@ class ServerError(Error):
     """Server encountered an internal error (HTTP 5xx)."""
 
     def __init__(self, message: str = "Server error", *, status: Optional[int] = None, **kwargs: Any) -> None:
+        kwargs.setdefault("code", "server")
         super().__init__(message, status=500 if status is None else status, **kwargs)
 
 
@@ -128,6 +139,7 @@ class NetworkError(Error):
     """Network connection failed or the request could not be sent."""
 
     def __init__(self, message: str = "Network error", **kwargs: Any) -> None:
+        kwargs.setdefault("code", "network")
         super().__init__(message, **kwargs)
 
 
@@ -135,6 +147,7 @@ class TimeoutError(Error):  # noqa: A001 - intentional SDK error name, parallels
     """HTTP request exceeded the configured timeout."""
 
     def __init__(self, message: str = "Request timed out", **kwargs: Any) -> None:
+        kwargs.setdefault("code", "timeout")
         super().__init__(message, **kwargs)
 
 
@@ -142,6 +155,7 @@ class TaskTimeoutError(Error):
     """Polling for task completion exceeded the maximum wait time."""
 
     def __init__(self, message: str = "Task polling timed out", **kwargs: Any) -> None:
+        kwargs.setdefault("code", "task_timeout")
         super().__init__(message, **kwargs)
 
 
@@ -149,6 +163,7 @@ class TaskFailedError(Error):
     """Async task failed during processing."""
 
     def __init__(self, message: str = "Task failed", **kwargs: Any) -> None:
+        kwargs.setdefault("code", "task_failed")
         super().__init__(message, **kwargs)
 
 
@@ -198,6 +213,7 @@ def error_from_response(response: "Any") -> Error:
     error_class = STATUS_MAP.get(status, Error)
 
     kwargs: Dict[str, Any] = {
+        "code": _extract_code(parsed_body),
         "status": status,
         "request_id": request_id,
         "details": parsed_body,
@@ -209,6 +225,16 @@ def error_from_response(response: "Any") -> Error:
     return error_class(message, **kwargs)
 
 
+def _extract_code(body: Any) -> Optional[str]:
+    if not isinstance(body, dict):
+        return None
+    error = body.get("error")
+    if not isinstance(error, dict):
+        return None
+    code = error.get("code")
+    return code if isinstance(code, str) and code else None
+
+
 def _parse_body(body: Optional[str]) -> Any:
     if not body:
         return None

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

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

{runapi_core-0.1.5 → runapi_core-0.2.0}/tests/test_errors.py

@@ -70,6 +70,36 @@ def test_extracts_message_from_nested_error():
     assert error.message == "Nested message"
 
 
+def test_preserves_explicit_http_error_code_and_leaves_missing_code_none():
+    explicit = errors.error_from_response(
+        response(409, body='{"error":{"code":"source_task_not_ready","message":"wait"}}')
+    )
+    missing = errors.error_from_response(response(409, body='{"error":{"message":"wait"}}'))
+
+    assert explicit.code == "source_task_not_ready"
+    assert missing.code is None
+
+
+def test_continuation_errors_preserve_codes_and_status_classification():
+    cases = [
+        (400, "invalid_resource_id", errors.ValidationError),
+        (409, "request_conflict", errors.ConflictError),
+        (409, "source_task_not_ready", errors.ConflictError),
+        (422, "source_task_unusable", errors.ValidationError),
+        (422, "continuation_not_supported", errors.ValidationError),
+        (429, "rate_limited", errors.RateLimitError),
+        (503, "continuation_unavailable", errors.ServiceUnavailableError),
+    ]
+
+    for status, code, error_class in cases:
+        error = errors.error_from_response(
+            response(status, body=f'{{"error":{{"code":"{code}","message":"failed"}}}}')
+        )
+        assert isinstance(error, error_class)
+        assert error.status == status
+        assert error.code == code
+
+
 def test_extracts_message_from_errors_array():
     error = errors.error_from_response(response(400, body='{"errors":["First error"]}'))
     assert error.message == "First error"
@@ -99,6 +129,7 @@ def test_to_dict_is_compact():
     assert error.to_dict() == {
         "error": "AuthenticationError",
         "message": "Bad key",
+        "code": "authentication",
         "status": 401,
         "request_id": "req-1",
     }

runapi_core-0.1.5/pyproject.toml

@@ -1,33 +0,0 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "runapi-core"
-dynamic = ["version"]
-description = "Core module for the RunAPI Python SDK"
-readme = "README.md"
-requires-python = ">=3.9"
-license = "Apache-2.0"
-authors = [{ name = "RunAPI", email = "contact@runapi.ai" }]
-keywords = ["runapi", "ai", "sdk", "api"]
-dependencies = ["httpx>=0.27"]
-
-[project.urls]
-Homepage = "https://runapi.ai"
-Documentation = "https://runapi.ai/docs#sdk"
-
-[tool.hatch.version]
-path = "src/runapi/core/version.py"
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/runapi"]
-
-[tool.uv]
-package = true
-
-[dependency-groups]
-dev = ["pytest>=8", "httpx>=0.27"]
-
-[tool.runapi]
-slug = "core"

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

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