All Products
Search
Document Center

Intelligent Media Services:Server-side integration

Last Updated:Nov 18, 2025

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 pair.

    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 Intelligent Media Console, click the agent you have created to enter the agent details page.

      image

    2. Click RTC AppID to go to the ApsaraVideo Live console to obtain the AppId and AppKey.

      image

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 &