> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nugen.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Import a base model from Hugging Face or cloud storage

> Import a base model from Hugging Face or a cloud storage bucket.

**Request Body:**

- `source_type`: `huggingface`, `s3`, `gs`, `oci` or `abfss`
- `source_uri`: Hugging Face repo id or a cloud storage URI
- `base_model_name`: Name to register the imported model under
- `token`: Access token or credential for the source



## OpenAPI

````yaml https://api.nugen.in/openapi-public.json post /api/v3/models/base/import
openapi: 3.1.0
info:
  title: Nugen Intelligence API
  description: >+
    Nugen Intelligence: Powering Specialized Intelligence At Scale.


    **Need an API key?** Sign up, log in to the platform and generate an API
    key.


    **Need help?** Sign up, log in to the platform and raise a support ticket.


    **What this API does.** Align models to your domain corpus and run them with

    confidence. Train-time alignment builds domain-aligned adaptors through

    proprietary methods spanning pre-training, supervised and reinforcement

    stages. Inference-time alignment quantifies uncertainty across the full

    generation trajectory, producing confidence scores and keeping every

    response on domain.


    **Workflow.** Upload documents, create or generate a benchmark, create an

    alignment project, receive an aligned model id. That one id serves chat

    completions, completions, embeddings and reranking, and its embeddings carry

    your domain's representation space, making retrieval domain aware. You
    define the success

    criteria for your domain; the platform handles the deep learning, the GPUs

    and the data preparation.


    **Authentication.** Every endpoint requires an API key sent as a Bearer
    token:

    `Authorization: Bearer <api_key>`.

  contact:
    name: Nugen Intelligence - Customer Support
    url: https://nugen.in/signup
    email: support@nugen.in
  version: 25.4.20
servers:
  - url: https://api.nugen.in
    description: Production
security: []
paths:
  /api/v3/models/base/import:
    post:
      tags:
        - Models
      summary: Import a base model from Hugging Face or cloud storage
      description: |-
        Import a base model from Hugging Face or a cloud storage bucket.

        **Request Body:**

        - `source_type`: `huggingface`, `s3`, `gs`, `oci` or `abfss`
        - `source_uri`: Hugging Face repo id or a cloud storage URI
        - `base_model_name`: Name to register the imported model under
        - `token`: Access token or credential for the source
      operationId: import_base_model
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImportBaseModelRequest'
        required: true
      responses:
        '200':
          description: Acknowledges the import request for the base model.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportBaseModelResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    ImportBaseModelRequest:
      properties:
        source_type:
          type: string
          title: Source Type
          description: huggingface, s3, gs, oci or abfss
        source_uri:
          type: string
          title: Source Uri
          description: >-
            Hugging Face repo id, e.g. org/model-name, or a cloud storage URI
            such as s3://bucket/path
        base_model_name:
          type: string
          title: Base Model Name
          description: Name to register the imported model under
        token:
          anyOf:
            - type: string
            - type: 'null'
          title: Token
          description: >-
            Access token or credential for the source. Used only to perform the
            import; never logged or stored.
      type: object
      required:
        - source_type
        - source_uri
        - base_model_name
      title: ImportBaseModelRequest
      description: Import a base model from Hugging Face or a cloud storage bucket.
    ImportBaseModelResponse:
      properties:
        import_id:
          type: string
          title: Import Id
          description: Identifier of the import request.
        status:
          type: string
          title: Status
          description: Import request status.
        message:
          type: string
          title: Message
          description: Human-readable outcome of the request.
      type: object
      required:
        - import_id
        - status
        - message
      title: ImportBaseModelResponse
      description: Acknowledgement of a base model import request.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````