Connecting to ModelArts to Recognize Images and Text

Prerequisites

• You have obtained the access key ID (AK) and secret access key (SK). For details, see Obtaining an AK/SK.
• You have created and deployed a flower recognition model in ModelArts.

Creating a ModelArts Connector

1. Log in to the application designer by referring to Logging In to the Application Designer.
2. In the navigation pane, choose Integrations.
3. Click Connector Instance under Connector.
4. In the navigation pane on the left, choose AI > ModelArts.
5. In the right pane, click + and set the parameters.
   Figure 1 Creating ModelArts
   

   Table 1 Parameters for creating a ModelArts connector

   Parameter	Description
   Name	Name of the connector to be created. The naming requirements are as follows: The value cannot exceed 64 characters, including the prefix namespace. The content before the name is the namespace. To avoid duplicate data names among different tenants in Astro Zero, a tenant needs to define a namespace when creating an application for the first time. A tenant can create only one namespace. After being created, the namespace cannot be modified. Start with a letter and can contain only letters, digits, and underscores (_). Do not end with an underscore (_).
   Access Key ID	The AK and the secret access key (SK) are used together to encrypt and sign a request. Set this parameter to the value of AK in Prerequisites.
   Secret Access Key	Secret access key is used together with the access key ID to encrypt the request, identify the sender, and prevent the request from being tempered. Set this parameter to the value of AK in Prerequisites.
   Region	Select the region of ModelArts.
   Project ID	Project ID corresponding to the region where ModelArts is located.
   Description	Enter the description of the connector. Value: 1–255 characters.
   Package Current Configuration	If this parameter is selected, the connector (including the access key and key) will be packed together with applications. For example, if an application package is released to the runtime environment, the current configuration is synchronized to the runtime environment by default. If this option is not selected, the connector will not be packaged and released to the runtime environment. In this case, you need to create the corresponding connector by referring to Managing Connectors in Applications. This parameter is selected by default. You are advised not to select this option in information-sensitive scenarios.

6. Click Save.
7. (Optional) Test whether flower images can be recognized.
   1. Click Test on the connector details page.
   2. After setting the parameters, click Test.
      Choose Type: The object to be recognized can be an image or text. In this example, select Image File and upload the image.

      • Image URL: If the object to be recognized is an image, select Image URL and set the details.
      • Image File: If the object to be recognized is an image, select Image File and drag the image to the target area.
      • Text: If the object to be recognized is text, select Text and enter the specific text.

      • Is Api g Code: Used by Astro Zero to call services that have been brought online in ModelArts.
        1. The operations in Prerequisites have been performed.
        2. On the ModelArts management console and choose Service Deployment > Real-Time Services.
        3. Click the name of the target service. The service details page is displayed.
        4. On the Usage Guides tab of the service details page, check the API URL.
      • Model Id: ID of the service that has been brought online on the ModelArts console.
        1. The operations in Prerequisites have been performed.
        2. On the ModelArts management console and choose Service Deployment > Real-Time Services.
        3. Click the name of the target service. The service details page is displayed.
        4. Check the service ID.

Calling a Connector in a Script

Call the connector in the script to connect to ModelArts.

1. Create an empty script by referring to Creating a Blank Script.
2. In the script editor, enter the following code.

   import * as modelarts from 'modelarts';
   
   export class Input {
       @action.param({ type: "String", required: false, description: "the image url" })
       url: string;
   
       @action.param({ type: "String", required: false, description: "the base64 coded image" })
       image: string;
   
       @action.param({ type: "String", required: false, description: "" })
       apigCode: string
   
       @action.param({ type: "String", required: false, description: "" })
       modelId: string
   }
   
   export class Output {
       @action.param({ type: "string" })
       result: string;
   }
   
   
   export class testModelarts {
   
       @action.method({ input: "Input", output: "Output", description: "modelartspro test case" })
       run(input: Input): void {
           // Enter the name of the instantiated ModelArts Pro connector.
           let client = modelarts.newClient("testArts")
           let result = null
           result = client.modelArtsWithURL(input.url, input.apigCode, input.modelId);
           console.log(result)
           return result
       }
   }
   

   In modelarts.newClient("testArts"), "testArts" is the connector name. The code must include the namespace prefix if it is present in the connector name.

3. Click in the upper part of the script editor to save the script.
4. Click to execute the script.
5. On the input parameter tab page at the bottom of the page, enter request parameters and click in the upper right corner of the test window.

   {
       "url": "https://XXXXXXXXX/testmodelarts.jpg",
       "apigCode": "bec274062225485b95fbcd4d6e8f128a",
       "modelId": "5ecac550-eefe-4437-9767-57eca07fa91f"
   }

   In the code, set url to the image URL.

6. On the output parameter tab page, you can check the recognition result.

   {
       "predicted_label": "roses",
       "scores": [
           [
               "roses",
               "0.947"
           ],
           [
               "daisy",
               "0.050"
           ],
           [
               "tulips",
               "0.002"
           ],
           [
               "dandelion",
               "0.000"
           ],
           [
               "sunflowers",
               "0.000"
           ]
       ]
   }

7. Click in the upper part of the script editor to activate the script.

Calling a Connector in a Flow

Call the connector in a flow to connect to ModelArts.