@gpuai/sdk 0.3.8 → 0.3.10

package/README.md

@@ -1,4 +1,4 @@
-# @gpuai/sdk@0.3.8
+# @gpuai/sdk@0.3.10
 
 A TypeScript SDK client for the api.gpu.ai API.
 
@@ -72,6 +72,7 @@ All URIs are relative to *https://api.gpu.ai/v1*
 *FineTuningApi* | [**getFineTuningJob**](docs/FineTuningApi.md#getfinetuningjob) | **GET** /fine_tuning/jobs/{id} | Retrieve a fine-tuning job (OpenAI-compatible)
 *FineTuningApi* | [**listFineTuningJobEvents**](docs/FineTuningApi.md#listfinetuningjobevents) | **GET** /fine_tuning/jobs/{id}/events | List fine-tuning job events (OpenAI-compatible)
 *FineTuningApi* | [**listFineTuningJobs**](docs/FineTuningApi.md#listfinetuningjobs) | **GET** /fine_tuning/jobs | List fine-tuning jobs (OpenAI-compatible)
+*FineTuningApi* | [**retrieveFile**](docs/FineTuningApi.md#retrievefile) | **GET** /files/{id} | Retrieve a file (OpenAI-compatible)
 *GpuTypesApi* | [**listGpuTypes**](docs/GpuTypesApi.md#listgputypes) | **GET** /gpu-types | List available GPU types (no auth required)
 *InferenceApi* | [**cancelVideo**](docs/InferenceApi.md#cancelvideo) | **POST** /videos/{id}/cancel | Cancel a video generation job
 *InferenceApi* | [**createChatCompletion**](docs/InferenceApi.md#createchatcompletion) | **POST** /chat/completions | Create a chat completion (OpenAI-compatible)
@@ -203,7 +204,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `1.0.0`
-- Package version: `0.3.8`
+- Package version: `0.3.10`
 - Generator version: `7.24.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/FineTuningApi.d.ts

@@ -37,6 +37,9 @@ export interface ListFineTuningJobsRequest {
     after?: string;
     limit?: number;
 }
+export interface RetrieveFileRequest {
+    id: string;
+}
 /**
  *
  */
@@ -113,6 +116,20 @@ export declare class FineTuningApi extends runtime.BaseAPI {
      * List fine-tuning jobs (OpenAI-compatible)
      */
     listFineTuningJobs(requestParameters?: ListFineTuningJobsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FineTuningJobList>;
+    /**
+     * Creates request options for retrieveFile without sending the request
+     */
+    retrieveFileRequestOpts(requestParameters: RetrieveFileRequest): Promise<runtime.RequestOpts>;
+    /**
+     * 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.
+     * Retrieve a file (OpenAI-compatible)
+     */
+    retrieveFileRaw(requestParameters: RetrieveFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileObject>>;
+    /**
+     * 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.
+     * Retrieve a file (OpenAI-compatible)
+     */
+    retrieveFile(requestParameters: RetrieveFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileObject>;
 }
 /**
  * @export

package/dist/apis/FineTuningApi.js

@@ -342,6 +342,54 @@ class FineTuningApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for retrieveFile without sending the request
+     */
+    retrieveFileRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['id'] == null) {
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling retrieveFile().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/files/{id}`;
+            urlPath = urlPath.replace('{id}', encodeURIComponent(String(requestParameters['id'])));
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * 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.
+     * Retrieve a file (OpenAI-compatible)
+     */
+    retrieveFileRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.retrieveFileRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, FileObject_1.FileObjectFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * 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.
+     * Retrieve a file (OpenAI-compatible)
+     */
+    retrieveFile(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.retrieveFileRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
 }
 exports.FineTuningApi = FineTuningApi;
 /**

package/dist/esm/apis/FineTuningApi.d.ts

@@ -37,6 +37,9 @@ export interface ListFineTuningJobsRequest {
     after?: string;
     limit?: number;
 }
+export interface RetrieveFileRequest {
+    id: string;
+}
 /**
  *
  */
@@ -113,6 +116,20 @@ export declare class FineTuningApi extends runtime.BaseAPI {
      * List fine-tuning jobs (OpenAI-compatible)
      */
     listFineTuningJobs(requestParameters?: ListFineTuningJobsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FineTuningJobList>;
+    /**
+     * Creates request options for retrieveFile without sending the request
+     */
+    retrieveFileRequestOpts(requestParameters: RetrieveFileRequest): Promise<runtime.RequestOpts>;
+    /**
+     * 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.
+     * Retrieve a file (OpenAI-compatible)
+     */
+    retrieveFileRaw(requestParameters: RetrieveFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileObject>>;
+    /**
+     * 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.
+     * Retrieve a file (OpenAI-compatible)
+     */
+    retrieveFile(requestParameters: RetrieveFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileObject>;
 }
 /**
  * @export

package/dist/esm/apis/FineTuningApi.js

@@ -339,6 +339,54 @@ export class FineTuningApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for retrieveFile without sending the request
+     */
+    retrieveFileRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['id'] == null) {
+                throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling retrieveFile().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/files/{id}`;
+            urlPath = urlPath.replace('{id}', encodeURIComponent(String(requestParameters['id'])));
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * 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.
+     * Retrieve a file (OpenAI-compatible)
+     */
+    retrieveFileRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.retrieveFileRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => FileObjectFromJSON(jsonValue));
+        });
+    }
+    /**
+     * 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.
+     * Retrieve a file (OpenAI-compatible)
+     */
+    retrieveFile(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.retrieveFileRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
 }
 /**
  * @export

package/dist/esm/models/CreateInstanceRequest.d.ts

@@ -115,13 +115,13 @@ export interface CreateInstanceRequest {
      */
     registryCredentialId?: string;
     /**
-     * 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`.
+     * Override the image's ENTRYPOINT (docker semantics — also drops the image CMD unless `cmd` is given). Omit to use the image's own; an explicit empty array clears it while keeping the image CMD (docker `--entrypoint ""` semantics). Empty strings inside a non-empty argv are rejected (422). At most 32 arguments / 4KB. Requires `image`.
      * @type {Array<string>}
      * @memberof CreateInstanceRequest
      */
     entrypoint?: Array<string>;
     /**
-     * Override the image's CMD. Omit to use the image's own (or none, when `entrypoint` is overridden). Requires `image`.
+     * Override the image's CMD. Omit to use the image's own (or none, when `entrypoint` is overridden with a non-empty argv; an empty-array entrypoint clear keeps the image CMD). An explicit empty array clears the CMD. Empty strings inside a non-empty argv are rejected (422). Requires `image`.
      * @type {Array<string>}
      * @memberof CreateInstanceRequest
      */

package/dist/esm/models/Model.d.ts

@@ -89,6 +89,18 @@ export interface Model {
      * @memberof Model
      */
     aliases?: Array<string>;
+    /**
+     * 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.
+     * @type {boolean}
+     * @memberof Model
+     */
+    fineTunable?: boolean;
+    /**
+     * 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.
+     * @type {string}
+     * @memberof Model
+     */
+    fineTuneBaseModel?: string;
     /**
      *
      * @type {ModelStatusEnum}

package/dist/esm/models/Model.js

@@ -75,6 +75,8 @@ export function ModelFromJSONTyped(json, ignoreDiscriminator) {
         'parameters': json['parameters'] == null ? undefined : (json['parameters'].map(ModelParametersInnerFromJSON)),
         'pricing': ModelPricingFromJSON(json['pricing']),
         'aliases': json['aliases'] == null ? undefined : json['aliases'],
+        'fineTunable': json['fine_tunable'] == null ? undefined : json['fine_tunable'],
+        'fineTuneBaseModel': json['fine_tune_base_model'] == null ? undefined : json['fine_tune_base_model'],
         'status': json['status'],
     };
 }
@@ -98,6 +100,8 @@ export function ModelToJSONTyped(value, ignoreDiscriminator = false) {
         'parameters': value['parameters'] == null ? undefined : (value['parameters'].map(ModelParametersInnerToJSON)),
         'pricing': ModelPricingToJSON(value['pricing']),
         'aliases': value['aliases'],
+        'fine_tunable': value['fineTunable'],
+        'fine_tune_base_model': value['fineTuneBaseModel'],
         'status': value['status'],
     };
 }

package/dist/models/CreateInstanceRequest.d.ts

@@ -115,13 +115,13 @@ export interface CreateInstanceRequest {
      */
     registryCredentialId?: string;
     /**
-     * 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`.
+     * Override the image's ENTRYPOINT (docker semantics — also drops the image CMD unless `cmd` is given). Omit to use the image's own; an explicit empty array clears it while keeping the image CMD (docker `--entrypoint ""` semantics). Empty strings inside a non-empty argv are rejected (422). At most 32 arguments / 4KB. Requires `image`.
      * @type {Array<string>}
      * @memberof CreateInstanceRequest
      */
     entrypoint?: Array<string>;
     /**
-     * Override the image's CMD. Omit to use the image's own (or none, when `entrypoint` is overridden). Requires `image`.
+     * Override the image's CMD. Omit to use the image's own (or none, when `entrypoint` is overridden with a non-empty argv; an empty-array entrypoint clear keeps the image CMD). An explicit empty array clears the CMD. Empty strings inside a non-empty argv are rejected (422). Requires `image`.
      * @type {Array<string>}
      * @memberof CreateInstanceRequest
      */

package/dist/models/Model.d.ts

@@ -89,6 +89,18 @@ export interface Model {
      * @memberof Model
      */
     aliases?: Array<string>;
+    /**
+     * 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.
+     * @type {boolean}
+     * @memberof Model
+     */
+    fineTunable?: boolean;
+    /**
+     * 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.
+     * @type {string}
+     * @memberof Model
+     */
+    fineTuneBaseModel?: string;
     /**
      *
      * @type {ModelStatusEnum}

package/dist/models/Model.js

@@ -83,6 +83,8 @@ function ModelFromJSONTyped(json, ignoreDiscriminator) {
         'parameters': json['parameters'] == null ? undefined : (json['parameters'].map(ModelParametersInner_1.ModelParametersInnerFromJSON)),
         'pricing': (0, ModelPricing_1.ModelPricingFromJSON)(json['pricing']),
         'aliases': json['aliases'] == null ? undefined : json['aliases'],
+        'fineTunable': json['fine_tunable'] == null ? undefined : json['fine_tunable'],
+        'fineTuneBaseModel': json['fine_tune_base_model'] == null ? undefined : json['fine_tune_base_model'],
         'status': json['status'],
     };
 }
@@ -106,6 +108,8 @@ function ModelToJSONTyped(value, ignoreDiscriminator = false) {
         'parameters': value['parameters'] == null ? undefined : (value['parameters'].map(ModelParametersInner_1.ModelParametersInnerToJSON)),
         'pricing': (0, ModelPricing_1.ModelPricingToJSON)(value['pricing']),
         'aliases': value['aliases'],
+        'fine_tunable': value['fineTunable'],
+        'fine_tune_base_model': value['fineTuneBaseModel'],
         'status': value['status'],
     };
 }

package/docs/FineTuningApi.md

@@ -10,6 +10,7 @@ All URIs are relative to *https://api.gpu.ai/v1*
 | [**getFineTuningJob**](FineTuningApi.md#getfinetuningjob) | **GET** /fine_tuning/jobs/{id} | Retrieve a fine-tuning job (OpenAI-compatible) |
 | [**listFineTuningJobEvents**](FineTuningApi.md#listfinetuningjobevents) | **GET** /fine_tuning/jobs/{id}/events | List fine-tuning job events (OpenAI-compatible) |
 | [**listFineTuningJobs**](FineTuningApi.md#listfinetuningjobs) | **GET** /fine_tuning/jobs | List fine-tuning jobs (OpenAI-compatible) |
+| [**retrieveFile**](FineTuningApi.md#retrievefile) | **GET** /files/{id} | Retrieve a file (OpenAI-compatible) |
 
 
 
@@ -466,3 +467,79 @@ example().catch(console.error);
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
+
+## retrieveFile
+
+> FileObject retrieveFile(id)
+
+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.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  FineTuningApi,
+} from '@gpuai/sdk';
+import type { RetrieveFileRequest } from '@gpuai/sdk';
+
+async function example() {
+  console.log("🚀 Testing @gpuai/sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new FineTuningApi(config);
+
+  const body = {
+    // string | The file id returned by the upload, e.g. `file-9f2c1a...`.
+    id: id_example,
+  } satisfies RetrieveFileRequest;
+
+  try {
+    const data = await api.retrieveFile(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **id** | `string` | The file id returned by the upload, e.g. `file-9f2c1a...`. | [Defaults to `undefined`] |
+
+### Return type
+
+[**FileObject**](FileObject.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | The file object. |  -  |
+| **401** | Missing or invalid API key (OpenAI error envelope). |  -  |
+| **403** | API key lacks the required scope (OpenAI error envelope). |  -  |
+| **404** | Model or resource not found (OpenAI error envelope). |  -  |
+| **429** | Rate limit exceeded (OpenAI error envelope). Retry-After header indicates seconds to wait. |  * Retry-After - Seconds the client should wait before retrying. <br>  |
+| **500** | Internal server error (OpenAI error envelope). |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+

package/docs/Model.md

@@ -18,6 +18,8 @@ Name | Type
 `parameters` | [Array<ModelParametersInner>](ModelParametersInner.md)
 `pricing` | [ModelPricing](ModelPricing.md)
 `aliases` | Array<string>
+`fineTunable` | boolean
+`fineTuneBaseModel` | string
 `status` | string
 
 ## Example
@@ -39,6 +41,8 @@ const example = {
   "parameters": null,
   "pricing": null,
   "aliases": null,
+  "fineTunable": null,
+  "fineTuneBaseModel": null,
   "status": null,
 } satisfies Model
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gpuai/sdk",
-  "version": "0.3.8",
+  "version": "0.3.10",
   "description": "TypeScript SDK for the GPU.ai Public Developer API",
   "author": "GPU.ai Support <support@gpu.ai>",
   "repository": {

package/src/apis/FineTuningApi.ts

@@ -72,6 +72,10 @@ export interface ListFineTuningJobsRequest {
     limit?: number;
 }
 
+export interface RetrieveFileRequest {
+    id: string;
+}
+
 /**
  * 
  */
@@ -436,6 +440,61 @@ export class FineTuningApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * Creates request options for retrieveFile without sending the request
+     */
+    async retrieveFileRequestOpts(requestParameters: RetrieveFileRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError(
+                'id',
+                'Required parameter "id" was null or undefined when calling retrieveFile().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/files/{id}`;
+        urlPath = urlPath.replace('{id}', encodeURIComponent(String(requestParameters['id'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * 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.
+     * Retrieve a file (OpenAI-compatible)
+     */
+    async retrieveFileRaw(requestParameters: RetrieveFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileObject>> {
+        const requestOptions = await this.retrieveFileRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FileObjectFromJSON(jsonValue));
+    }
+
+    /**
+     * 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.
+     * Retrieve a file (OpenAI-compatible)
+     */
+    async retrieveFile(requestParameters: RetrieveFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileObject> {
+        const response = await this.retrieveFileRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
 }
 
 /**

package/src/models/CreateInstanceRequest.ts

@@ -124,13 +124,13 @@ export interface CreateInstanceRequest {
      */
     registryCredentialId?: string;
     /**
-     * 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`.
+     * Override the image's ENTRYPOINT (docker semantics — also drops the image CMD unless `cmd` is given). Omit to use the image's own; an explicit empty array clears it while keeping the image CMD (docker `--entrypoint ""` semantics). Empty strings inside a non-empty argv are rejected (422). At most 32 arguments / 4KB. Requires `image`.
      * @type {Array<string>}
      * @memberof CreateInstanceRequest
      */
     entrypoint?: Array<string>;
     /**
-     * Override the image's CMD. Omit to use the image's own (or none, when `entrypoint` is overridden). Requires `image`.
+     * Override the image's CMD. Omit to use the image's own (or none, when `entrypoint` is overridden with a non-empty argv; an empty-array entrypoint clear keeps the image CMD). An explicit empty array clears the CMD. Empty strings inside a non-empty argv are rejected (422). Requires `image`.
      * @type {Array<string>}
      * @memberof CreateInstanceRequest
      */

package/src/models/Model.ts

@@ -106,6 +106,18 @@ export interface Model {
      * @memberof Model
      */
     aliases?: Array<string>;
+    /**
+     * 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.
+     * @type {boolean}
+     * @memberof Model
+     */
+    fineTunable?: boolean;
+    /**
+     * 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.
+     * @type {string}
+     * @memberof Model
+     */
+    fineTuneBaseModel?: string;
     /**
      * 
      * @type {ModelStatusEnum}
@@ -181,6 +193,8 @@ export function ModelFromJSONTyped(json: any, ignoreDiscriminator: boolean): Mod
         'parameters': json['parameters'] == null ? undefined : ((json['parameters'] as Array<any>).map(ModelParametersInnerFromJSON)),
         'pricing': ModelPricingFromJSON(json['pricing']),
         'aliases': json['aliases'] == null ? undefined : json['aliases'],
+        'fineTunable': json['fine_tunable'] == null ? undefined : json['fine_tunable'],
+        'fineTuneBaseModel': json['fine_tune_base_model'] == null ? undefined : json['fine_tune_base_model'],
         'status': json['status'],
     };
 }
@@ -208,6 +222,8 @@ export function ModelToJSONTyped(value?: Model | null, ignoreDiscriminator: bool
         'parameters': value['parameters'] == null ? undefined : ((value['parameters'] as Array<any>).map(ModelParametersInnerToJSON)),
         'pricing': ModelPricingToJSON(value['pricing']),
         'aliases': value['aliases'],
+        'fine_tunable': value['fineTunable'],
+        'fine_tune_base_model': value['fineTuneBaseModel'],
         'status': value['status'],
     };
 }