chore: add model name as a parameter support during import via API

[louis-jan]

Describe Your Changes

• When importing a model via API from Jan, the model's display name is extracted from the GGUF metadata but most of them are poorly defined. E.g. just model or blank space. This chore update allow clients to decide the model name. Also provided the missing API doc schema.

1. When making a request to import a model, I should be able to provide it's name.

2. The imported model should have the name updated accordingly

3. I should be able to see Model Import API on the scalar API reference

Changes made

1. In models.cc:

   • A new variable modelName is extracted from the JSON request.
   • A check is added to throw an error if modelHandle is empty.
   • The name field of model_config is updated with modelName if it's not empty.

2. In test_api_model_import.py:

   • The existing test case is slightly modified (changing json = body_json to json=body_json).
   • Three new test cases are added:
     a. Testing model import with a custom name (marked to skip by default).
     b. Testing model import with an invalid path (expected to fail).
     c. Testing model import with a missing model (expected to fail).

3. A new endpoint /v1/models/import is added:

   • It's a POST request for importing a model.
   • The operation ID is "ModelsController_importModel".
   • It requires a request body with a schema referencing "#/components/schemas/ImportModelRequest".
   • The response for a successful import (200 status) includes a schema referencing "#/components/schemas/ImportModelResponse".

4. Two new schemas are added:

   • ImportModelRequest:

     • Contains properties for "model" (identifier), "modelPath" (file path), and "name" (display name).
     • "model" and "modelPath" are required fields.

   • ImportModelResponse:

     • Contains properties for "message" (success message), "modelHandle" (unique identifier), and "result" (status).
     • All fields are required.

5. Pull with a desired name

6. Update Model Pull API doc

These changes enhance the model import functionality by allowing custom names and adding more robust error checking. The new test cases improve the coverage of the API's behavior under different scenarios. Also provided the missing API doc, with appropriate request and response structures defined in the OpenAPI specification.

Self Checklist

• Added relevant comments, esp in complex areas
• Updated docs (for bug fixes / features)
• Created issues for follow-up changes or refactoring needed

[github-actions]

Preview URL: https://4e75f7b6.cortex-docs.pages.dev

[namchuai]

✅ lgtm

[namchuai]

However, it would be great if you can do the same for model pull api 🙏

[louis-jan]

However, it would be great if you can do the same for model pull api 🙏

Ye adding here 🚀