Skip to main content
The Model Suites API allows you to create, retrieve, and list model suites. A model suite is a collection of model lines provided by a model provider.

​
Resource

​
ModelSuite

​
name
string
required
Resource name with pattern modelProviders/{model_provider}/modelSuites/{model_suite}
​
display_name
string
required
Human-readable nickname for this ModelSuite
​
description
string
Human-readable string to describe the usage of this model suite
​
create_time
Timestamp
When the ModelSuite was created

​
Methods

​
CreateModelSuite

Creates a new ModelSuite.
​
parent
string
required
Resource name of the parent ModelProvider.Format: modelProviders/{model_provider}
​
model_suite
ModelSuite
required
The ModelSuite to create. The name field will be ignored, and the system will assign an ID.Required fields:
  • display_name: Human-readable nickname
Response Returns the created ModelSuite resource. Example Request 
CreateModelSuiteRequest {
  parent: "modelProviders/123"
  model_suite: {
    display_name: "Production Model Suite"
    description: "Primary model suite for production workloads"
  }
}

​
GetModelSuite

Returns the ModelSuite with the specified resource key.
​
name
string
required
Resource name of the ModelSuite to retrieve.Format: modelProviders/{model_provider}/modelSuites/{model_suite}
Response Returns a ModelSuite resource. Example Request 
GetModelSuiteRequest {
  name: "modelProviders/123/modelSuites/456"
}

​
ListModelSuites

Lists ModelSuite resources for a given ModelProvider.
​
parent
string
required
Resource name of the parent ModelProvider.Format: modelProviders/{model_provider}
​
page_size
int32
The maximum number of ModelSuites to return. The service may return fewer than this value.
  • If unspecified, at most 50 ModelSuites will be returned
  • Maximum value is 1000; values above 1000 will be coerced to 1000
​
page_token
string
A page token received from a previous ListModelSuites call. Provide this to retrieve the subsequent page.When paginating, all other parameters must match the call that provided the page token.
Response
​
model_suites
ModelSuite[]
List of ModelSuite resources
​
next_page_token
string
A token that can be sent as page_token to retrieve the next page. If omitted, there are no subsequent pages.
Example Request 
ListModelSuitesRequest {
  parent: "modelProviders/123"
  page_size: 50
}

Build docs developers (and LLMs) love

Get started for freeTalk to us