234 lines
6.7 KiB
Markdown
234 lines
6.7 KiB
Markdown
---
|
||
name: aigcpanel-skills
|
||
description: 通过 AigcPanel Pro 内置 HTTP 接口或命令行 CLI 工具调用本地 AI 模型和任务处理能力。当需要列出可用模型、调用模型生成内容、查询任务结果、或批量处理视频/音频/图片时使用本技能。适用场景：自动化脚本调用 AI 模型、外部程序集成 AigcPanel Pro、批量处理任务、CLI 命令行调用。
|
||
---
|
||
|
||
# AigcPanel Pro 集成指南
|
||
|
||
AigcPanel Pro 提供两种集成方式：**HTTP 接口**（适合外部程序集成）和 **CLI 命令行工具**（适合脚本和终端操作）。
|
||
|
||
---
|
||
|
||
## 一、CLI 命令行工具
|
||
|
||
CLI 工具 `aigcpanel` 提供简洁的命令行接口，适合在脚本和终端中使用。
|
||
|
||
### 安装
|
||
|
||
打开应用 **设置 → CLI 工具**，点击"安装到系统"，即可在终端使用 `aigcpanel` 命令。
|
||
|
||
### 命令概览
|
||
|
||
| 命令 | 说明 |
|
||
|------|------|
|
||
| `aigcpanel version` | 查看版本信息 |
|
||
| `aigcpanel model_list` | 列出所有已安装 AI 模型 |
|
||
| `aigcpanel task --biz <类型> [参数...]` | 提交任务并等待结果 |
|
||
|
||
### 列出模型
|
||
|
||
```bash
|
||
aigcpanel model_list
|
||
```
|
||
|
||
输出示例：
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"data": [
|
||
{ "name": "server-openai", "title": "OpenAI", "version": "1.0.0", "functions": [...] }
|
||
]
|
||
}
|
||
```
|
||
|
||
### 提交任务
|
||
|
||
```bash
|
||
# 语音合成
|
||
aigcpanel task --biz SoundGenerate --text "你好世界"
|
||
|
||
# 数字人合成（视频生成）
|
||
aigcpanel task --biz VideoGen --text "欢迎使用"
|
||
|
||
# 一键合成（视频生成流）
|
||
aigcpanel task --biz VideoGenFlow --text "欢迎使用"
|
||
|
||
# 语音识别
|
||
aigcpanel task --biz SoundAsr --file /path/to/audio.wav
|
||
|
||
# 声音替换
|
||
aigcpanel task --biz SoundReplace --file /path/to/video.mp4
|
||
|
||
# 长文本转音频
|
||
aigcpanel task --biz LongTextTts --text "这是一段较长的文本内容"
|
||
|
||
# 字幕转音频
|
||
aigcpanel task --biz SubtitleTts --file /path/to/subtitle.srt
|
||
|
||
# 文生图
|
||
aigcpanel task --biz TextToImage --prompt "美丽的山水风景"
|
||
|
||
# 图生图
|
||
aigcpanel task --biz ImageToImage --file /path/to/image.png --prompt "油画风格"
|
||
|
||
# 声音归一化
|
||
aigcpanel task --biz AudioNormal --file /path/to/audio.wav
|
||
|
||
# 视频压缩
|
||
aigcpanel task --biz VideoCompress --file /path/to/video.mp4
|
||
|
||
# 视频尺寸转换
|
||
aigcpanel task --biz VideoSizeConvert --file /path/to/video.mp4 --targetWidth 1280 --targetHeight 720
|
||
|
||
# 视频变速（全局）
|
||
aigcpanel task --biz VideoSpeed --file /path/to/video.mp4 --speed 1.5
|
||
|
||
# 视频片段变速
|
||
aigcpanel task --biz VideoSpeedPart --file /path/to/video.mp4
|
||
|
||
# 视频背景替换
|
||
aigcpanel task --biz VideoBackground --file /path/to/video.mp4 --image /path/to/bg.png
|
||
|
||
# 视频合并
|
||
aigcpanel task --biz VideoMerge --file /path/to/video1.mp4 --file2 /path/to/video2.mp4
|
||
|
||
# 视频添加音频
|
||
aigcpanel task --biz VideoMergeAudio --file /path/to/video.mp4 --audio /path/to/audio.wav
|
||
|
||
# 片头片尾图片
|
||
aigcpanel task --biz VideoMergeImage --file /path/to/video.mp4 --image /path/to/image.png
|
||
|
||
# 视频添加字幕
|
||
aigcpanel task --biz VideoSubtitle --file /path/to/video.mp4 --subtitle /path/to/subtitle.srt
|
||
|
||
# 视频标注
|
||
aigcpanel task --biz VideoMark --file /path/to/video.mp4
|
||
|
||
# 视频片段删除/保留
|
||
aigcpanel task --biz VideoKeepPart --file /path/to/video.mp4
|
||
|
||
# 视频片段放大
|
||
aigcpanel task --biz VideoZoom --file /path/to/video.mp4
|
||
|
||
# 智能剪辑
|
||
aigcpanel task --biz VideoQuickCut --file /path/to/video.mp4
|
||
|
||
# 媒体格式转换
|
||
aigcpanel task --biz MediaFormatConvert --file /path/to/video.mp4 --targetFormat mp4
|
||
|
||
# Ffmpeg 自定义处理
|
||
aigcpanel task --biz Ffmpeg --file1 /path/to/input.mp4
|
||
```
|
||
|
||
### 复杂参数（JSON 文件）
|
||
|
||
对于数组/对象类型的参数，用 `--参数名-json /path/to/file.json` 传入：
|
||
|
||
```bash
|
||
# VideoZoom 指定放大区域
|
||
echo '[{"start":1.0,"end":3.0,"x":0.2,"y":0.1,"width":0.6,"height":0.8}]' > ./_temp/times.json
|
||
aigcpanel task --biz VideoZoom --file /path/to/video.mp4 --times-json ./_temp/times.json
|
||
```
|
||
|
||
### 继续暂停的任务
|
||
|
||
部分任务（如 VideoZoom、VideoMark）需要确认才能继续执行：
|
||
|
||
```bash
|
||
# 第一步：提交任务（返回 taskId 和 pauseStage）
|
||
aigcpanel task --biz VideoZoom --file /path/to/video.mp4
|
||
|
||
# 第二步：确认继续（Config 阶段）
|
||
aigcpanel task --biz VideoZoom --task-id <taskId> --stage Config --times-json ./_temp/times.json
|
||
|
||
# 第三步：渲染确认（RenderConfirm 阶段，如有）
|
||
aigcpanel task --biz VideoZoom --task-id <taskId> --stage RenderConfirm
|
||
```
|
||
|
||
### 输出结果
|
||
|
||
任务成功时输出包含 `result` 字段，通常有 `url`（输出文件路径）：
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"data": {
|
||
"status": "success",
|
||
"result": { "url": "/path/to/output.mp4" }
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 二、HTTP 接口
|
||
|
||
AigcPanel Pro 内置 HTTP 接口服务，默认监听 `http://localhost:59999`，提供模型列表、模型调用和结果查询能力。
|
||
|
||
### 前提条件
|
||
|
||
确认服务已启动：打开应用 **设置 → HTTP 接口**，确认状态为"运行中"。若未启动，点击"启动服务"按钮，或开启"自动启动"后重启应用。
|
||
|
||
### 获取可用模型
|
||
|
||
```
|
||
GET http://localhost:59999/api/model/list
|
||
```
|
||
|
||
响应示例：
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"data": [
|
||
{ "id": "openai|gpt-4o", "providerId": "openai", "modelId": "gpt-4o", "modelName": "GPT-4o" },
|
||
{ "id": "deepseek|deepseek-chat", "providerId": "deepseek", "modelId": "deepseek-chat", "modelName": "DeepSeek Chat" }
|
||
]
|
||
}
|
||
```
|
||
|
||
`id` 格式为 `providerId|modelId`，调用时需传此值。
|
||
|
||
### 调用模型
|
||
|
||
```
|
||
POST http://localhost:59999/api/model/call
|
||
Content-Type: application/json
|
||
|
||
{ "model": "deepseek|deepseek-chat", "prompt": "用一句话介绍自己", "systemPrompt": "你是助手" }
|
||
```
|
||
|
||
- `model`（必填）：模型 ID，来自列表接口的 `id` 字段
|
||
- `prompt`（必填）：用户输入
|
||
- `systemPrompt`（可选）：系统提示词
|
||
|
||
响应：
|
||
```json
|
||
{ "code": 0, "data": { "taskId": "m3x7k2abc" } }
|
||
```
|
||
|
||
### 查询任务结果
|
||
|
||
```
|
||
GET http://localhost:59999/api/model/query?taskId=m3x7k2abc
|
||
```
|
||
|
||
响应（进行中）：`{ "code": 0, "data": { "status": "pending" } }`
|
||
|
||
响应（成功）：`{ "code": 0, "data": { "status": "success", "result": "..." } }`
|
||
|
||
响应（失败）：`{ "code": 0, "data": { "status": "error", "error": "..." } }`
|
||
|
||
`status` 为 `pending` 时继续轮询，建议间隔 500ms。
|
||
|
||
### 标准调用流程
|
||
|
||
1. 调用 `/api/model/list` 获取可用模型列表，选取目标模型 `id`
|
||
2. 调用 `/api/model/call` 传入 `model` 和 `prompt`，获得 `taskId`
|
||
3. 轮询 `/api/model/query?taskId=xxx` 直至 `status` 不为 `pending`
|
||
4. 读取 `result`（成功）或 `error`（失败）
|
||
|
||
## 错误处理
|
||
|
||
所有接口错误时返回 `{ "code": -1, "msg": "错误描述" }`，`code` 非 0 时视为失败。
|
||
常见原因：服务未启动、模型未在设置中启用、API Key 未配置。
|