Help Center> ModelArts> API Reference> AI Application Management> Creating an AI Application

Updated on 2024-06-13 GMT+08:00

View PDF

Creating an AI Application

Function

Import a meta model to create an AI application. The execution code and model must be uploaded to OBS first. By default, the model generated by a training job is stored in OBS.

Constraints

The body parameter requirements for importing a model using a template are different from those for importing a model without using a template. In the following body parameters, template parameters indicate the parameters that can be configured when a model is imported using a template, non-template parameters indicate the parameters that can be configured when a model is imported without using a template, and public parameters indicate the parameters that are irrelevant to the model import mode.

When a model is imported using a template (model_type is set to Template), the template field is mandatory and the source_location field does not need to be configured.
If a model is imported without using a template (model_type is not set to Template), source_location is mandatory and template does not need to be configured.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

URI

POST /v1/{project_id}/models

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID and Name.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. It can be obtained by calling the IAM API that is used to obtain a user token. The value of X-Subject-Token in the response header is the user token.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
model_docs	No	Array of GuideDoc objects	List of model description documents. A maximum of three documents are supported. Common parameter
template	No	template object	Configuration items in a template. This parameter is mandatory when model_type is set to Template. Template parameter
model_version	Yes	String	Model version in the format of Digit.Digit.Digit. Each digit is a one-digit or two-digit positive integer, but cannot start with 0. For example, 01.01.01 is not allowed. Common parameter
source_job_version	No	String	Version of the source training job. If the model is generated from a training job, input this parameter for source tracing. If the model is imported from a third-party meta model, leave this parameter blank. This parameter is left blank by default. Non-template parameter
source_location	Yes	String	OBS path where the model is located or the SWR image location
source_copy	No	String	Whether to enable image replication. This parameter is valid only when model_type is set to Image. Options: true: Default value, indicating that image replication is enabled. After this function is enabled, AI applications cannot be rapidly created, and modifying or deleting an image in the SWR source directory will not affect service deployment. false: Image replication is not enabled. After this function is disabled, AI applications can be rapidly created, but modifying or deleting an image in the SWR source directory will affect service deployment.
initial_config	No	String	Character string converted from the model configuration file. Obtain fields such as apis, dependencies, input_params, and output_params in the initial_config configuration file. Non-template parameter
execution_code	No	String	OBS path for storing the execution code. By default, this parameter is left blank. The name of the execution code file is consistently to be customize_service.py. The inference code file must be stored in the model directory. This parameter can be left blank. Then, the system will automatically identify the inference code in the model directory. Common parameter
source_job_id	No	String	ID of the source training job. If the model is generated from a training job, input this parameter for source tracing. If the model is imported from a third-party meta model, leave this parameter blank. This parameter is left blank by default. Non-template parameter
model_type	Yes	String	Model type. The value is TensorFlow/Image/PyTorch/Template/MindSpore, which is read from the configuration file. Common Parameters
output_params	No	Array of CreateModelRequestInferParams objects	Collection of output parameters of a model. By default, this parameter is left blank. If the parameters are read from apis in the configuration file, provide only the initial_config field, and this field can be left blank. Non-template parameter
description	No	String	Model description that consists of 1 to 100 characters. The following special characters cannot be contained: &!'"<>= Common parameter
runtime	No	String	Model runtime environment. Its possible values are determined based on model_type. For details, see Supported AI engines and their runtime
model_metrics	No	String	Model precision. If the value is read from the configuration file, this parameter can be left blank. Non-template parameter
source_type	No	String	Model source type. Currently, the value can only be auto, which is used to distinguish models deployed through ExeML (the model download function is not provided). This parameter is not required for models deployed through training jobs or other methods. It is left blank by default. Non-template parameter
dependencies	No	Array of ModelDependencies objects	Package required for inference code and model. By default, this parameter is left blank. If the package is read from the configuration file, this parameter can be left blank. Non-template parameter
workspace_id	No	String	Workspace ID, which defaults to 0. Common parameter
model_algorithm	No	String	Model algorithm. If the algorithm is read from the configuration file, this parameter can be left blank. The value can be predict_analysis, object_detection, or image_classification. Non-template parameter
apis	No	Array of CreateModelRequestModelApis objects	All API input and output parameters of the model. If the parameters are parsed from the configuration file, this parameter can be left blank. Non-template parameter
model_name	Yes	String	Model name, which consists of 1 to 64 characters. Only letters, digits, hyphens (-), and underscores (_) are allowed. Common parameter
install_type	No	Array of strings	Deployment type. Only lowercase letters are supported. The value can be real-time, edge, or batch. The default value is [real-time, edge, batch].
input_params	No	Array of CreateModelRequestInferParams objects	Collection of input parameters of a model. By default, this parameter is left blank. If the parameters are read from apis in the configuration file, provide only the initial_config field, and this field can be left blank. Non-template parameter

**Table 4** GuideDoc
Parameter	Mandatory	Type	Description
doc_url	Yes	String	HTTP(S) link of the document
doc_name	Yes	String	Document name, which must start with a letter. Enter 1 to 48 characters. Only letters, digits, hyphens (-), and underscores (_) are allowed.

**Table 5** template
Parameter	Mandatory	Type	Description
infer_format	No	String	Input and output mode ID. When this parameter is used, the input and output mode built in the template does not take effect.
template_inputs	Yes	Array of CreateModelRequestTemplateInput objects	Template input configuration, specifying the source path for configuring a model.
template_id	Yes	String	ID of the used template. The template has a built-in input and output mode.

**Table 6** CreateModelRequestTemplateInput
Parameter	Mandatory	Type	Description
input	Yes	String	Template input path, which can be a path to an OBS file or directory. When you use a template with multiple input items to create a model, if the target paths input_properties specified in the template are the same, the OBS directory or OBS file name entered here must be unique to prevent files from being overwritten.
input_id	Yes	String	Input item ID, which is obtained from template details.

**Table 7** ModelDependencies
Parameter	Mandatory	Type	Description
installer	Yes	String	Installation mode. Only pip is supported.
packages	Yes	Array of Packages objects	Collection of dependency packages

**Table 8** Packages
Parameter	Mandatory	Type	Description
package_version	No	String	Version of a dependency package. If this parameter is left blank, the latest version is installed by default. Chinese characters and special characters (&!'"<>=) are not allowed.
package_name	Yes	String	Name of a dependency package. Ensure that the package name is correct and available. Chinese characters and special characters (&!'"<>=) are not allowed.
restraint	No	String	Version restriction, which can be EXACT, ATLEAST, or ATMOST. This parameter is mandatory only when package_version is available.

**Table 9** CreateModelRequestModelApis
Parameter	Mandatory	Type	Description
protocol	No	String	Request protocol. The options are HTTP and HTTPS.
method	No	String	Request method, which can be post or get.
input_params	No	ModelInOutputParams object	API input and output parameters, described in JSON Schema format.
output_params	No	ModelInOutputParams object	API input and output parameters, described in JSON Schema format.
url	No	String	Inference request URL

**Table 10** ModelInOutputParams
Parameter	Mandatory	Type	Description
type	No	String	Type in JSON Schema, which can be object.
properties	No	Object	Properties of an object element in JSON Schema. You can configure parameters, including the parameter name and type.

**Table 11** CreateModelRequestInferParams
Parameter	Mandatory	Type	Description
protocol	Yes	String	Request protocol. The options are HTTP and HTTPS.
min	No	Number	Minimum value of the parameter. This parameter is optional when param_type is set to int or float. By default, this parameter is left blank.
method	Yes	String	Request method, which can be post or get.
max	No	Number	Maximum value of the parameter. This parameter is optional when param_type is set to int or float. By default, this parameter is left blank.
param_desc	No	String	Parameter description. It is recommended that the parameter description contain a maximum of 100 characters. By default, this parameter is left blank.
param_name	Yes	String	Parameter name. It is recommended that the parameter name contain a maximum of 64 characters.
url	Yes	String	API URL
param_type	Yes	String	Parameter type, which can be int, string, float, timestamp, date, or file

Response Parameters

Status code: 200

**Table 12** Response body parameters
Parameter	Type	Description
model_id	String	Model ID.

Example Requests

Create an AI application. Set the AI application name to mnist, version to 1.0.0, type to TensorFlow, and model file source to an OBS bucket.

POST https://{endpoint}/v1/{project_id}/models

{
  "model_name" : "mnist",
  "model_version" : "1.0.0",
  "source_location" : "https://models.obs.xxxxx.com/mnist",
  "source_job_id" : "55",
  "source_job_version" : "V100",
  "model_type" : "TensorFlow",
  "runtime" : "python2.7",
  "description" : "mnist model",
  "execution_code" : "https://testmodel.obs.xxxxx.com/customize_service.py",
  "input_params" : [ {
    "url" : "/v1/xxx/image",
    "protocol" : "http",
    "method" : "post",
    "param_name" : "image_url",
    "param_type" : "string",
    "min" : 0,
    "max" : 9,
    "param_desc" : "http://test/test.jpeg"
  } ],
  "output_params" : [ {
    "url" : "/v1/xxx/image",
    "protocol" : "http",
    "method" : "post",
    "param_name" : "face_location",
    "param_type" : "box",
    "param_desc" : "face_location param value description"
  } ],
  "dependencies" : [ {
    "installer" : "pip",
    "packages" : [ {
      "package_name" : "numpy",
      "package_version" : "1.5.0",
      "restraint" : "ATLEAST"
    } ]
  } ],
  "model_algorithm" : "object_detection",
  "model_metrics" : "{\"f1\":0.52381,\"recall\":0.666667,\"precision\":0.466667,\"accuracy\":0.625}",
  "apis" : [ {
    "url" : "/v1/xxx/image",
    "protocol" : "http",
    "method" : "post",
    "input_params" : {
      "type" : "object",
      "properties" : {
        "image_url" : {
          "type" : "string"
        }
      }
    },
    "output_params" : {
      "type" : "object",
      "properties" : {
        "face_location" : {
          "type" : "box"
        }
      }
    }
  } ]
}

Example Responses

Status code: 200

The model is created.

{
  "model_id" : "7feb7235-ed9c-48ae-9833-2876b2458445"
}

Status Codes

Status Code	Description
200	The model is created.

Error Codes

See Error Codes.

Parent topic: AI Application Management

Previous topic: Querying the AI Application List

Next topic: Obtaining Details About an AI Application

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot