All Products
Search

This Product

    Hologres:GetInstanceModel

    Document Center

    Hologres:GetInstanceModel

    Last Updated:May 14, 2026

    Large model services bound to the Hologres instance

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request syntax

    GET /api/v1/instances/{instanceId}/getInstanceModel HTTP/1.1

    Path Parameters

    Parameter

    Type

    Required

    Description

    Example
    instanceId

    string

    No

    The ID of the instance.

    hgpostcn-cn-7mz2vmuxxxx

    Request parameters

    Parameter

    Type

    Required

    Description

    Example

    No parameters required.

    Response elements

    Element

    Type

    Description

    Example

    object

    The returned data.

    requestId

    string

    The ID of the request.

    819A7F0F-2951-540F-BD94-6A41ECF0281F
    cpu

    integer

    The total number of CPU cores on the node. This parameter is returned only for a Hologres AI node.

    32
    gpu

    integer

    The total number of GPUs on the node. This parameter is returned only for a Hologres AI node.

    4
    memory

    integer

    The total memory on the node. This parameter is returned only for a Hologres AI node.

    128
    gpuMemory

    integer

    The total GPU memory on the node. This parameter is returned only for a Hologres AI node.

    128
    modelServiceList

    array<object>

    A list of model services.

    object

    gpuMemory

    integer

    The GPU memory that the model service uses. This parameter is returned only for a Hologres AI node.

    32
    memory

    integer

    The memory that the model service uses. This parameter is returned only for a Hologres AI node.

    32
    cpu

    integer

    The number of CPU cores that the model service uses. This parameter is returned only for a Hologres AI node.

    32
    modelType

    string

    The model type.

    qwen3.5-plus
    gpu

    integer

    The number of GPUs that the model service uses. This parameter is returned only for a Hologres AI node.

    2
    status

    string

    The status of the model service.

    Running
    modelName

    string

    The user-defined name of the model service.

    my_model
    serviceCount

    integer

    The number of service replicas. This parameter is returned only for a Hologres AI node.

    2
    version

    string

    The version of the model service.

    v1.1
    message

    string

    The error message.

    Failed
    taskType

    string

    The task type of the model.

    embedding
    modelParams

    string

    The parameters of the model. This parameter is returned only for models from Model Studio.

    {"timeout":600,"max_retries":10,"max_retry_delay":8,"initial_retry_delay":0.5}
    apiKey

    string

    The API key for Model Studio. This key is for display only and cannot be used for direct API calls.

    sk-42f6c8xxxxxb
    provider

    string

    The provider of the underlying model. For example, the value bailian indicates Model Studio.

    bailian
    instanceRegion

    string

    The deployment region of the Hologres AI node.

    cn-beijing
    serviceDeployRegion

    string

    The deployment region of the model service.

    cn-beijing
    cpuUsed

    integer

    The total CPU cores used across all nodes. This parameter is returned only for a Hologres AI node.

    32
    memoryUsed

    integer

    The total memory used across all nodes. This parameter is returned only for a Hologres AI node.

    64
    gpuUsed

    integer

    The total GPUs used across all nodes. This parameter is returned only for a Hologres AI node.

    2
    aiInstanceId

    string

    The instance ID of the Hologres AI node.

    hologram_aicombo_public_cn-77xxx
    gpuMemoryUsed

    integer

    The total GPU memory used across all nodes. This parameter is returned only for a Hologres AI node.

    64
    regionId

    string

    The region ID.

    cn-shanghai
    resourceType

    string

    The resource type.

    Valid values:

    • small :

      Small

    • middle :

      Medium

    • large :

      Large

    middle
    nodeCount

    integer

    The number of nodes.

    2
    commodityCode

    string

    The commodity code.

    hologram_aipostpay_public_cn
    chargeType

    string

    The billing method. Valid values:

    • PrePaid: subscription

    • PostPaid: pay-as-you-go

    PrePaid
    status

    string

    The status of the node.

    Valid values:

    • ResourceReady :

      The node is running.

    • InstanceWaiting :

      The node is being created.

    ResourceReady
    expirationTime

    string

    The expiration time in UTC.

    2026-01-28T07:44:27.535Z
    autoRenewal

    boolean

    Indicates whether auto-renewal is enabled for the resource.

    • true: Auto-renewal is enabled.

    • false: Auto-renewal is disabled. The resource is suspended upon expiration.

    true

    Examples

    Success response

    JSON format

    {
  "requestId": "819A7F0F-2951-540F-BD94-6A41ECF0281F",
  "cpu": 32,
  "gpu": 4,
  "memory": 128,
  "gpuMemory": 128,
  "modelServiceList": [
    {
      "gpuMemory": 32,
      "memory": 32,
      "cpu": 32,
      "modelType": "qwen3.5-plus",
      "gpu": 2,
      "status": "Running",
      "modelName": "my_model",
      "serviceCount": 2,
      "version": "v1.1",
      "message": "Failed",
      "taskType": "embedding",
      "modelParams": "{\"timeout\":600,\"max_retries\":10,\"max_retry_delay\":8,\"initial_retry_delay\":0.5}",
      "apiKey": "sk-42f6c8xxxxxb",
      "provider": "bailian",
      "instanceRegion": "cn-beijing",
      "serviceDeployRegion": "cn-beijing"
    }
  ],
  "cpuUsed": 32,
  "memoryUsed": 64,
  "gpuUsed": 2,
  "aiInstanceId": "hologram_aicombo_public_cn-77xxx",
  "gpuMemoryUsed": 64,
  "regionId": "cn-shanghai",
  "resourceType": "middle",
  "nodeCount": 2,
  "commodityCode": "hologram_aipostpay_public_cn",
  "chargeType": "PrePaid",
  "status": "ResourceReady",
  "expirationTime": "2026-01-28T07:44:27.535Z",
  "autoRenewal": true
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.