runapi-core 0.5.1__tar.gz → 0.7.0__tar.gz

{runapi_core-0.5.1 → runapi_core-0.7.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.5
 Name: runapi-core
-Version: 0.5.1
+Version: 0.7.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.5.1
+Project-URL: Release Notes, https://github.com/runapi-ai/core-sdk/releases/tag/python%2Fv0.7.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
@@ -17,7 +17,7 @@ Description-Content-Type: text/markdown
 
 # RunAPI Core Python SDK
 
-The RunAPI Core Python SDK provides shared authentication, HTTP, retry, error, and polling primitives for RunAPI model packages. Install `runapi-core` only when you are building SDK infrastructure or shared Python tooling; application code should normally install a concrete model package such as `runapi-flux-2`.
+The RunAPI Core Python SDK provides shared authentication, HTTP, retry, error, Files, Uploads, and polling primitives for RunAPI model packages. Install `runapi-core` only when you are building SDK infrastructure or shared Python tooling; application code should normally install a concrete model package such as `runapi-flux-2`.
 
 ## Install
 
@@ -79,6 +79,23 @@ inline = files.create(source="iVBORw0KGgo...")
 print(uploaded.url)
 ```
 
+The existing `files.create()` method keeps its temporary URL behavior. Every Provider Client also exposes persistent Files and multipart Uploads:
+
+```python
+file = client.files.create_file(file="./knowledge.pdf", purpose="user_data")
+content = client.files.content(file.id)
+
+upload = client.uploads.create(
+    bytes=1048576,
+    filename="archive.bin",
+    mime_type="application/octet-stream",
+)
+part = client.uploads.add_part(upload.id, data="./archive.part-01")
+completed = client.uploads.complete(upload.id, part_ids=[part.id])
+```
+
+Use `files.list()`, `retrieve()`, and `delete_file()` for the remaining File lifecycle. See https://runapi.ai/docs/resources/files for limits and REST examples.
+
 Public SDK docs live at https://runapi.ai/docs/resources/sdks and the model catalog lives at https://runapi.ai/models.
 
 ## Universal resources

{runapi_core-0.5.1 → runapi_core-0.7.0}/README.md

@@ -1,6 +1,6 @@
 # RunAPI Core Python SDK
 
-The RunAPI Core Python SDK provides shared authentication, HTTP, retry, error, and polling primitives for RunAPI model packages. Install `runapi-core` only when you are building SDK infrastructure or shared Python tooling; application code should normally install a concrete model package such as `runapi-flux-2`.
+The RunAPI Core Python SDK provides shared authentication, HTTP, retry, error, Files, Uploads, and polling primitives for RunAPI model packages. Install `runapi-core` only when you are building SDK infrastructure or shared Python tooling; application code should normally install a concrete model package such as `runapi-flux-2`.
 
 ## Install
 
@@ -62,6 +62,23 @@ inline = files.create(source="iVBORw0KGgo...")
 print(uploaded.url)
 ```
 
+The existing `files.create()` method keeps its temporary URL behavior. Every Provider Client also exposes persistent Files and multipart Uploads:
+
+```python
+file = client.files.create_file(file="./knowledge.pdf", purpose="user_data")
+content = client.files.content(file.id)
+
+upload = client.uploads.create(
+    bytes=1048576,
+    filename="archive.bin",
+    mime_type="application/octet-stream",
+)
+part = client.uploads.add_part(upload.id, data="./archive.part-01")
+completed = client.uploads.complete(upload.id, part_ids=[part.id])
+```
+
+Use `files.list()`, `retrieve()`, and `delete_file()` for the remaining File lifecycle. See https://runapi.ai/docs/resources/files for limits and REST examples.
+
 Public SDK docs live at https://runapi.ai/docs/resources/sdks and the model catalog lives at https://runapi.ai/models.
 
 ## Universal resources

{runapi_core-0.5.1 → runapi_core-0.7.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.5.1"
+"Release Notes" = "https://github.com/runapi-ai/core-sdk/releases/tag/python%2Fv0.7.0"
 
 [tool.hatch.version]
 path = "src/runapi/core/version.py"

{runapi_core-0.5.1 → runapi_core-0.7.0}/src/runapi/core/__init__.py

@@ -1,7 +1,7 @@
 """RunAPI Python SDK — shared core.
 
-Configuration, errors, models, HTTP transport, polling, and the file upload
-client shared by every per-model-line package.
+Configuration, errors, models, HTTP transport, polling, Files, and Uploads
+shared by every per-model-line package.
 """
 
 from . import config, errors, polling
@@ -25,7 +25,7 @@ from .errors import (
     ValidationError,
     error_from_response,
 )
-from .files import FilesClient, UploadResponse
+from .files import DeletedFile, FileList, FileObject, FilesClient, UploadResponse
 from .http_client import HttpClient
 from .models import (
     BaseModel,
@@ -44,6 +44,7 @@ from .response import ApiResponse, ResponseHeaders
 from .resource import Resource
 from .pricing import PriceQuote, PriceQuoteResponse, PriceSchedule, PriceScheduleListResponse, Pricing, PricingClient
 from .provider_client import ProviderClient
+from .uploads import UploadObject, UploadPart, Uploads
 from .version import __version__
 
 __all__ = [
@@ -93,6 +94,12 @@ __all__ = [
     "Resource",
     "FilesClient",
     "UploadResponse",
+    "DeletedFile",
+    "FileList",
+    "FileObject",
+    "UploadObject",
+    "UploadPart",
+    "Uploads",
     "Pricing",
     "PricingClient",
     "PriceSchedule",

{runapi_core-0.5.1 → runapi_core-0.7.0}/src/runapi/core/contract_gen.py

@@ -38,6 +38,24 @@ CONTRACT = {
             "text-to-speech-turbo-v2.5": {}
         }
     },
+    "fish-audio/create-voice": {
+        "models": [],
+        "fields_by_model": {
+            "_": {}
+        }
+    },
+    "fish-audio/get-voice": {
+        "models": [],
+        "fields_by_model": {
+            "_": {}
+        }
+    },
+    "fish-audio/list-voices": {
+        "models": [],
+        "fields_by_model": {
+            "_": {}
+        }
+    },
     "fish-audio/text-to-speech": {
         "models": ["s1", "s2-pro", "s2.1-pro"],
         "fields_by_model": {
@@ -320,9 +338,10 @@ CONTRACT = {
         }
     },
     "grok-imagine/edit-image": {
-        "models": ["grok-imagine-edit-image"],
+        "models": ["grok-imagine-edit-image", "grok-imagine-image-2-0"],
         "fields_by_model": {
-            "grok-imagine-edit-image": {}
+            "grok-imagine-edit-image": {},
+            "grok-imagine-image-2-0": {}
         }
     },
     "grok-imagine/extend": {
@@ -367,9 +386,20 @@ CONTRACT = {
             }
         }
     },
+    "grok-imagine/segment-map": {
+        "models": ["grok-imagine-image-2-0"],
+        "fields_by_model": {
+            "grok-imagine-image-2-0": {}
+        }
+    },
     "grok-imagine/text-to-image": {
-        "models": ["grok-imagine-text-to-image"],
+        "models": ["grok-imagine-image-2-0", "grok-imagine-text-to-image"],
         "fields_by_model": {
+            "grok-imagine-image-2-0": {
+                "aspect_ratio": {
+                    "enum": ["1:1", "2:3", "3:2", "16:9", "9:16"]
+                }
+            },
             "grok-imagine-text-to-image": {
                 "aspect_ratio": {
                     "enum": ["2:3", "3:2", "1:1", "16:9", "9:16"]
@@ -685,6 +715,33 @@ CONTRACT = {
             "kling-v1-avatar-standard": {}
         }
     },
+    "kling/edit-video": {
+        "models": ["kling-v3-omni-edit", "kling-v3-omni-reference"],
+        "fields_by_model": {
+            "kling-v3-omni-edit": {
+                "aspect_ratio": {
+                    "enum": ["auto", "16:9", "9:16", "1:1"]
+                },
+                "duration_seconds": {
+                    "enum": [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]
+                },
+                "output_resolution": {
+                    "enum": ["720p", "1080p", "4k"]
+                }
+            },
+            "kling-v3-omni-reference": {
+                "aspect_ratio": {
+                    "enum": ["auto", "16:9", "9:16", "1:1"]
+                },
+                "duration_seconds": {
+                    "enum": [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]
+                },
+                "output_resolution": {
+                    "enum": ["720p", "1080p", "4k"]
+                }
+            }
+        }
+    },
     "kling/extend-video": {
         "models": ["kling-v2.5-turbo-image-to-video-pro", "kling-v2.5-turbo-text-to-video-pro"],
         "fields_by_model": {
@@ -794,7 +851,7 @@ CONTRACT = {
         }
     },
     "kling/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"],
+        "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-omni-reference", "kling-v3-turbo-text-to-video"],
         "fields_by_model": {
             "kling-3.0": {
                 "aspect_ratio": {
@@ -859,6 +916,17 @@ CONTRACT = {
                     "enum": ["720p", "1080p", "4k"]
                 }
             },
+            "kling-v3-omni-reference": {
+                "aspect_ratio": {
+                    "enum": ["16:9", "9:16", "1:1"]
+                },
+                "duration_seconds": {
+                    "enum": [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]
+                },
+                "output_resolution": {
+                    "enum": ["720p", "1080p", "4k"]
+                }
+            },
             "kling-v3-turbo-text-to-video": {
                 "aspect_ratio": {
                     "enum": ["16:9", "9:16", "1:1"]
@@ -1387,7 +1455,7 @@ CONTRACT = {
                     "enum": ["mp4", "mov"]
                 },
                 "output_resolution": {
-                    "enum": ["480p", "720p"]
+                    "enum": ["480p", "720p", "1080p"]
                 }
             },
             "seedance-v1-pro": {

{runapi_core-0.5.1 → runapi_core-0.7.0}/src/runapi/core/files.py

@@ -1,8 +1,4 @@
-"""File upload client.
-
-Shared infrastructure for every model line that takes file inputs: upload a
-local file or register a remote URL and receive a usable file reference.
-"""
+"""Persistent File lifecycle and temporary URL upload client."""
 
 from __future__ import annotations
 
@@ -10,10 +6,12 @@ import base64
 import hashlib
 import os
 from typing import Any, Mapping, Optional, Union
+from urllib.parse import quote, urlencode
 
 from . import auth
 from .http_client import HttpClient
 from .models import BaseModel, optional, required
+from .multipart import MultipartBody, MultipartFile
 from .options import ClientOptions, RequestOptions
 from .resource import Resource
 
@@ -27,10 +25,35 @@ class UploadResponse(BaseModel):
     expires_at = required(str)
 
 
+class FileObject(BaseModel):
+    id = required(str)
+    object = required(str)
+    bytes = required(int)
+    created_at = required(int)
+    expires_at = optional(int)
+    filename = required(str)
+    purpose = required(str)
+
+
+class FileList(BaseModel):
+    object = required(str)
+    data = required([FileObject])
+    first_id = optional(str)
+    last_id = optional(str)
+    has_more = required(bool)
+
+
+class DeletedFile(BaseModel):
+    id = required(str)
+    object = required(str)
+    deleted = required(bool)
+
+
 class FilesClient(Resource):
     ENDPOINT = "/api/v1/files"
     PREPARE_ENDPOINT = f"{ENDPOINT}/prepare"
     CONFIRM_ENDPOINT = f"{ENDPOINT}/confirm"
+    PROTOCOL_ENDPOINT = "/v1/files"
 
     RESPONSE_CLASS = UploadResponse
 
@@ -74,6 +97,52 @@ class FilesClient(Resource):
         )
         return self._request("post", self.ENDPOINT, body=body, options=options)
 
+    def create_file(
+        self,
+        file: Any,
+        purpose: str = "user_data",
+        file_name: Optional[str] = None,
+        options: Optional[RequestOptions] = None,
+    ) -> FileObject:
+        path = self._file_path(file)
+        body = MultipartBody(
+            fields={"purpose": purpose},
+            files={"file": MultipartFile(path=path, filename=file_name or os.path.basename(path))},
+        )
+        return self._request(
+            "post", self.PROTOCOL_ENDPOINT, body=body, options=options, response_class=FileObject
+        )
+
+    def list(
+        self,
+        *,
+        after: Optional[str] = None,
+        limit: Optional[int] = None,
+        order: Optional[str] = None,
+        purpose: Optional[str] = None,
+        options: Optional[RequestOptions] = None,
+    ) -> FileList:
+        query = urlencode(self._compact_params({
+            "after": after, "limit": limit, "order": order, "purpose": purpose
+        }))
+        path = self.PROTOCOL_ENDPOINT + (f"?{query}" if query else "")
+        return self._request("get", path, options=options, response_class=FileList)
+
+    def retrieve(self, file_id: str, options: Optional[RequestOptions] = None) -> FileObject:
+        return self._request(
+            "get", self._protocol_file_path(file_id), options=options, response_class=FileObject
+        )
+
+    def content(self, file_id: str, options: Optional[RequestOptions] = None) -> bytes:
+        return self._http.request_bytes(
+            "get", f"{self._protocol_file_path(file_id)}/content", options=options
+        )
+
+    def delete_file(self, file_id: str, options: Optional[RequestOptions] = None) -> DeletedFile:
+        return self._request(
+            "delete", self._protocol_file_path(file_id), options=options, response_class=DeletedFile
+        )
+
     def _upload_direct(self, file: Any, file_name: Optional[str], options: Optional[RequestOptions]) -> Any:
         """Local files upload straight to storage: ask for a pre-authorized target,
         PUT the bytes there (never through the API), then confirm. The caller still
@@ -139,3 +208,9 @@ class FilesClient(Resource):
         if name:
             return name
         raise ValueError("file must be a file path or a file-like object with a name")
+
+    @classmethod
+    def _protocol_file_path(cls, file_id: str) -> str:
+        if not file_id.strip():
+            raise ValueError("file_id is required")
+        return f"{cls.PROTOCOL_ENDPOINT}/{quote(file_id, safe='')}"

{runapi_core-0.5.1 → runapi_core-0.7.0}/src/runapi/core/http_client.py

@@ -115,6 +115,37 @@ class HttpClient:
         if not response.is_success:
             raise error_from_response(response)
 
+    def request_bytes(
+        self,
+        method: str,
+        path: str,
+        options: Optional[RequestOptions] = None,
+    ) -> bytes:
+        """Return a successful response body without text decoding."""
+        max_retries = self._options.max_retries
+        if options is not None and options.max_retries is not None:
+            max_retries = options.max_retries
+        headers = {str(key): str(value) for key, value in (options.headers or {}).items()} if options else {}
+        timeout = options.timeout if (options and options.timeout is not None) else httpx.USE_CLIENT_DEFAULT
+        method = method.upper()
+        retries = 0
+
+        while True:
+            try:
+                response = self._client.request(method, path, headers=headers, timeout=timeout)
+            except httpx.TimeoutException as exc:
+                raise TimeoutError(str(exc))
+            except httpx.TransportError as exc:
+                raise NetworkError(str(exc))
+            if response.is_success:
+                return response.content
+            error = error_from_response(response)
+            if self._retryable(method, response.status_code) and retries < max_retries:
+                retries += 1
+                time.sleep(self._retry_delay(retries, error))
+                continue
+            raise error
+
     def close(self) -> None:
         self._client.close()
         self._upload_client.close()

{runapi_core-0.5.1 → runapi_core-0.7.0}/src/runapi/core/provider_client.py

@@ -10,6 +10,7 @@ from .files import FilesClient
 from .http_client import HttpClient
 from .options import ClientOptions
 from .pricing import Pricing
+from .uploads import Uploads
 
 
 class ProviderClient:
@@ -22,3 +23,4 @@ class ProviderClient:
         self.files = FilesClient(http=self._http)
         self.account = Account(self._http)
         self.pricing = Pricing(self._http)
+        self.uploads = Uploads(self._http)

runapi_core-0.7.0/src/runapi/core/uploads.py

@@ -0,0 +1,91 @@
+"""Multipart Upload lifecycle client."""
+
+from __future__ import annotations
+
+import os
+from typing import Any, Optional, Sequence
+from urllib.parse import quote
+
+from .files import FileObject, FilesClient
+from .models import BaseModel, optional, required
+from .multipart import MultipartBody, MultipartFile
+from .options import RequestOptions
+from .resource import Resource
+
+
+class UploadObject(BaseModel):
+    id = required(str)
+    object = required(str)
+    bytes = required(int)
+    created_at = required(int)
+    filename = required(str)
+    purpose = required(str)
+    status = required(str)
+    expires_at = required(int)
+    file = optional(FileObject)
+
+
+class UploadPart(BaseModel):
+    id = required(str)
+    object = required(str)
+    created_at = required(int)
+    upload_id = required(str)
+
+
+class Uploads(Resource):
+    ENDPOINT = "/v1/uploads"
+    RESPONSE_CLASS = UploadObject
+
+    def create(
+        self,
+        *,
+        bytes: int,
+        filename: str,
+        mime_type: str,
+        purpose: str = "user_data",
+        options: Optional[RequestOptions] = None,
+    ) -> UploadObject:
+        return self._request("post", self.ENDPOINT, body={
+            "bytes": bytes,
+            "filename": filename,
+            "mime_type": mime_type,
+            "purpose": purpose,
+        }, options=options)
+
+    def add_part(
+        self,
+        upload_id: str,
+        data: Any,
+        file_name: Optional[str] = None,
+        options: Optional[RequestOptions] = None,
+    ) -> UploadPart:
+        path = FilesClient._file_path(data)
+        body = MultipartBody(files={
+            "data": MultipartFile(path=path, filename=file_name or os.path.basename(path))
+        })
+        return self._request(
+            "post", f"{self._upload_path(upload_id)}/parts", body=body,
+            options=options, response_class=UploadPart,
+        )
+
+    def complete(
+        self,
+        upload_id: str,
+        part_ids: Sequence[str],
+        options: Optional[RequestOptions] = None,
+    ) -> UploadObject:
+        return self._request(
+            "post", f"{self._upload_path(upload_id)}/complete",
+            body={"part_ids": list(part_ids)}, options=options,
+        )
+
+    def cancel(self, upload_id: str, options: Optional[RequestOptions] = None) -> UploadObject:
+        return self._request(
+            "post", f"{self._upload_path(upload_id)}/cancel", body={}, options=options
+        )
+
+    @classmethod
+    def _upload_path(cls, upload_id: str) -> str:
+        if not upload_id.strip():
+            raise ValueError("upload_id is required")
+        return f"{cls.ENDPOINT}/{quote(upload_id, safe='')}"

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

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

{runapi_core-0.5.1 → runapi_core-0.7.0}/tests/test_files.py

@@ -176,3 +176,45 @@ def test_create_rejects_blank_source():
         client.create(source="")
     with pytest.raises(ValueError):
         client.create(source="   ")
+
+
+def test_protocol_file_lifecycle_keeps_binary_content(tmp_path):
+    path = tmp_path / "input.bin"
+    path.write_bytes(b"\x00\xff\x01")
+    responses = iter([
+        {"id": "file_123", "object": "file", "bytes": 3, "created_at": 1,
+         "filename": "input.bin", "purpose": "user_data"},
+        {"object": "list", "data": [], "has_more": False},
+        {"id": "file_123", "object": "file", "bytes": 3, "created_at": 1,
+         "filename": "input.bin", "purpose": "user_data"},
+        {"id": "file_123", "object": "file", "deleted": True},
+    ])
+
+    class ProtocolHttp:
+        def __init__(self):
+            self.calls = []
+
+        def request(self, method, request_path, body=None, options=None):
+            self.calls.append((method, request_path, body))
+            return next(responses)
+
+        def request_bytes(self, method, request_path, options=None):
+            self.calls.append((method, request_path, None))
+            return b"\x00\xff\x01"
+
+    fake = ProtocolHttp()
+    files = FilesClient(http=fake)
+
+    created = files.create_file(path)
+    listed = files.list(limit=1, order="asc")
+    retrieved = files.retrieve("file_123")
+    content = files.content("file_123")
+    deleted = files.delete_file("file_123")
+
+    assert created.id == retrieved.id == deleted.id == "file_123"
+    assert listed.has_more is False
+    assert fake.calls[0][1] == "/v1/files"
+    assert fake.calls[1][1] == "/v1/files?limit=1&order=asc"
+    assert fake.calls[3][1] == "/v1/files/file_123/content"
+    assert fake.calls[4][0] == "delete"
+    assert content == b"\x00\xff\x01"

runapi_core-0.7.0/tests/test_uploads.py

@@ -0,0 +1,36 @@
+from runapi.core.multipart import MultipartBody
+from runapi.core.uploads import Uploads
+
+
+class FakeHttp:
+    def __init__(self):
+        self.calls = []
+
+    def request(self, method, path, body=None, options=None):
+        self.calls.append((method, path, body))
+        if path.endswith("/parts"):
+            return {"id": "part_123", "object": "upload.part", "created_at": 1, "upload_id": "upload_123"}
+        return {
+            "id": "upload_123", "object": "upload", "bytes": 3, "created_at": 1,
+            "filename": "data.bin", "purpose": "user_data", "status": "pending", "expires_at": 2,
+        }
+
+
+def test_upload_lifecycle(tmp_path):
+    part = tmp_path / "part.bin"
+    part.write_bytes(b"abc")
+    fake = FakeHttp()
+    uploads = Uploads(fake)
+
+    uploads.create(bytes=3, filename="data.bin", mime_type="application/octet-stream")
+    uploads.add_part("upload_123", part)
+    uploads.complete("upload_123", ["part_123"])
+    uploads.cancel("upload_123")
+
+    assert fake.calls[0][1:] == ("/v1/uploads", {
+        "bytes": 3, "filename": "data.bin", "mime_type": "application/octet-stream", "purpose": "user_data"
+    })
+    assert fake.calls[1][1] == "/v1/uploads/upload_123/parts"
+    assert isinstance(fake.calls[1][2], MultipartBody)
+    assert fake.calls[2][2] == {"part_ids": ["part_123"]}
+    assert fake.calls[3][1] == "/v1/uploads/upload_123/cancel"

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

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