> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

#  RuoYi AI 接入 PPIO LLM API

当前AI应用类型多种多样，已广泛应用于金融、医疗、教育等数十个关键领域，呈现出"千业千面"的趋势。

在传统开发流程，想要搭建AI应用，不仅需要支撑高并发请求的微服务架构，还需整合包括知识图谱构建、多轮对话管理、意图识别引擎在内的十余项核心技术模块。

如何才能更加简单、高效地搭建AI应用？

全栈式 AI 开发平台 RuoYi AI 提供了一个开箱即用的开源解决方案，涵盖前端应用、后台管理、小程序应用。并且，该开源系统基于 MIT 协议，自由度高，可灵活修改和分发代码，支持免费商用。帮助开发者省去繁琐的搭建过程，快速搭建AI应用。

在PPIO派欧云高性能API服务支持下，开发者还可以轻松调用deepseek-r1、deepseek-v3、qwen3等多款主流大模型，为AI应用“注入灵魂”。完整配置教程如下，快来解锁超便捷AI开发平台，搭建属于自己的AI应用！

## **PPIO × RuoYi AI 配置教程**

### 项目环境

* jdk 17
* mysql 5.7、8.0
* redis 版本必须 >= 5.X
* maven 3.8+
* nodejs 20+ & pnpm

### 第一步：安装后端

1. 下载项目

* [<u>https://gitee.com/ageerle/ruoyi-ai</u>](https://gitee.com/ageerle/ruoyi-ai)

2. idea 导入项目

<img src="https://mintcdn.com/ppinfra/FhPQL2dauyVkuUFM/third-party/images/RuoYiAI/1280X1280(3).PNG?fit=max&auto=format&n=FhPQL2dauyVkuUFM&q=85&s=fc8c03d3798bb1f155dc4968398950e4" alt="1280X1280(3).PNG" width="1280" height="794" data-path="third-party/images/RuoYiAI/1280X1280(3).PNG" />

3. 配置maven 文件 - 设置 - 左上角搜索框输入maven - 选择maven安装目录

<img src="https://mintcdn.com/ppinfra/FhPQL2dauyVkuUFM/third-party/images/RuoYiAI/1280X1280.PNG?fit=max&auto=format&n=FhPQL2dauyVkuUFM&q=85&s=5d859bf640895dd9119514896e652046" alt="1280X1280.PNG" width="998" height="731" data-path="third-party/images/RuoYiAI/1280X1280.PNG" />

xml配置

```bash theme={null}
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd">
  <localRepository>D:/dev/apache-maven-3.9.9/repository</localRepository>
  <mirrors>
 <mirror>
   <id>aliyunmaven</id>
   <mirrorOf>*</mirrorOf>
   <name>阿里云公共仓库</name>
   <url>https://maven.aliyun.com/repository/public</url>
 </mirror>
  </mirrors>
  <profiles>
 <profile>
  <id>jdk-17</id>
  <activation>
   <activeByDefault>true</activeByDefault>
   <jdk>17</jdk>
  </activation>
  <properties>
   <maven.compiler.source>17</maven.compiler.source>
   <maven.compiler.target>17</maven.compiler.target>
   <maven.compiler.compilerVersion>17</maven.compiler.compilerVersion>
  </properties>
     </profile>
  </profiles>
</settings>
```

4. 初始化数据库

<img src="https://mintcdn.com/ppinfra/FhPQL2dauyVkuUFM/third-party/images/RuoYiAI/2e9715ba-1463-4fd3-9578-529ef61d2a6e.png?fit=max&auto=format&n=FhPQL2dauyVkuUFM&q=85&s=9abd39244c91aa1182790e3bed5faee4" alt="2e9715ba-1463-4fd3-9578-529ef61d2a6e.png" width="1280" height="981" data-path="third-party/images/RuoYiAI/2e9715ba-1463-4fd3-9578-529ef61d2a6e.png" />

<img src="https://mintcdn.com/ppinfra/FhPQL2dauyVkuUFM/third-party/images/RuoYiAI/92763c60-7c29-4620-ac76-9258e0f5eded.png?fit=max&auto=format&n=FhPQL2dauyVkuUFM&q=85&s=e8bc292292a8ab9bdd4bc32c75e45c84" alt="92763c60-7c29-4620-ac76-9258e0f5eded.png" width="1266" height="960" data-path="third-party/images/RuoYiAI/92763c60-7c29-4620-ac76-9258e0f5eded.png" />

5. 启动redis

* 下载地址：[<u>https://github.com/tporadowski/redis/releases</u>](https://github.com/tporadowski/redis/releases)

<img src="https://mintcdn.com/ppinfra/FhPQL2dauyVkuUFM/third-party/images/RuoYiAI/8bb5c31d-7947-4737-9a21-47816654fb55.png?fit=max&auto=format&n=FhPQL2dauyVkuUFM&q=85&s=47da48ac0b2c8715c65657b940b37daa" alt="8bb5c31d-7947-4737-9a21-47816654fb55.png" width="1280" height="679" data-path="third-party/images/RuoYiAI/8bb5c31d-7947-4737-9a21-47816654fb55.png" />

6. 启动项目

<img src="https://mintcdn.com/ppinfra/FhPQL2dauyVkuUFM/third-party/images/RuoYiAI/f6c1e1e7-7ec9-4ed8-bf6a-a4c824588770.png?fit=max&auto=format&n=FhPQL2dauyVkuUFM&q=85&s=ea3fc60328db9fa6af1b00eab3635a8d" alt="f6c1e1e7-7ec9-4ed8-bf6a-a4c824588770.png" width="1280" height="762" data-path="third-party/images/RuoYiAI/f6c1e1e7-7ec9-4ed8-bf6a-a4c824588770.png" />

## 第二步：安装管理端

1. 下载项目

* [<u>https://gitee.com/ageerle/ruoyi-admin</u>](https://gitee.com/ageerle/ruoyi-admin)

2. 安装依赖

```javascript theme={null}
pnpm install
```

3. 运行项目

```javascript theme={null}
pnpm dev
```

4. 打包

```javascript theme={null}
pnpm build
```

5. 修改配置项

* 后台接口：`/apps/web-antd/vite.config.mts`

<img src="https://mintcdn.com/ppinfra/FhPQL2dauyVkuUFM/third-party/images/RuoYiAI/343335cf-840f-4c6f-88f7-95b502fd2661.png?fit=max&auto=format&n=FhPQL2dauyVkuUFM&q=85&s=d5a405176417ba48787be3d594f51129" alt="343335cf-840f-4c6f-88f7-95b502fd2661.png" width="1280" height="764" data-path="third-party/images/RuoYiAI/343335cf-840f-4c6f-88f7-95b502fd2661.png" />

* 其他配置：`/apps/web-antd/.env.development`

## 第三步：安装用户端

1. 下载项目

* [<u>https://gitee.com/ageerle/ruoyi-web</u>](https://gitee.com/ageerle/ruoyi-web)

2. 安装依赖

javascript

```javascript theme={null}
npm install
```

3. 运行项目

javascript

```javascript theme={null}
npm run dev
```

4. 打包

javascript

```javascript theme={null}
npm run build
```

## 第四步：接入AI大模型

1. 获取 API 密钥

注册登录派欧云，填写邀请码【N7EUVY】得 15元代金券。

打开 API 密钥管理页面，点击创建按钮，输入自定义密钥名称，生成API密钥。

<img src="https://mintcdn.com/ppinfra/FhPQL2dauyVkuUFM/third-party/images/RuoYiAI/b4494865-1b3c-4052-a4fc-9ee04d470f4e.png?fit=max&auto=format&n=FhPQL2dauyVkuUFM&q=85&s=d8d83c751d241cb128d98075610e626c" alt="b4494865-1b3c-4052-a4fc-9ee04d470f4e.png" width="1280" height="753" data-path="third-party/images/RuoYiAI/b4494865-1b3c-4052-a4fc-9ee04d470f4e.png" />

<img src="https://mintcdn.com/ppinfra/FhPQL2dauyVkuUFM/third-party/images/RuoYiAI/980d9163-97ec-4318-99c0-58c2adf14afb.png?fit=max&auto=format&n=FhPQL2dauyVkuUFM&q=85&s=91be5cb0c8d2d6aad8068aca82c939a7" alt="980d9163-97ec-4318-99c0-58c2adf14afb.png" width="1280" height="720" data-path="third-party/images/RuoYiAI/980d9163-97ec-4318-99c0-58c2adf14afb.png" />

2. **生成并保存 API 密钥**

\*\*!!注意:\*\*秘钥在服务端是加密存储，请在生成时保存好秘钥；若遗失可以在控制台上删除并创建一个新的秘钥。

<img src="https://mintcdn.com/ppinfra/FhPQL2dauyVkuUFM/third-party/images/RuoYiAI/838ecbae-0422-473b-b2e8-d700004d5efa.png?fit=max&auto=format&n=FhPQL2dauyVkuUFM&q=85&s=ac85c5da7bc413b1a4c35e9837fe67c7" alt="838ecbae-0422-473b-b2e8-d700004d5efa.png" width="1280" height="720" data-path="third-party/images/RuoYiAI/838ecbae-0422-473b-b2e8-d700004d5efa.png" />

3. **获取 【API Base URL】**

固定为：`https://api.ppio.com/openai`

4. **获取需要使用的模型 ID**

* deepseek/deepseek-r1-turbo
* deepseek/deepseek-v3-turbo
* deepseek/deepseek-v3-0324
* qwen/qwq-32b

其他模型ID、最大上下文及价格可参考：[PPIO派欧云 - AI 云端一体化解决方案: 模型 API、Serverless、GPU 租赁](https://ppio.com/model-api/console)

5. **后台模型管理配置**

前往RouYi AI 运营管理-系统模型页面配置模型。

* 模型名称：所需模型名称，如qwen/qwen3-32b-fp8
* 模型描述：所需模型名称，如qwen/qwen3-32b-fp8
* 模型价格：规定模型价格
* 计算类型：次数计费
* 请求地址：`https://api.ppio.com/openai`
* 密钥：派欧云官网所保存密钥

<img src="https://mintcdn.com/ppinfra/FhPQL2dauyVkuUFM/third-party/images/RuoYiAI/b65b799c-a202-49eb-9c33-6df0755599c7.png?fit=max&auto=format&n=FhPQL2dauyVkuUFM&q=85&s=5f9551e5973dd131cff26d73d21b9bb5" alt="b65b799c-a202-49eb-9c33-6df0755599c7.png" width="1280" height="598" data-path="third-party/images/RuoYiAI/b65b799c-a202-49eb-9c33-6df0755599c7.png" />

6. 效果展示

<img src="https://mintcdn.com/ppinfra/FhPQL2dauyVkuUFM/third-party/images/RuoYiAI/6245663e-c9e1-4101-8336-08dfe121e4c5.png?fit=max&auto=format&n=FhPQL2dauyVkuUFM&q=85&s=55afc8feab887754b6df335cfc20e15e" alt="6245663e-c9e1-4101-8336-08dfe121e4c5.png" width="1280" height="708" data-path="third-party/images/RuoYiAI/6245663e-c9e1-4101-8336-08dfe121e4c5.png" />
