oci.GenerativeAi.Model
Explore with Pulumi AI
This resource provides the Model resource in Oracle Cloud Infrastructure Generative AI service.
Creates a custom model by fine-tuning a base model with your own dataset. You can create a new custom models or create a new version of existing custom model..
The header contains an opc-work-request-id, which is the id for the WorkRequest that tracks the model creation progress.
Create Model Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Model(name: string, args: ModelArgs, opts?: CustomResourceOptions);
@overload
def Model(resource_name: str,
args: ModelArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Model(resource_name: str,
opts: Optional[ResourceOptions] = None,
base_model_id: Optional[str] = None,
compartment_id: Optional[str] = None,
fine_tune_details: Optional[_generativeai.ModelFineTuneDetailsArgs] = None,
defined_tags: Optional[Mapping[str, str]] = None,
description: Optional[str] = None,
display_name: Optional[str] = None,
freeform_tags: Optional[Mapping[str, str]] = None,
vendor: Optional[str] = None,
version: Optional[str] = None)
func NewModel(ctx *Context, name string, args ModelArgs, opts ...ResourceOption) (*Model, error)
public Model(string name, ModelArgs args, CustomResourceOptions? opts = null)
type: oci:GenerativeAi:Model
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args ModelArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args ModelArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args ModelArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ModelArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ModelArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var examplemodelResourceResourceFromGenerativeAimodel = new Oci.GenerativeAi.Model("examplemodelResourceResourceFromGenerativeAimodel", new()
{
BaseModelId = "string",
CompartmentId = "string",
FineTuneDetails = new Oci.GenerativeAi.Inputs.ModelFineTuneDetailsArgs
{
DedicatedAiClusterId = "string",
TrainingDataset = new Oci.GenerativeAi.Inputs.ModelFineTuneDetailsTrainingDatasetArgs
{
Bucket = "string",
DatasetType = "string",
Namespace = "string",
Object = "string",
},
TrainingConfig = new Oci.GenerativeAi.Inputs.ModelFineTuneDetailsTrainingConfigArgs
{
TrainingConfigType = "string",
EarlyStoppingPatience = 0,
EarlyStoppingThreshold = 0,
LearningRate = 0,
LogModelMetricsIntervalInSteps = 0,
LoraAlpha = 0,
LoraDropout = 0,
LoraR = 0,
NumOfLastLayers = 0,
TotalTrainingEpochs = 0,
TrainingBatchSize = 0,
},
},
DefinedTags =
{
{ "string", "string" },
},
Description = "string",
DisplayName = "string",
FreeformTags =
{
{ "string", "string" },
},
Vendor = "string",
Version = "string",
});
example, err := GenerativeAi.NewModel(ctx, "examplemodelResourceResourceFromGenerativeAimodel", &GenerativeAi.ModelArgs{
BaseModelId: pulumi.String("string"),
CompartmentId: pulumi.String("string"),
FineTuneDetails: &generativeai.ModelFineTuneDetailsArgs{
DedicatedAiClusterId: pulumi.String("string"),
TrainingDataset: &generativeai.ModelFineTuneDetailsTrainingDatasetArgs{
Bucket: pulumi.String("string"),
DatasetType: pulumi.String("string"),
Namespace: pulumi.String("string"),
Object: pulumi.String("string"),
},
TrainingConfig: &generativeai.ModelFineTuneDetailsTrainingConfigArgs{
TrainingConfigType: pulumi.String("string"),
EarlyStoppingPatience: pulumi.Int(0),
EarlyStoppingThreshold: pulumi.Float64(0),
LearningRate: pulumi.Float64(0),
LogModelMetricsIntervalInSteps: pulumi.Int(0),
LoraAlpha: pulumi.Int(0),
LoraDropout: pulumi.Float64(0),
LoraR: pulumi.Int(0),
NumOfLastLayers: pulumi.Int(0),
TotalTrainingEpochs: pulumi.Int(0),
TrainingBatchSize: pulumi.Int(0),
},
},
DefinedTags: pulumi.StringMap{
"string": pulumi.String("string"),
},
Description: pulumi.String("string"),
DisplayName: pulumi.String("string"),
FreeformTags: pulumi.StringMap{
"string": pulumi.String("string"),
},
Vendor: pulumi.String("string"),
Version: pulumi.String("string"),
})
var examplemodelResourceResourceFromGenerativeAimodel = new Model("examplemodelResourceResourceFromGenerativeAimodel", ModelArgs.builder()
.baseModelId("string")
.compartmentId("string")
.fineTuneDetails(ModelFineTuneDetailsArgs.builder()
.dedicatedAiClusterId("string")
.trainingDataset(ModelFineTuneDetailsTrainingDatasetArgs.builder()
.bucket("string")
.datasetType("string")
.namespace("string")
.object("string")
.build())
.trainingConfig(ModelFineTuneDetailsTrainingConfigArgs.builder()
.trainingConfigType("string")
.earlyStoppingPatience(0)
.earlyStoppingThreshold(0)
.learningRate(0)
.logModelMetricsIntervalInSteps(0)
.loraAlpha(0)
.loraDropout(0)
.loraR(0)
.numOfLastLayers(0)
.totalTrainingEpochs(0)
.trainingBatchSize(0)
.build())
.build())
.definedTags(Map.of("string", "string"))
.description("string")
.displayName("string")
.freeformTags(Map.of("string", "string"))
.vendor("string")
.version("string")
.build());
examplemodel_resource_resource_from_generative_aimodel = oci.generative_ai.Model("examplemodelResourceResourceFromGenerativeAimodel",
base_model_id="string",
compartment_id="string",
fine_tune_details=oci.generative_ai.ModelFineTuneDetailsArgs(
dedicated_ai_cluster_id="string",
training_dataset=oci.generative_ai.ModelFineTuneDetailsTrainingDatasetArgs(
bucket="string",
dataset_type="string",
namespace="string",
object="string",
),
training_config=oci.generative_ai.ModelFineTuneDetailsTrainingConfigArgs(
training_config_type="string",
early_stopping_patience=0,
early_stopping_threshold=0,
learning_rate=0,
log_model_metrics_interval_in_steps=0,
lora_alpha=0,
lora_dropout=0,
lora_r=0,
num_of_last_layers=0,
total_training_epochs=0,
training_batch_size=0,
),
),
defined_tags={
"string": "string",
},
description="string",
display_name="string",
freeform_tags={
"string": "string",
},
vendor="string",
version="string")
const examplemodelResourceResourceFromGenerativeAimodel = new oci.generativeai.Model("examplemodelResourceResourceFromGenerativeAimodel", {
baseModelId: "string",
compartmentId: "string",
fineTuneDetails: {
dedicatedAiClusterId: "string",
trainingDataset: {
bucket: "string",
datasetType: "string",
namespace: "string",
object: "string",
},
trainingConfig: {
trainingConfigType: "string",
earlyStoppingPatience: 0,
earlyStoppingThreshold: 0,
learningRate: 0,
logModelMetricsIntervalInSteps: 0,
loraAlpha: 0,
loraDropout: 0,
loraR: 0,
numOfLastLayers: 0,
totalTrainingEpochs: 0,
trainingBatchSize: 0,
},
},
definedTags: {
string: "string",
},
description: "string",
displayName: "string",
freeformTags: {
string: "string",
},
vendor: "string",
version: "string",
});
type: oci:GenerativeAi:Model
properties:
baseModelId: string
compartmentId: string
definedTags:
string: string
description: string
displayName: string
fineTuneDetails:
dedicatedAiClusterId: string
trainingConfig:
earlyStoppingPatience: 0
earlyStoppingThreshold: 0
learningRate: 0
logModelMetricsIntervalInSteps: 0
loraAlpha: 0
loraDropout: 0
loraR: 0
numOfLastLayers: 0
totalTrainingEpochs: 0
trainingBatchSize: 0
trainingConfigType: string
trainingDataset:
bucket: string
datasetType: string
namespace: string
object: string
freeformTags:
string: string
vendor: string
version: string
Model Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The Model resource accepts the following input properties:
- Base
Model stringId - The OCID of the base model that's used for fine-tuning.
- Compartment
Id string - (Updatable) The compartment OCID for fine-tuned models. For pretrained models, this value is null.
- Fine
Tune ModelDetails Fine Tune Details - Details about fine-tuning a custom model.
- Dictionary<string, string>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- Description string
- (Updatable) An optional description of the model.
- Display
Name string - (Updatable) A user-friendly name.
- Dictionary<string, string>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- Vendor string
- (Updatable) The provider of the model.
- Version string
(Updatable) The version of the model.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Base
Model stringId - The OCID of the base model that's used for fine-tuning.
- Compartment
Id string - (Updatable) The compartment OCID for fine-tuned models. For pretrained models, this value is null.
- Fine
Tune ModelDetails Fine Tune Details Args - Details about fine-tuning a custom model.
- map[string]string
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- Description string
- (Updatable) An optional description of the model.
- Display
Name string - (Updatable) A user-friendly name.
- map[string]string
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- Vendor string
- (Updatable) The provider of the model.
- Version string
(Updatable) The version of the model.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- base
Model StringId - The OCID of the base model that's used for fine-tuning.
- compartment
Id String - (Updatable) The compartment OCID for fine-tuned models. For pretrained models, this value is null.
- fine
Tune ModelDetails Fine Tune Details - Details about fine-tuning a custom model.
- Map<String,String>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- description String
- (Updatable) An optional description of the model.
- display
Name String - (Updatable) A user-friendly name.
- Map<String,String>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- vendor String
- (Updatable) The provider of the model.
- version String
(Updatable) The version of the model.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- base
Model stringId - The OCID of the base model that's used for fine-tuning.
- compartment
Id string - (Updatable) The compartment OCID for fine-tuned models. For pretrained models, this value is null.
- fine
Tune ModelDetails Fine Tune Details - Details about fine-tuning a custom model.
- {[key: string]: string}
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- description string
- (Updatable) An optional description of the model.
- display
Name string - (Updatable) A user-friendly name.
- {[key: string]: string}
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- vendor string
- (Updatable) The provider of the model.
- version string
(Updatable) The version of the model.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- base_
model_ strid - The OCID of the base model that's used for fine-tuning.
- compartment_
id str - (Updatable) The compartment OCID for fine-tuned models. For pretrained models, this value is null.
- fine_
tune_ generativeai.details Model Fine Tune Details Args - Details about fine-tuning a custom model.
- Mapping[str, str]
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- description str
- (Updatable) An optional description of the model.
- display_
name str - (Updatable) A user-friendly name.
- Mapping[str, str]
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- vendor str
- (Updatable) The provider of the model.
- version str
(Updatable) The version of the model.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- base
Model StringId - The OCID of the base model that's used for fine-tuning.
- compartment
Id String - (Updatable) The compartment OCID for fine-tuned models. For pretrained models, this value is null.
- fine
Tune Property MapDetails - Details about fine-tuning a custom model.
- Map<String>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- description String
- (Updatable) An optional description of the model.
- display
Name String - (Updatable) A user-friendly name.
- Map<String>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- vendor String
- (Updatable) The provider of the model.
- version String
(Updatable) The version of the model.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
Outputs
All input properties are implicitly available as output properties. Additionally, the Model resource produces the following output properties:
- Capabilities List<string>
- Describes what this model can be used for.
- Id string
- The provider-assigned unique ID for this managed resource.
- Is
Long boolTerm Supported - Whether a model is supported long-term. Only applicable to base models.
- Lifecycle
Details string - A message describing the current state of the model in more detail that can provide actionable information.
- Model
Metrics List<ModelModel Metric> - Model metrics during the creation of a new model.
- State string
- The lifecycle state of the model.
- Dictionary<string, string>
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"}
- Time
Created string - The date and time that the model was created in the format of an RFC3339 datetime string.
- Time
Deprecated string - Corresponds to the time when the custom model and its associated foundation model will be deprecated.
- Time
Updated string - The date and time that the model was updated in the format of an RFC3339 datetime string.
- Type string
- The model type indicating whether this is a pretrained/base model or a custom/fine-tuned model.
- Capabilities []string
- Describes what this model can be used for.
- Id string
- The provider-assigned unique ID for this managed resource.
- Is
Long boolTerm Supported - Whether a model is supported long-term. Only applicable to base models.
- Lifecycle
Details string - A message describing the current state of the model in more detail that can provide actionable information.
- Model
Metrics []ModelModel Metric - Model metrics during the creation of a new model.
- State string
- The lifecycle state of the model.
- map[string]string
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"}
- Time
Created string - The date and time that the model was created in the format of an RFC3339 datetime string.
- Time
Deprecated string - Corresponds to the time when the custom model and its associated foundation model will be deprecated.
- Time
Updated string - The date and time that the model was updated in the format of an RFC3339 datetime string.
- Type string
- The model type indicating whether this is a pretrained/base model or a custom/fine-tuned model.
- capabilities List<String>
- Describes what this model can be used for.
- id String
- The provider-assigned unique ID for this managed resource.
- is
Long BooleanTerm Supported - Whether a model is supported long-term. Only applicable to base models.
- lifecycle
Details String - A message describing the current state of the model in more detail that can provide actionable information.
- model
Metrics List<ModelModel Metric> - Model metrics during the creation of a new model.
- state String
- The lifecycle state of the model.
- Map<String,String>
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created String - The date and time that the model was created in the format of an RFC3339 datetime string.
- time
Deprecated String - Corresponds to the time when the custom model and its associated foundation model will be deprecated.
- time
Updated String - The date and time that the model was updated in the format of an RFC3339 datetime string.
- type String
- The model type indicating whether this is a pretrained/base model or a custom/fine-tuned model.
- capabilities string[]
- Describes what this model can be used for.
- id string
- The provider-assigned unique ID for this managed resource.
- is
Long booleanTerm Supported - Whether a model is supported long-term. Only applicable to base models.
- lifecycle
Details string - A message describing the current state of the model in more detail that can provide actionable information.
- model
Metrics ModelModel Metric[] - Model metrics during the creation of a new model.
- state string
- The lifecycle state of the model.
- {[key: string]: string}
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created string - The date and time that the model was created in the format of an RFC3339 datetime string.
- time
Deprecated string - Corresponds to the time when the custom model and its associated foundation model will be deprecated.
- time
Updated string - The date and time that the model was updated in the format of an RFC3339 datetime string.
- type string
- The model type indicating whether this is a pretrained/base model or a custom/fine-tuned model.
- capabilities Sequence[str]
- Describes what this model can be used for.
- id str
- The provider-assigned unique ID for this managed resource.
- is_
long_ boolterm_ supported - Whether a model is supported long-term. Only applicable to base models.
- lifecycle_
details str - A message describing the current state of the model in more detail that can provide actionable information.
- model_
metrics Sequence[generativeai.Model Model Metric] - Model metrics during the creation of a new model.
- state str
- The lifecycle state of the model.
- Mapping[str, str]
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time_
created str - The date and time that the model was created in the format of an RFC3339 datetime string.
- time_
deprecated str - Corresponds to the time when the custom model and its associated foundation model will be deprecated.
- time_
updated str - The date and time that the model was updated in the format of an RFC3339 datetime string.
- type str
- The model type indicating whether this is a pretrained/base model or a custom/fine-tuned model.
- capabilities List<String>
- Describes what this model can be used for.
- id String
- The provider-assigned unique ID for this managed resource.
- is
Long BooleanTerm Supported - Whether a model is supported long-term. Only applicable to base models.
- lifecycle
Details String - A message describing the current state of the model in more detail that can provide actionable information.
- model
Metrics List<Property Map> - Model metrics during the creation of a new model.
- state String
- The lifecycle state of the model.
- Map<String>
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created String - The date and time that the model was created in the format of an RFC3339 datetime string.
- time
Deprecated String - Corresponds to the time when the custom model and its associated foundation model will be deprecated.
- time
Updated String - The date and time that the model was updated in the format of an RFC3339 datetime string.
- type String
- The model type indicating whether this is a pretrained/base model or a custom/fine-tuned model.
Look up Existing Model Resource
Get an existing Model resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: ModelState, opts?: CustomResourceOptions): Model
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
base_model_id: Optional[str] = None,
capabilities: Optional[Sequence[str]] = None,
compartment_id: Optional[str] = None,
defined_tags: Optional[Mapping[str, str]] = None,
description: Optional[str] = None,
display_name: Optional[str] = None,
fine_tune_details: Optional[_generativeai.ModelFineTuneDetailsArgs] = None,
freeform_tags: Optional[Mapping[str, str]] = None,
is_long_term_supported: Optional[bool] = None,
lifecycle_details: Optional[str] = None,
model_metrics: Optional[Sequence[_generativeai.ModelModelMetricArgs]] = None,
state: Optional[str] = None,
system_tags: Optional[Mapping[str, str]] = None,
time_created: Optional[str] = None,
time_deprecated: Optional[str] = None,
time_updated: Optional[str] = None,
type: Optional[str] = None,
vendor: Optional[str] = None,
version: Optional[str] = None) -> Model
func GetModel(ctx *Context, name string, id IDInput, state *ModelState, opts ...ResourceOption) (*Model, error)
public static Model Get(string name, Input<string> id, ModelState? state, CustomResourceOptions? opts = null)
public static Model get(String name, Output<String> id, ModelState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Base
Model stringId - The OCID of the base model that's used for fine-tuning.
- Capabilities List<string>
- Describes what this model can be used for.
- Compartment
Id string - (Updatable) The compartment OCID for fine-tuned models. For pretrained models, this value is null.
- Dictionary<string, string>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- Description string
- (Updatable) An optional description of the model.
- Display
Name string - (Updatable) A user-friendly name.
- Fine
Tune ModelDetails Fine Tune Details - Details about fine-tuning a custom model.
- Dictionary<string, string>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- Is
Long boolTerm Supported - Whether a model is supported long-term. Only applicable to base models.
- Lifecycle
Details string - A message describing the current state of the model in more detail that can provide actionable information.
- Model
Metrics List<ModelModel Metric> - Model metrics during the creation of a new model.
- State string
- The lifecycle state of the model.
- Dictionary<string, string>
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"}
- Time
Created string - The date and time that the model was created in the format of an RFC3339 datetime string.
- Time
Deprecated string - Corresponds to the time when the custom model and its associated foundation model will be deprecated.
- Time
Updated string - The date and time that the model was updated in the format of an RFC3339 datetime string.
- Type string
- The model type indicating whether this is a pretrained/base model or a custom/fine-tuned model.
- Vendor string
- (Updatable) The provider of the model.
- Version string
(Updatable) The version of the model.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- Base
Model stringId - The OCID of the base model that's used for fine-tuning.
- Capabilities []string
- Describes what this model can be used for.
- Compartment
Id string - (Updatable) The compartment OCID for fine-tuned models. For pretrained models, this value is null.
- map[string]string
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- Description string
- (Updatable) An optional description of the model.
- Display
Name string - (Updatable) A user-friendly name.
- Fine
Tune ModelDetails Fine Tune Details Args - Details about fine-tuning a custom model.
- map[string]string
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- Is
Long boolTerm Supported - Whether a model is supported long-term. Only applicable to base models.
- Lifecycle
Details string - A message describing the current state of the model in more detail that can provide actionable information.
- Model
Metrics []ModelModel Metric Args - Model metrics during the creation of a new model.
- State string
- The lifecycle state of the model.
- map[string]string
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"}
- Time
Created string - The date and time that the model was created in the format of an RFC3339 datetime string.
- Time
Deprecated string - Corresponds to the time when the custom model and its associated foundation model will be deprecated.
- Time
Updated string - The date and time that the model was updated in the format of an RFC3339 datetime string.
- Type string
- The model type indicating whether this is a pretrained/base model or a custom/fine-tuned model.
- Vendor string
- (Updatable) The provider of the model.
- Version string
(Updatable) The version of the model.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- base
Model StringId - The OCID of the base model that's used for fine-tuning.
- capabilities List<String>
- Describes what this model can be used for.
- compartment
Id String - (Updatable) The compartment OCID for fine-tuned models. For pretrained models, this value is null.
- Map<String,String>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- description String
- (Updatable) An optional description of the model.
- display
Name String - (Updatable) A user-friendly name.
- fine
Tune ModelDetails Fine Tune Details - Details about fine-tuning a custom model.
- Map<String,String>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- is
Long BooleanTerm Supported - Whether a model is supported long-term. Only applicable to base models.
- lifecycle
Details String - A message describing the current state of the model in more detail that can provide actionable information.
- model
Metrics List<ModelModel Metric> - Model metrics during the creation of a new model.
- state String
- The lifecycle state of the model.
- Map<String,String>
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created String - The date and time that the model was created in the format of an RFC3339 datetime string.
- time
Deprecated String - Corresponds to the time when the custom model and its associated foundation model will be deprecated.
- time
Updated String - The date and time that the model was updated in the format of an RFC3339 datetime string.
- type String
- The model type indicating whether this is a pretrained/base model or a custom/fine-tuned model.
- vendor String
- (Updatable) The provider of the model.
- version String
(Updatable) The version of the model.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- base
Model stringId - The OCID of the base model that's used for fine-tuning.
- capabilities string[]
- Describes what this model can be used for.
- compartment
Id string - (Updatable) The compartment OCID for fine-tuned models. For pretrained models, this value is null.
- {[key: string]: string}
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- description string
- (Updatable) An optional description of the model.
- display
Name string - (Updatable) A user-friendly name.
- fine
Tune ModelDetails Fine Tune Details - Details about fine-tuning a custom model.
- {[key: string]: string}
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- is
Long booleanTerm Supported - Whether a model is supported long-term. Only applicable to base models.
- lifecycle
Details string - A message describing the current state of the model in more detail that can provide actionable information.
- model
Metrics ModelModel Metric[] - Model metrics during the creation of a new model.
- state string
- The lifecycle state of the model.
- {[key: string]: string}
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created string - The date and time that the model was created in the format of an RFC3339 datetime string.
- time
Deprecated string - Corresponds to the time when the custom model and its associated foundation model will be deprecated.
- time
Updated string - The date and time that the model was updated in the format of an RFC3339 datetime string.
- type string
- The model type indicating whether this is a pretrained/base model or a custom/fine-tuned model.
- vendor string
- (Updatable) The provider of the model.
- version string
(Updatable) The version of the model.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- base_
model_ strid - The OCID of the base model that's used for fine-tuning.
- capabilities Sequence[str]
- Describes what this model can be used for.
- compartment_
id str - (Updatable) The compartment OCID for fine-tuned models. For pretrained models, this value is null.
- Mapping[str, str]
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- description str
- (Updatable) An optional description of the model.
- display_
name str - (Updatable) A user-friendly name.
- fine_
tune_ generativeai.details Model Fine Tune Details Args - Details about fine-tuning a custom model.
- Mapping[str, str]
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- is_
long_ boolterm_ supported - Whether a model is supported long-term. Only applicable to base models.
- lifecycle_
details str - A message describing the current state of the model in more detail that can provide actionable information.
- model_
metrics Sequence[generativeai.Model Model Metric Args] - Model metrics during the creation of a new model.
- state str
- The lifecycle state of the model.
- Mapping[str, str]
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time_
created str - The date and time that the model was created in the format of an RFC3339 datetime string.
- time_
deprecated str - Corresponds to the time when the custom model and its associated foundation model will be deprecated.
- time_
updated str - The date and time that the model was updated in the format of an RFC3339 datetime string.
- type str
- The model type indicating whether this is a pretrained/base model or a custom/fine-tuned model.
- vendor str
- (Updatable) The provider of the model.
- version str
(Updatable) The version of the model.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
- base
Model StringId - The OCID of the base model that's used for fine-tuning.
- capabilities List<String>
- Describes what this model can be used for.
- compartment
Id String - (Updatable) The compartment OCID for fine-tuned models. For pretrained models, this value is null.
- Map<String>
- (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:
{"Operations.CostCenter": "42"}
- description String
- (Updatable) An optional description of the model.
- display
Name String - (Updatable) A user-friendly name.
- fine
Tune Property MapDetails - Details about fine-tuning a custom model.
- Map<String>
- (Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example:
{"Department": "Finance"}
- is
Long BooleanTerm Supported - Whether a model is supported long-term. Only applicable to base models.
- lifecycle
Details String - A message describing the current state of the model in more detail that can provide actionable information.
- model
Metrics List<Property Map> - Model metrics during the creation of a new model.
- state String
- The lifecycle state of the model.
- Map<String>
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"}
- time
Created String - The date and time that the model was created in the format of an RFC3339 datetime string.
- time
Deprecated String - Corresponds to the time when the custom model and its associated foundation model will be deprecated.
- time
Updated String - The date and time that the model was updated in the format of an RFC3339 datetime string.
- type String
- The model type indicating whether this is a pretrained/base model or a custom/fine-tuned model.
- vendor String
- (Updatable) The provider of the model.
- version String
(Updatable) The version of the model.
** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values
Supporting Types
ModelFineTuneDetails, ModelFineTuneDetailsArgs
- Dedicated
Ai stringCluster Id - The OCID of the dedicated AI cluster this fine-tuning runs on.
- Training
Dataset ModelFine Tune Details Training Dataset The dataset used to fine-tune the model.
Only one dataset is allowed per custom model, which is split 80-20 for training and validating. You must provide the dataset in a JSON Lines (JSONL) file. Each line in the JSONL file must have the format:
{"prompt": "<first prompt>", "completion": "<expected completion given first prompt>"}
- Training
Config ModelFine Tune Details Training Config - The fine-tuning method and hyperparameters used for fine-tuning a custom model.
- Dedicated
Ai stringCluster Id - The OCID of the dedicated AI cluster this fine-tuning runs on.
- Training
Dataset ModelFine Tune Details Training Dataset The dataset used to fine-tune the model.
Only one dataset is allowed per custom model, which is split 80-20 for training and validating. You must provide the dataset in a JSON Lines (JSONL) file. Each line in the JSONL file must have the format:
{"prompt": "<first prompt>", "completion": "<expected completion given first prompt>"}
- Training
Config ModelFine Tune Details Training Config - The fine-tuning method and hyperparameters used for fine-tuning a custom model.
- dedicated
Ai StringCluster Id - The OCID of the dedicated AI cluster this fine-tuning runs on.
- training
Dataset ModelFine Tune Details Training Dataset The dataset used to fine-tune the model.
Only one dataset is allowed per custom model, which is split 80-20 for training and validating. You must provide the dataset in a JSON Lines (JSONL) file. Each line in the JSONL file must have the format:
{"prompt": "<first prompt>", "completion": "<expected completion given first prompt>"}
- training
Config ModelFine Tune Details Training Config - The fine-tuning method and hyperparameters used for fine-tuning a custom model.
- dedicated
Ai stringCluster Id - The OCID of the dedicated AI cluster this fine-tuning runs on.
- training
Dataset ModelFine Tune Details Training Dataset The dataset used to fine-tune the model.
Only one dataset is allowed per custom model, which is split 80-20 for training and validating. You must provide the dataset in a JSON Lines (JSONL) file. Each line in the JSONL file must have the format:
{"prompt": "<first prompt>", "completion": "<expected completion given first prompt>"}
- training
Config ModelFine Tune Details Training Config - The fine-tuning method and hyperparameters used for fine-tuning a custom model.
- dedicated_
ai_ strcluster_ id - The OCID of the dedicated AI cluster this fine-tuning runs on.
- training_
dataset generativeai.Model Fine Tune Details Training Dataset The dataset used to fine-tune the model.
Only one dataset is allowed per custom model, which is split 80-20 for training and validating. You must provide the dataset in a JSON Lines (JSONL) file. Each line in the JSONL file must have the format:
{"prompt": "<first prompt>", "completion": "<expected completion given first prompt>"}
- training_
config generativeai.Model Fine Tune Details Training Config - The fine-tuning method and hyperparameters used for fine-tuning a custom model.
- dedicated
Ai StringCluster Id - The OCID of the dedicated AI cluster this fine-tuning runs on.
- training
Dataset Property Map The dataset used to fine-tune the model.
Only one dataset is allowed per custom model, which is split 80-20 for training and validating. You must provide the dataset in a JSON Lines (JSONL) file. Each line in the JSONL file must have the format:
{"prompt": "<first prompt>", "completion": "<expected completion given first prompt>"}
- training
Config Property Map - The fine-tuning method and hyperparameters used for fine-tuning a custom model.
ModelFineTuneDetailsTrainingConfig, ModelFineTuneDetailsTrainingConfigArgs
- Training
Config stringType - The fine-tuning method for training a custom model.
- Early
Stopping intPatience - Stop training if the loss metric does not improve beyond 'early_stopping_threshold' for this many times of evaluation.
- Early
Stopping doubleThreshold - How much the loss must improve to prevent early stopping.
- Learning
Rate double - The initial learning rate to be used during training
- Log
Model intMetrics Interval In Steps Determines how frequently to log model metrics.
Every step is logged for the first 20 steps and then follows this parameter for log frequency. Set to 0 to disable logging the model metrics.
- Lora
Alpha int - This parameter represents the scaling factor for the weight matrices in LoRA.
- Lora
Dropout double - This parameter indicates the dropout probability for LoRA layers.
- Lora
R int - This parameter represents the LoRA rank of the update matrices.
- Num
Of intLast Layers - The number of last layers to be fine-tuned.
- Total
Training intEpochs - The maximum number of training epochs to run for.
- Training
Batch intSize - The batch size used during training.
- Training
Config stringType - The fine-tuning method for training a custom model.
- Early
Stopping intPatience - Stop training if the loss metric does not improve beyond 'early_stopping_threshold' for this many times of evaluation.
- Early
Stopping float64Threshold - How much the loss must improve to prevent early stopping.
- Learning
Rate float64 - The initial learning rate to be used during training
- Log
Model intMetrics Interval In Steps Determines how frequently to log model metrics.
Every step is logged for the first 20 steps and then follows this parameter for log frequency. Set to 0 to disable logging the model metrics.
- Lora
Alpha int - This parameter represents the scaling factor for the weight matrices in LoRA.
- Lora
Dropout float64 - This parameter indicates the dropout probability for LoRA layers.
- Lora
R int - This parameter represents the LoRA rank of the update matrices.
- Num
Of intLast Layers - The number of last layers to be fine-tuned.
- Total
Training intEpochs - The maximum number of training epochs to run for.
- Training
Batch intSize - The batch size used during training.
- training
Config StringType - The fine-tuning method for training a custom model.
- early
Stopping IntegerPatience - Stop training if the loss metric does not improve beyond 'early_stopping_threshold' for this many times of evaluation.
- early
Stopping DoubleThreshold - How much the loss must improve to prevent early stopping.
- learning
Rate Double - The initial learning rate to be used during training
- log
Model IntegerMetrics Interval In Steps Determines how frequently to log model metrics.
Every step is logged for the first 20 steps and then follows this parameter for log frequency. Set to 0 to disable logging the model metrics.
- lora
Alpha Integer - This parameter represents the scaling factor for the weight matrices in LoRA.
- lora
Dropout Double - This parameter indicates the dropout probability for LoRA layers.
- lora
R Integer - This parameter represents the LoRA rank of the update matrices.
- num
Of IntegerLast Layers - The number of last layers to be fine-tuned.
- total
Training IntegerEpochs - The maximum number of training epochs to run for.
- training
Batch IntegerSize - The batch size used during training.
- training
Config stringType - The fine-tuning method for training a custom model.
- early
Stopping numberPatience - Stop training if the loss metric does not improve beyond 'early_stopping_threshold' for this many times of evaluation.
- early
Stopping numberThreshold - How much the loss must improve to prevent early stopping.
- learning
Rate number - The initial learning rate to be used during training
- log
Model numberMetrics Interval In Steps Determines how frequently to log model metrics.
Every step is logged for the first 20 steps and then follows this parameter for log frequency. Set to 0 to disable logging the model metrics.
- lora
Alpha number - This parameter represents the scaling factor for the weight matrices in LoRA.
- lora
Dropout number - This parameter indicates the dropout probability for LoRA layers.
- lora
R number - This parameter represents the LoRA rank of the update matrices.
- num
Of numberLast Layers - The number of last layers to be fine-tuned.
- total
Training numberEpochs - The maximum number of training epochs to run for.
- training
Batch numberSize - The batch size used during training.
- training_
config_ strtype - The fine-tuning method for training a custom model.
- early_
stopping_ intpatience - Stop training if the loss metric does not improve beyond 'early_stopping_threshold' for this many times of evaluation.
- early_
stopping_ floatthreshold - How much the loss must improve to prevent early stopping.
- learning_
rate float - The initial learning rate to be used during training
- log_
model_ intmetrics_ interval_ in_ steps Determines how frequently to log model metrics.
Every step is logged for the first 20 steps and then follows this parameter for log frequency. Set to 0 to disable logging the model metrics.
- lora_
alpha int - This parameter represents the scaling factor for the weight matrices in LoRA.
- lora_
dropout float - This parameter indicates the dropout probability for LoRA layers.
- lora_
r int - This parameter represents the LoRA rank of the update matrices.
- num_
of_ intlast_ layers - The number of last layers to be fine-tuned.
- total_
training_ intepochs - The maximum number of training epochs to run for.
- training_
batch_ intsize - The batch size used during training.
- training
Config StringType - The fine-tuning method for training a custom model.
- early
Stopping NumberPatience - Stop training if the loss metric does not improve beyond 'early_stopping_threshold' for this many times of evaluation.
- early
Stopping NumberThreshold - How much the loss must improve to prevent early stopping.
- learning
Rate Number - The initial learning rate to be used during training
- log
Model NumberMetrics Interval In Steps Determines how frequently to log model metrics.
Every step is logged for the first 20 steps and then follows this parameter for log frequency. Set to 0 to disable logging the model metrics.
- lora
Alpha Number - This parameter represents the scaling factor for the weight matrices in LoRA.
- lora
Dropout Number - This parameter indicates the dropout probability for LoRA layers.
- lora
R Number - This parameter represents the LoRA rank of the update matrices.
- num
Of NumberLast Layers - The number of last layers to be fine-tuned.
- total
Training NumberEpochs - The maximum number of training epochs to run for.
- training
Batch NumberSize - The batch size used during training.
ModelFineTuneDetailsTrainingDataset, ModelFineTuneDetailsTrainingDatasetArgs
- Bucket string
- The Object Storage bucket name.
- Dataset
Type string - The type of the data asset.
- Namespace string
- The Object Storage namespace.
- Object string
- The Object Storage object name.
- Bucket string
- The Object Storage bucket name.
- Dataset
Type string - The type of the data asset.
- Namespace string
- The Object Storage namespace.
- Object string
- The Object Storage object name.
- bucket String
- The Object Storage bucket name.
- dataset
Type String - The type of the data asset.
- namespace String
- The Object Storage namespace.
- object String
- The Object Storage object name.
- bucket string
- The Object Storage bucket name.
- dataset
Type string - The type of the data asset.
- namespace string
- The Object Storage namespace.
- object string
- The Object Storage object name.
- bucket str
- The Object Storage bucket name.
- dataset_
type str - The type of the data asset.
- namespace str
- The Object Storage namespace.
- object str
- The Object Storage object name.
- bucket String
- The Object Storage bucket name.
- dataset
Type String - The type of the data asset.
- namespace String
- The Object Storage namespace.
- object String
- The Object Storage object name.
ModelModelMetric, ModelModelMetricArgs
- Final
Accuracy double - Fine-tuned model accuracy.
- Final
Loss double - Fine-tuned model loss.
- Model
Metrics stringType - The type of the model metrics. Each type of model can expect a different set of model metrics.
- Final
Accuracy float64 - Fine-tuned model accuracy.
- Final
Loss float64 - Fine-tuned model loss.
- Model
Metrics stringType - The type of the model metrics. Each type of model can expect a different set of model metrics.
- final
Accuracy Double - Fine-tuned model accuracy.
- final
Loss Double - Fine-tuned model loss.
- model
Metrics StringType - The type of the model metrics. Each type of model can expect a different set of model metrics.
- final
Accuracy number - Fine-tuned model accuracy.
- final
Loss number - Fine-tuned model loss.
- model
Metrics stringType - The type of the model metrics. Each type of model can expect a different set of model metrics.
- final_
accuracy float - Fine-tuned model accuracy.
- final_
loss float - Fine-tuned model loss.
- model_
metrics_ strtype - The type of the model metrics. Each type of model can expect a different set of model metrics.
- final
Accuracy Number - Fine-tuned model accuracy.
- final
Loss Number - Fine-tuned model loss.
- model
Metrics StringType - The type of the model metrics. Each type of model can expect a different set of model metrics.
Import
Models can be imported using the id
, e.g.
$ pulumi import oci:GenerativeAi/model:Model test_model "id"
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- oci pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
oci
Terraform Provider.