The model list endpoint provides information about the currently available models. There are two ways to retrieve model details.
  1. Request details of all available models.
  2. Request details about a specific model.

​
Base URL

The base URL is the same when requesting details for all available models or a specific model. 
https://api.sambanova.ai/
For SambaStack, developers should check with their system administrator for the correct URL.

​
All available models

The examples below describe how to request details for all available models.

​
Endpoint

GET /v1/models

​
Example response

The example below demonstrates the response for all available models.
In our example, we only list three models.
{
    "data": [
      {
        "id": "DeepSeek-R1",
        "object": "model",
        "owned_by": "no-reply@sambanova.ai",
        "context_length": 16384,
        "max_completion_tokens": 16384,
        "pricing": {
          "prompt": "0.00000500",
          "completion": "0.00000700"
        }
      },
      {
        "id": "DeepSeek-R1-Distill-Llama-70B",
        "object": "model",
        "owned_by": "no-reply@sambanova.ai",
        "context_length": 131072,
        "max_completion_tokens": 4096,
        "pricing": {
          "prompt": "0.00000070",
          "completion": "0.00000140"
        }
      },
      {
        "id": "DeepSeek-V3-0324",
        "object": "model",
        "owned_by": "no-reply@sambanova.ai",
        "context_length": 8192,
        "max_completion_tokens": 4096,
        "pricing": {
          "prompt": "0.00000100",
          "completion": "0.00000150"
        }
      }
    ],
    "object": "list"
}

​
Response fields

The table below describes the response fields along with their types and descriptions when requesting details for all available models.
FieldTypeDescription
dataArrayList of available models.
idStringThe model ID.
objectStringType of object (always “model”).
owned_byStringThe owner of the model.
context_lengthIntegerMaximum supported context length in tokens.
max_completion_tokensIntegerMaximum tokens that can be generated per request.
pricing.completionStringPrice per completion token.
pricing.promptStringPrice per prompt token.

​
Specific model

The examples below describe how to request details for a specific model.

​
Endpoint

GET /v1/models/{model_id}

​
Path parameter

Parameter: model_id The official ID name of the model to query (e.g., DeepSeek-R1). Refer to the SambaCloud models list.

​
Example response

The example below demonstrates the response for a specific model. 
{
  "id": "DeepSeek-R1",
  "object": "model",
  "owned_by": "no-reply@sambanova.ai",
  "context_length": 16384,
  "max_completion_tokens": 16384,
  "pricing": {
    "prompt": "0.00000500",
    "completion": "0.00000700"
  }
}

​
Response fields

The table below describes the response fields along with their types and descriptions when requesting details for a specific model.
FieldTypeDescription
idStringThe model ID.
objectStringType of object (always “model”).
owned_byStringThe owner of the model.
context_lengthIntegerMaximum supported context length in tokens.
max_completion_tokensIntegerMaximum tokens that can be generated per request.
pricing.completionStringPrice per completion token.
pricing.promptStringPrice per prompt token.