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

# Get a model

> Retrieves a custom model's metadata, visibility, weight information, and base-model relationship.



## OpenAPI

````yaml GET /projects/{projectId}/models/{id}
openapi: 3.1.0
info:
  title: Together APIs
  description: The Together REST API. See https://docs.together.ai for more details.
  version: 2.0.0
  termsOfService: https://www.together.ai/terms-of-service
  contact:
    name: Together Support
    url: https://www.together.ai/contact
  license:
    name: MIT
    url: https://github.com/togethercomputer/openapi/blob/main/LICENSE
servers:
  - url: https://api.together.ai/v1
    description: Default environment for APIs
  - url: https://api-inference.together.ai/v2
    description: Optimized environment for inference
security:
  - bearerAuth: []
paths:
  /projects/{projectId}/models/{id}:
    get:
      tags:
        - VolumeService
      summary: Get a model
      description: >-
        Retrieves a custom model's metadata, visibility, weight information, and
        base-model relationship.
      operationId: VolumeService_GetModel
      parameters:
        - name: projectId
          in: path
          required: true
          schema:
            description: Project identifier.
            type: string
        - name: id
          in: path
          required: true
          schema:
            description: Model identifier.
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DE.Model'
        default:
          description: Default error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorData'
      servers:
        - url: https://api.together.ai/v2
components:
  schemas:
    DE.Model:
      description: >-
        Custom or derived model registered in a project and backed by versioned
        weight files.
      type: object
      required:
        - id
        - projectId
        - organizationId
        - name
        - weights
        - visibility
      properties:
        id:
          type: string
          description: Unique model identifier.
        projectId:
          type: string
          description: ID of the project that owns the model.
        organizationId:
          type: string
          description: ID of the organization that owns the model's project.
        name:
          type: string
          description: >-
            Project-qualified model name in the form
            `<project_slug>/<model_name>`. Create and update requests may use
            the bare or qualified form.
        description:
          type: string
          description: Human-readable description of the model and its intended use.
        weights:
          $ref: '#/components/schemas/DE.ModelWeights'
          description: >-
            Architecture, size, precision, and speculative-decoding metadata
            derived from the model files.
        baseModelId:
          type: string
          description: >-
            ID of the supported or custom base model from which this model was
            derived.
        baseModel:
          type: string
          readOnly: true
          description: >-
            Resource name of the base model, using
            `projects/{baseProject}/models/{baseModelId}`; empty when the model
            has no base.
        visibility:
          default: VISIBILITY_PRIVATE
          enum:
            - VISIBILITY_PRIVATE
            - VISIBILITY_INTERNAL
          type: string
          description: >-
            Who can discover the model. `VISIBILITY_PRIVATE` restricts it to the
            project; `VISIBILITY_INTERNAL` shares it with the organization.
    ErrorData:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              nullable: false
            type:
              type: string
              nullable: false
            param:
              type: string
              nullable: true
              default: null
            code:
              type: string
              nullable: true
              default: null
          required:
            - type
            - message
    DE.ModelWeights:
      type: object
      properties:
        type:
          enum:
            - WEIGHTS_TYPE_DEFAULT
            - WEIGHTS_TYPE_SPECULATOR
            - WEIGHTS_TYPE_ADAPTER
          type: string
          description: >-
            Role of the weights: full model, speculative draft model, or LoRA
            adapter.
        speculatorMechanism:
          enum:
            - SPECULATOR_MECHANISM_DRAFT
            - SPECULATOR_MECHANISM_LOOKAHEAD
            - SPECULATOR_MECHANISM_MTP
          type: string
          description: Speculative decoding mechanism for speculator weights.
        draftSpeculatorType:
          enum:
            - DRAFT_SPECULATOR_TYPE_EAGLE
            - DRAFT_SPECULATOR_TYPE_PHOENIX
          type: string
          description: Draft-model speculator family for draft speculative decoding.
        architecture:
          type: string
          description: Model architecture detected from the weight metadata.
        contextLength:
          type: string
          description: Maximum context length reported by the model metadata.
        parameters:
          $ref: '#/components/schemas/DE.ModelParameters'
          description: Total parameter count and breakdown by numerical data type.
      description: >-
        Architecture, size, precision, and speculative-decoding metadata for
        model weights.
    DE.ModelParameters:
      type: object
      required:
        - total
        - byDtype
      properties:
        total:
          type: string
          description: Total number of parameters in the model weights.
        byDtype:
          type: array
          items:
            $ref: '#/components/schemas/DE.ModelDTypeCount'
          description: Parameter counts grouped by numerical data type.
      description: Model parameter count and precision breakdown.
    DE.ModelDTypeCount:
      type: object
      required:
        - dtype
        - count
      properties:
        dtype:
          type: string
          description: Numerical data type, such as `float16`, `bfloat16`, or `int8`.
        count:
          type: string
          description: Number of model parameters stored with this data type.
      description: Number of model parameters stored in one numerical data type.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      x-bearer-format: bearer
      x-default: default

````