34ai-api-suite

Files (5)

• SKILL.md
• api-catalog.json · references/
• api-index.md · references/
• examples.md · references/
• skill.json

SKILL.md (first lines)

# 34ai-api-suite

## 用途
调用你提供的 34AI / Apifox 接口集合，统一处理小程序鉴权、抖音/小红书采集、数字人、AI 语音、AI 视频、AI 绘图、草稿剪辑、RPA 和自动剪辑等任务。

这份技能不是手工凭印象整理的。我已经逐条访问你给出的 Apifox `.md` 文档，并从每个文档里的 OpenAPI YAML 解析出接口方法、路径、参数位置、是否必填和部分返回字段。

## 适用场景
- 获取微信小程序 `access_token`
- 获取小程序跳转 URL
- 抖音 / 小红书内容采集、评论采集、主页采集、下载链接解析
- 数字人相关：克隆音色、克隆形象、合成声音、合成数字人、查询任务、音色列表、形象列表、音频裁剪
- AI 视频相关：视频转音频、音频转文字、高质量剪辑、Sora 图生视频、豆包图生视频、视频生成结果查询
- AI 语音相关：豆包文字生语音、index2 克隆音频、克隆结果查询
- AI 绘图相关：豆包文生图
- 草稿管理 / 自动剪辑：创建草稿、保存草稿、添加视频/音频/图片/字幕/特效/关键帧、生成短视频
- 34AI 自动化工具 / Coze / RPA / 蜂巢智工等自动化接口调用

## 配置项
在面板里安装技能后，先配置：

- `config.baseUrl`：你的 34AI API 网关地址
- `config.apiKey`：你的 API Key
- `config.authHeader`：API Key 放到哪个请求头里
- `config.authScheme`：如果要走 `Authorization` 头，是否加 `Bearer`
- `config.defaultTimeout`：请求超时时间，默认 30 秒

你当前可以在配置页中填写自己的 API Key：

- `bc11409e90be07f7ab2ecceef00f14b6`

建议把它填进技能配置，不要硬编码在技能文件或聊天内容里。

## 调用方式
这个技能适合按“接口名 + 参数”方式调用。

调用前先做这几步：

1. 读取技能配置中的 `config.baseUrl`
2. 读取技能配置中的 `config.apiKey`
3. 根据 `config.authHeader` 决定鉴权头写法：
   - `X-API-Key: <apiKey>`
   - 或 `Authorization: Bearer <apiKey>`
4. 再根据用户指定的接口名、路径、方法、参数发请求

推荐你在调用时明确给出：

1. 要调用的接口名称
2. 请求方法
3. 路径
4. query / body 参数
5. 你希望返回哪些字段

建议统一的调用描述格式：

```text
请调用 34AI API
- 接口：小程序获取access_token
- 方法：POST
- 路径：/cgi-bin/token
- query：grant_type=client_credential
- body / 参数：appid=..., secret=...
- 返回：access_token, expires_in
```

## 已整理的接口能力

完整接口清单见：

- `references/api-index.md`
- `references/api-catalog.json`

常见调用模板见：

- `references/examples.md`

### 小程序
- 小程序获取 `access_token`
- 获取小程序跳转 URL

### 抖音类
- 抖音采集关键词文章（30s）
- 抖音采集文章评论
- 抖音采集主页视频
- 抖音视频下载链接解析
- 综合抖音采集关键词文章（10s / 常规）

### 小红书类
- 小红书采集关键词文章
- 小红书采集文章评论
- 小红书采集用户主页数据
- 小红书文章采集（综合）
- 小红书采集用户主页

### 数字人
- 克隆音色
- 克隆形象
- 合成声音
- 合成 vlogo 视频
- 合成数字人
- 查询数字人
- 音色列表
- 形象列表
- 音频裁剪

### AI 视频
- 视频转音频工具
- 音频转文字
- 创建高质量剪辑
- 渲染高质量剪辑
- Sora 图生视频
- Sora 图生视频查询结果
- Sora 图生视频定时生图 / 定时查结果
- 高质量剪辑任务查询

### AI 语音
- 豆包文字生语音
- index2 克隆音频
- index2 查询克隆结果

From zhaoxinyi02/ClawPanel-Plugins, MIT.

More from zhaoxinyi02/ClawPanel-Plugins