All Products
Search
Document Center

Intelligent Media Services:Server-side integration

Last Updated:Aug 27, 2026

This topic describes how to set up an App Server.

Role of App Server

image

When you build an AI agent service using the AUI Kits framework, the client SDK needs to interface with Alibaba Cloud product capabilities. The App Server encapsulates these capabilities and provides a standardized set of HTTP APIs for the SDK, reducing your development costs.

Note

You must deploy and maintain the App Server yourself.

Project framework

The project uses Java 8 and Spring Boot 2.

Deploy a project

Prerequisites

Deploy from source code

This example shows how to build and deploy the App Server using source code.

Configure project parameters

  1. Download the App Server source code.

  2. Open the Server\Java\src\main\resources directory and locate the application.yml file. Configure the relevant parameters and keep the parameters that require no configuration unchanged.

    Parameter configuration

    Description

    biz:
      openapi:
        access:
          key: "*******"
          secret: "*******"

    Alibaba Cloud APIs require an AccessKey pair for authentication. An AccessKey pair consists of an AccessKey ID and an AccessKey Secret.

    • AccessKey ID: Identifies the user.

    • AccessKey secret: A secret key used to authenticate your requests. You must keep your AccessKey Secret confidential.

    For more information, see Create an AccessKey.

    Note

    If you use the AccessKey of a RAM user, you must grant the RAM user the AliyunICEFullAccess permission.

    # The information about the ARTC application.
      live_mic:
        app_id: "*******"
        app_key: "*******"

    The AppID and AppKey of your ARTC application. You can find them in the console.

    Note

    For audio and video communications, you must configure the ARTC AppID and AppKey. For interative messaging, this is optional.

    To obtain the AppID and AppKey for the ARTC application:

    1. Go to the IMS console and click your AI agent to open its details page.

      On the Basic Information tab, find the Workflow Configuration section and note the RTC App ID listed under ARTC application.

    2. Click the RTC App ID to open the ApsaraVideo Live console and get the App ID and AppKey.

      On the Application Management page, click your application name, go to the Basic Information tab, and copy the App ID and AppKey.

Package and run the project

Package the project

  1. Package the project using the built-in Maven tool in IntelliJ IDEA. This action generates a JAR file in the target directory.

  2. Run the following command in the Server\Java directory to package the project:

    mvn package -DskipTests
  3. (Optional) Send the JAR package from the target directory to the server.

    scp xxx.jar root@ip:/root

Run the project

Open a terminal in the directory where the JAR file is located.

  1. Run in the foreground. This prints logs to the terminal.

    java -jar ***.jar
  2. Run in the background. This writes logs to the nohup.out file.

    nohup java -jar ***.jar &