🧩 模型接入流程总览

更新时间: 2026-10-19 17:22:12

AIGCPanel 的能力由模型提供。本文给出从编写 config.json 到导入软件测试的完整接入流程,帮助开发者整体把握开发节奏。

AI模型管理

先选择接入方式

方式 适用场景 关键文件
简易接入 Python 实现,快速验证想法 config.json + run.py(entry 固定为 __EasyServer__)
高级接入 JS 实现,需要精细控制启停与调用 config.json + server.js
远程模型 部署在服务器或另一台机器,通过 HTTP 交互 启动器 + config.json

完整接入流程

  1. 确定能力:明确要提供的能力(声音合成、声音复刻、视频合成、语音识别等)
  2. 编写 config.json:声明名称、版本、平台、入口与能力列表
  3. 实现运行入口:按所选方式实现进程启动与参数传递(标准输入输出或 HTTP 接口)
  4. 实现能力方法:按能力约定处理入参,返回结果文件路径
  5. 本地自测:先以命令行方式跑通一次完整调用,确认输出正确
  6. 导入软件:在「AI模型」页选择模型目录中的 config.json 导入
  7. 启动测试:启动模型并在对应功能页试跑,结合「日志」页排查问题

config.json 核心字段

字段 说明
name / version 模型标识,软件内以 name|version 唯一区分
title / description 界面显示的名称与描述
platformName / platformArch 支持系统(win / osx / linux)与架构(x86 / arm64)
serverRequire 对 AIGCPanel 的版本要求,如 >=0.5.0
entry / easyServer 启动入口与运行参数(简易接入使用)
functions 能力声明,决定界面开放哪些功能入口
settings 模型配置项,会显示在模型配置页面

交付目录结构参考

server-xxx/
├── config.json            # 模型配置与能力声明
├── server.js / run.py     # 运行入口
├── _aienv/                # 打包好的运行环境(简易接入示例)
└── example/               # 示例资源,便于自测

相关文档

语言
QQ
微信客服
微信群
客服