gpuai-sdk 0.3.7__tar.gz → 0.3.9__tar.gz

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gpuai-sdk
-Version: 0.3.7
+Version: 0.3.9
 Summary: GPU.ai Public Developer API
 Home-page: 
 Author: GPU.ai Support
@@ -26,7 +26,7 @@ the dashboard. See https://gpu.ai/docs for details.
 This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 1.0.0
-- Package version: 0.3.7
+- Package version: 0.3.9
 - Generator version: 7.24.0
 - Build package: org.openapitools.codegen.languages.PythonClientCodegen
 
@@ -136,6 +136,7 @@ Class | Method | HTTP request | Description
 *FineTuningApi* | [**get_fine_tuning_job**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/FineTuningApi.md#get_fine_tuning_job) | **GET** /fine_tuning/jobs/{id} | Retrieve a fine-tuning job (OpenAI-compatible)
 *FineTuningApi* | [**list_fine_tuning_job_events**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/FineTuningApi.md#list_fine_tuning_job_events) | **GET** /fine_tuning/jobs/{id}/events | List fine-tuning job events (OpenAI-compatible)
 *FineTuningApi* | [**list_fine_tuning_jobs**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/FineTuningApi.md#list_fine_tuning_jobs) | **GET** /fine_tuning/jobs | List fine-tuning jobs (OpenAI-compatible)
+*FineTuningApi* | [**retrieve_file**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/FineTuningApi.md#retrieve_file) | **GET** /files/{id} | Retrieve a file (OpenAI-compatible)
 *GpuTypesApi* | [**list_gpu_types**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/GpuTypesApi.md#list_gpu_types) | **GET** /gpu-types | List available GPU types (no auth required)
 *InferenceApi* | [**cancel_video**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/InferenceApi.md#cancel_video) | **POST** /videos/{id}/cancel | Cancel a video generation job
 *InferenceApi* | [**create_chat_completion**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/InferenceApi.md#create_chat_completion) | **POST** /chat/completions | Create a chat completion (OpenAI-compatible)

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.9}/README.md

@@ -6,7 +6,7 @@ the dashboard. See https://gpu.ai/docs for details.
 This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 1.0.0
-- Package version: 0.3.7
+- Package version: 0.3.9
 - Generator version: 7.24.0
 - Build package: org.openapitools.codegen.languages.PythonClientCodegen
 
@@ -116,6 +116,7 @@ Class | Method | HTTP request | Description
 *FineTuningApi* | [**get_fine_tuning_job**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/FineTuningApi.md#get_fine_tuning_job) | **GET** /fine_tuning/jobs/{id} | Retrieve a fine-tuning job (OpenAI-compatible)
 *FineTuningApi* | [**list_fine_tuning_job_events**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/FineTuningApi.md#list_fine_tuning_job_events) | **GET** /fine_tuning/jobs/{id}/events | List fine-tuning job events (OpenAI-compatible)
 *FineTuningApi* | [**list_fine_tuning_jobs**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/FineTuningApi.md#list_fine_tuning_jobs) | **GET** /fine_tuning/jobs | List fine-tuning jobs (OpenAI-compatible)
+*FineTuningApi* | [**retrieve_file**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/FineTuningApi.md#retrieve_file) | **GET** /files/{id} | Retrieve a file (OpenAI-compatible)
 *GpuTypesApi* | [**list_gpu_types**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/GpuTypesApi.md#list_gpu_types) | **GET** /gpu-types | List available GPU types (no auth required)
 *InferenceApi* | [**cancel_video**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/InferenceApi.md#cancel_video) | **POST** /videos/{id}/cancel | Cancel a video generation job
 *InferenceApi* | [**create_chat_completion**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/InferenceApi.md#create_chat_completion) | **POST** /chat/completions | Create a chat completion (OpenAI-compatible)

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.9}/gpuai_sdk/__init__.py

@@ -15,7 +15,7 @@
 """  # noqa: E501
 
 
-__version__ = "0.3.7"
+__version__ = "0.3.9"
 
 # Define package exports
 __all__ = [

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.9}/gpuai_sdk/api/fine_tuning_api.py

@@ -1767,3 +1767,279 @@ class FineTuningApi:
         )
 
 
+
+
+    @validate_call
+    def retrieve_file(
+        self,
+        id: Annotated[StrictStr, Field(description="The file id returned by the upload, e.g. `file-9f2c1a...`.")],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> FileObject:
+        """Retrieve a file (OpenAI-compatible)
+
+        Returns the metadata for one of your uploaded files. The lookup is scoped to the organization the API key belongs to: a file id that does not exist and one that belongs to another organization both return the same 404, so this route cannot be used to probe for other tenants' ids.  Use it to check that a `training_file` is present and usable BEFORE creating a fine-tuning job — the create path performs the identical ownership check, so a file this route returns is a file that create will accept.
+
+        :param id: The file id returned by the upload, e.g. `file-9f2c1a...`. (required)
+        :type id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._retrieve_file_serialize(
+            id=id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "FileObject",
+            '401': "OpenAIErrorEnvelope",
+            '403': "OpenAIErrorEnvelope",
+            '404': "OpenAIErrorEnvelope",
+            '429': "OpenAIErrorEnvelope",
+            '500': "OpenAIErrorEnvelope",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def retrieve_file_with_http_info(
+        self,
+        id: Annotated[StrictStr, Field(description="The file id returned by the upload, e.g. `file-9f2c1a...`.")],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[FileObject]:
+        """Retrieve a file (OpenAI-compatible)
+
+        Returns the metadata for one of your uploaded files. The lookup is scoped to the organization the API key belongs to: a file id that does not exist and one that belongs to another organization both return the same 404, so this route cannot be used to probe for other tenants' ids.  Use it to check that a `training_file` is present and usable BEFORE creating a fine-tuning job — the create path performs the identical ownership check, so a file this route returns is a file that create will accept.
+
+        :param id: The file id returned by the upload, e.g. `file-9f2c1a...`. (required)
+        :type id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._retrieve_file_serialize(
+            id=id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "FileObject",
+            '401': "OpenAIErrorEnvelope",
+            '403': "OpenAIErrorEnvelope",
+            '404': "OpenAIErrorEnvelope",
+            '429': "OpenAIErrorEnvelope",
+            '500': "OpenAIErrorEnvelope",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def retrieve_file_without_preload_content(
+        self,
+        id: Annotated[StrictStr, Field(description="The file id returned by the upload, e.g. `file-9f2c1a...`.")],
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Retrieve a file (OpenAI-compatible)
+
+        Returns the metadata for one of your uploaded files. The lookup is scoped to the organization the API key belongs to: a file id that does not exist and one that belongs to another organization both return the same 404, so this route cannot be used to probe for other tenants' ids.  Use it to check that a `training_file` is present and usable BEFORE creating a fine-tuning job — the create path performs the identical ownership check, so a file this route returns is a file that create will accept.
+
+        :param id: The file id returned by the upload, e.g. `file-9f2c1a...`. (required)
+        :type id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._retrieve_file_serialize(
+            id=id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "FileObject",
+            '401': "OpenAIErrorEnvelope",
+            '403': "OpenAIErrorEnvelope",
+            '404': "OpenAIErrorEnvelope",
+            '429': "OpenAIErrorEnvelope",
+            '500': "OpenAIErrorEnvelope",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _retrieve_file_serialize(
+        self,
+        id,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if id is not None:
+            _path_params['id'] = id
+        # process the query parameters
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'bearerAuth'
+        ]
+
+        return self.api_client.param_serialize(
+            method='GET',
+            resource_path='/files/{id}',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.9}/gpuai_sdk/api_client.py

@@ -92,7 +92,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'OpenAPI-Generator/0.3.7/python'
+        self.user_agent = 'OpenAPI-Generator/0.3.9/python'
         self.client_side_validation = configuration.client_side_validation
 
     def __enter__(self):

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.9}/gpuai_sdk/configuration.py

@@ -552,7 +552,7 @@ class Configuration:
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: 1.0.0\n"\
-               "SDK Package Version: 0.3.7".\
+               "SDK Package Version: 0.3.9".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]:

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.9}/gpuai_sdk/models/create_instance_request.py

@@ -42,13 +42,14 @@ class CreateInstanceRequest(BaseModel):
     environment: Optional[StrictStr] = Field(default=None, description="Launch environment. Omit for the provider default (the GPU.ai Certified Image where supported). Accepted values: `certified` (the GPU.ai Certified base image), `certified:<framework>` (a framework layer — see GET /v1/environments for the roster, e.g. `certified:pytorch`), `certified:<framework>@<version>` (a specific framework version, e.g. `certified:pytorch@2.13`), `raw_vm` (root VM, provider default OS), `raw_vm:<os>` (root VM with a chosen OS, e.g. `raw_vm:ubuntu-24.04`), or `provider_template` (the provider's own image). A well-formed value the placed machine can't serve returns 422 `environment_unavailable`.", json_schema_extra={"examples": ["certified:pytorch@2.13"]})
     offering_id: Optional[StrictStr] = Field(default=None, description="Pin the launch to one exact offering (from GET /v1/pricing) so the engine never substitutes a pricier one. If that offering is gone, the launch fails explicitly rather than silently placing elsewhere.")
     disk_gb: Optional[Annotated[int, Field(strict=True, ge=10)]] = Field(default=None, description="Requested instance filesystem size in GB. Omit for the platform default (100 GB), which never narrows placement. Setting it is a hard requirement: placement narrows to capacity that can honor it (see `disk_configurable` on GET /v1/pricing), and a request no offering of the gpu_type can honor returns 422 `disk_unavailable` rather than launching with a different size. When the launch also pins an exact `offering_id`, a disk_gb larger than that offering's displayed `storage_gb` returns 422 `disk_exceeds_offering` rather than launching with a clamped filesystem. Disk beyond the included allowance (100 GB) is billed at the offering's `disk_price_per_gb_hour` (GET /v1/pricing), folded into the instance's single hourly rate. Bounds: at least 10, at most the platform ceiling (currently 1000) — outside them returns 422 `validation_failed`.", json_schema_extra={"examples": [200]})
+    auto_terminate_hours: Optional[Annotated[int, Field(le=720, strict=True, ge=1)]] = Field(default=None, description="Terminate this instance automatically after this many hours of runtime. Omit for no limit (the default). The countdown starts when the instance reaches `running`, not when you call this — provisioning is neither billed nor counted against the limit — and the resolved deadline is returned as `auto_terminate_at` on every read. Enforcement is server-side and survives your process: this is the safety net for an unattended run whose client dies without cleaning up. When it fires the instance is terminated exactly as a DELETE would terminate it (billing stops, the `instance.terminated` webhook fires) and `status_reason` records that the limit was reached. Bounds: at least 1, at most 720 (30 days) — outside them returns 422 `validation_failed`. An explicit `0` is rejected rather than read as \"no limit\"; omit the field for that.", json_schema_extra={"examples": [8]})
     env: Optional[Dict[str, StrictStr]] = Field(default=None, description="Environment variables. With `template_id`: per-deploy overrides — only keys the template marks user_overridable are accepted (others 422), and secret values are redacted from operation metadata. With `image`: plain container env vars — keys must be POSIX names and the platform's reserved namespace (`PUBLIC_KEY`, `GPUAI_*`) is refused (422).")
     image: Optional[StrictStr] = Field(default=None, description="Launch from your own container image, e.g. `pytorch/pytorch:2.4.1-cuda12.4-cudnn9-devel` or `ghcr.io/acme/trainer:v1`. The image must be publicly pullable (private registries are not yet supported) and provide linux/amd64 — both are verified synchronously before anything is provisioned: an unknown image returns 422 `image_unavailable` and a registry outage 502 `registry_unreachable`, with no operation created and nothing billed. The launch is pinned to the exact manifest digest verified, so a tag re-push cannot change what boots. After SSH/tunnel setup the image's own ENTRYPOINT/CMD is started (its output is in /var/log/gpuai-entrypoint.log on the instance); an image with neither is a plain SSH environment. Placement prefers container-native capacity (the image runs natively; SSH lands inside it) and falls back to VM capacity (the image runs as a container beside the host's SSH — inspect with `docker logs gpuai-workload`); private images stay container-native. A gpu_type with no capable capacity returns 422 `image_unavailable`. Mutually exclusive with `template_id` and `environment` (422). A malformed reference (bad charset, localhost/private-IP registry) returns 400. On-demand only for now: `tier: spot` with `image` is refused (422 `validation_failed`) because a preemption re-route cannot yet carry a custom image.", json_schema_extra={"examples": ["ghcr.io/acme/trainer:v1"]})
     registry_credential_id: Optional[StrictStr] = Field(default=None, description="Stored registry-credential id (POST /v1/registry-credentials) for pulling a PRIVATE `image`. The credential's registry must match the image's registry (422 otherwise); wrong logins fail the pre-flight with 422 `image_unavailable` before anything is provisioned. Requires `image`.")
     entrypoint: Optional[List[StrictStr]] = Field(default=None, description="Override the image's ENTRYPOINT (docker semantics — also drops the image CMD unless `cmd` is given). Omit to use the image's own. At most 32 arguments / 4KB. Requires `image`.")
     cmd: Optional[List[StrictStr]] = Field(default=None, description="Override the image's CMD. Omit to use the image's own (or none, when `entrypoint` is overridden). Requires `image`.")
     ports: Optional[List[CreateInstanceRequestPortsInner]] = Field(default=None, description="Container ports to expose on a custom-image launch (at most 10; port 22 is reserved). At most one entry may be `primary` — it must be http and is served at the instance's app URL (`https://<id>.apps.gpu.ai`) behind the per-instance basic-auth login. Requires `image`.")
-    __properties: ClassVar[List[str]] = ["gpu_type", "gpu_count", "region", "tier", "ssh_key_ids", "name", "max_price_per_hour", "viewed_price_per_hour", "template_id", "environment", "offering_id", "disk_gb", "env", "image", "registry_credential_id", "entrypoint", "cmd", "ports"]
+    __properties: ClassVar[List[str]] = ["gpu_type", "gpu_count", "region", "tier", "ssh_key_ids", "name", "max_price_per_hour", "viewed_price_per_hour", "template_id", "environment", "offering_id", "disk_gb", "auto_terminate_hours", "env", "image", "registry_credential_id", "entrypoint", "cmd", "ports"]
 
     @field_validator('tier')
     def tier_validate_enum(cls, value):
@@ -127,6 +128,7 @@ class CreateInstanceRequest(BaseModel):
             "environment": obj.get("environment"),
             "offering_id": obj.get("offering_id"),
             "disk_gb": obj.get("disk_gb"),
+            "auto_terminate_hours": obj.get("auto_terminate_hours"),
             "env": obj.get("env"),
             "image": obj.get("image"),
             "registry_credential_id": obj.get("registry_credential_id"),

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.9}/gpuai_sdk/models/instance.py

@@ -42,13 +42,15 @@ class Instance(BaseModel):
     connection: Optional[InstanceConnection] = None
     disk_gb: Optional[StrictInt] = Field(default=None, description="Instance filesystem size in GB that the platform configured for this launch. Present only where the placed capacity honors a configured disk size; absent means the machine's disk is provider-determined (its own flavor volume).")
     image: Optional[StrictStr] = Field(default=None, description="The customer-supplied container image this instance was launched from, digest-pinned at verification time (e.g. `ghcr.io/acme/trainer:v1@sha256:…`). Present only on custom-image launches; template and certified launches never expose their images here.")
-    status_reason: Optional[StrictStr] = Field(default=None, description="Why the instance is in the error state, e.g. \"provisioning stalled: the instance started but never became reachable\". Present only on errored instances.")
+    auto_terminate_hours: Optional[StrictInt] = Field(default=None, description="The runtime limit this instance was launched with, in hours (the `auto_terminate_hours` you sent). Absent means the instance runs until something stops it. It stays present after the limit has fired, so a terminated instance still explains itself.", json_schema_extra={"examples": [8]})
+    auto_terminate_at: Optional[datetime] = Field(default=None, description="When the runtime limit expires and the platform terminates this instance. Computed when the instance became running (ready_at + auto_terminate_hours), so the countdown covers usable runtime, not the time spent provisioning. Absent when no limit was set, when the instance is not running yet, or once the platform has begun acting on an elapsed limit.")
+    status_reason: Optional[StrictStr] = Field(default=None, description="Why the instance stopped or failed, e.g. \"provisioning stalled: the instance started but never became reachable\", or — when a runtime limit fired — \"Terminated: this instance reached the 8-hour runtime limit set at launch\". Present only when the platform has something to explain.")
     created_at: datetime
     ready_at: Optional[datetime] = None
     terminated_at: Optional[datetime] = None
     last_reachable_at: Optional[datetime] = Field(default=None, description="Last time the platform verified the SSH path to this instance end-to-end through the tunnel. Absent means the instance has not been probed yet (freshly launched, or no tunnel) — it does NOT mean unreachable. An instance whose status is still \"running\" while this timestamp stops advancing is one whose SSH has died even though the machine is up.")
     unreachable_since: Optional[datetime] = Field(default=None, description="Start of the confirmed tunnel outage the instance is currently in. Present exactly when status is \"unreachable\", absent otherwise. It is the timestamp the auto-credit for the dead window is computed from, so a ledger credit can be reconciled against it.")
-    __properties: ClassVar[List[str]] = ["id", "name", "status", "gpu_type", "gpu_count", "region", "tier", "price_per_hour", "connection", "disk_gb", "image", "status_reason", "created_at", "ready_at", "terminated_at", "last_reachable_at", "unreachable_since"]
+    __properties: ClassVar[List[str]] = ["id", "name", "status", "gpu_type", "gpu_count", "region", "tier", "price_per_hour", "connection", "disk_gb", "image", "auto_terminate_hours", "auto_terminate_at", "status_reason", "created_at", "ready_at", "terminated_at", "last_reachable_at", "unreachable_since"]
 
     @field_validator('status')
     def status_validate_enum(cls, value):
@@ -129,6 +131,8 @@ class Instance(BaseModel):
             "connection": InstanceConnection.from_dict(obj["connection"]) if obj.get("connection") is not None else None,
             "disk_gb": obj.get("disk_gb"),
             "image": obj.get("image"),
+            "auto_terminate_hours": obj.get("auto_terminate_hours"),
+            "auto_terminate_at": obj.get("auto_terminate_at"),
             "status_reason": obj.get("status_reason"),
             "created_at": obj.get("created_at"),
             "ready_at": obj.get("ready_at"),

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.9}/gpuai_sdk/models/model.py

@@ -18,7 +18,7 @@ import pprint
 import re  # noqa: F401
 import json
 
-from pydantic import BaseModel, ConfigDict, Field, StrictInt, StrictStr, field_validator
+from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictInt, StrictStr, field_validator
 from typing import Any, ClassVar, Dict, List, Optional
 from gpuai_sdk.models.model_parameters_inner import ModelParametersInner
 from gpuai_sdk.models.model_pricing import ModelPricing
@@ -42,8 +42,10 @@ class Model(BaseModel):
     parameters: Optional[List[ModelParametersInner]] = Field(default=None, description="Typed parameter descriptors for media (image/video) models — name, type, enum/bounds/default. Playgrounds render input forms from these.")
     pricing: ModelPricing
     aliases: Optional[List[StrictStr]] = None
+    fine_tunable: Optional[StrictBool] = Field(default=None, description="Whether this model can be used as the base of a managed fine-tuning job. The tunable allowlist is operator-curated and much narrower than the serving catalog, so this is false for almost every model. Absent means false.")
+    fine_tune_base_model: Optional[StrictStr] = Field(default=None, description="The exact id to send as `model` when creating a fine-tuning job for this entry. Present only when `fine_tunable` is true, and deliberately distinct from `id`: the allowlist matches the customer-facing base id (e.g. `qwen2.5-7b-instruct`), which a served model normally carries as an alias rather than as its namespaced catalog id.")
     status: StrictStr
-    __properties: ClassVar[List[str]] = ["id", "object", "created", "owned_by", "author", "modality", "category", "context_length", "supported_parameters", "parameters", "pricing", "aliases", "status"]
+    __properties: ClassVar[List[str]] = ["id", "object", "created", "owned_by", "author", "modality", "category", "context_length", "supported_parameters", "parameters", "pricing", "aliases", "fine_tunable", "fine_tune_base_model", "status"]
 
     @field_validator('object')
     def object_validate_enum(cls, value):
@@ -139,6 +141,8 @@ class Model(BaseModel):
             "parameters": [ModelParametersInner.from_dict(_item) for _item in obj["parameters"]] if obj.get("parameters") is not None else None,
             "pricing": ModelPricing.from_dict(obj["pricing"]) if obj.get("pricing") is not None else None,
             "aliases": obj.get("aliases"),
+            "fine_tunable": obj.get("fine_tunable"),
+            "fine_tune_base_model": obj.get("fine_tune_base_model"),
             "status": obj.get("status")
         })
         return _obj

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.9}/gpuai_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gpuai-sdk
-Version: 0.3.7
+Version: 0.3.9
 Summary: GPU.ai Public Developer API
 Home-page: 
 Author: GPU.ai Support
@@ -26,7 +26,7 @@ the dashboard. See https://gpu.ai/docs for details.
 This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: 1.0.0
-- Package version: 0.3.7
+- Package version: 0.3.9
 - Generator version: 7.24.0
 - Build package: org.openapitools.codegen.languages.PythonClientCodegen
 
@@ -136,6 +136,7 @@ Class | Method | HTTP request | Description
 *FineTuningApi* | [**get_fine_tuning_job**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/FineTuningApi.md#get_fine_tuning_job) | **GET** /fine_tuning/jobs/{id} | Retrieve a fine-tuning job (OpenAI-compatible)
 *FineTuningApi* | [**list_fine_tuning_job_events**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/FineTuningApi.md#list_fine_tuning_job_events) | **GET** /fine_tuning/jobs/{id}/events | List fine-tuning job events (OpenAI-compatible)
 *FineTuningApi* | [**list_fine_tuning_jobs**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/FineTuningApi.md#list_fine_tuning_jobs) | **GET** /fine_tuning/jobs | List fine-tuning jobs (OpenAI-compatible)
+*FineTuningApi* | [**retrieve_file**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/FineTuningApi.md#retrieve_file) | **GET** /files/{id} | Retrieve a file (OpenAI-compatible)
 *GpuTypesApi* | [**list_gpu_types**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/GpuTypesApi.md#list_gpu_types) | **GET** /gpu-types | List available GPU types (no auth required)
 *InferenceApi* | [**cancel_video**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/InferenceApi.md#cancel_video) | **POST** /videos/{id}/cancel | Cancel a video generation job
 *InferenceApi* | [**create_chat_completion**](https://github.com/gpuai-dev/gpuai-python-sdk/blob/main/docs/InferenceApi.md#create_chat_completion) | **POST** /chat/completions | Create a chat completion (OpenAI-compatible)

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.9}/pyproject.toml

@@ -6,7 +6,7 @@ name = "gpuai-sdk"
 # injected tree. This file is ignore-protected (see .openapi-generator-ignore)
 # so the placeholder survives regeneration; sdk/release/assert-placeholder.sh
 # fails CI if a real version ever lands here.
-version = "0.3.7"
+version = "0.3.9"
 description = "GPU.ai Public Developer API"
 authors = [
   {name = "GPU.ai Support",email = "support@gpu.ai"},

{gpuai_sdk-0.3.7 → gpuai_sdk-0.3.9}/setup.py

@@ -20,7 +20,7 @@ from setuptools import setup, find_packages  # noqa: H301
 # prerequisite: setuptools
 # http://pypi.python.org/pypi/setuptools
 NAME = "gpuai-sdk"
-VERSION = "0.3.7"
+VERSION = "0.3.9"
 PYTHON_REQUIRES = ">= 3.10"
 REQUIRES = [
     "urllib3 >= 2.6.3, < 3.0.0",