跳到主要内容

插件配置教程

本教程详细介绍如何手动创建和配置剪映小助手插件，包括完整的配置步骤和参数说明。

作者信息

本配置由 火灵 精心设计，确保插件的稳定性和易用性。

🛠️ 创建步骤​

1. 进入插件创建页面​

  1. 登录Coze平台：访问 www.coze.cn
  2. 进入工作空间：选择您的工作空间
  3. 访问资源库：点击左侧导航的"资源库"
  4. 创建插件：
    • 右上角选择"插件"
    • 点击"新建插件"
    • 选择右上角的 </> 符号（代码模式）

2. 配置插件​

在代码模式下，您需要配置两个部分：

  • 左侧：ai_plugin 配置（插件元信息）
  • 右侧：OpenAPI 规范（API接口定义）

详细的源码请查看：

3. 保存和测试​

  1. 保存配置：确保两侧代码都正确填写后点击保存
  2. 测试接口：逐个测试每个API接口
  3. 保存示例：测试成功后勾选"保存为运行示例"
  4. 发布插件：所有接口测试通过后点击发布

📋 测试流程​

1. Create_Draft 测试​

目的：创建草稿并获取IDS

测试参数：

{
  "height": 1920,
  "width": 1080
}

预期结果：

{
  "code": 200,
  "ids": "uuid1/uuid2",
  "message": "草稿创建成功"
}

2. Add_Audios 测试​

目的：验证音频添加功能

测试参数：

{
  "ids": "从Create_Draft复制的IDS",
  "mp3_urls": ["https://example.com/test.mp3"],
  "timelines": [{"start": 0, "end": 5000000}]
}

3. 其他接口测试​

按照同样的方式测试：

  • Add_Images（添加图片）
  • Add_Captions（添加字幕）
  • Add_Effects（添加特效）
  • Add_Videos（添加视频）
  • Str_Array（字符串转数组）

⚠️ 注意事项​

测试注意点​

  1. IDS传递：Create_Draft生成的IDS要复制到其他接口测试中
  2. 保存示例：每个接口测试成功后都要勾选"保存为运行示例"
  3. 参数格式：确保时间线参数格式正确（微秒单位）
  4. 网络资源：测试用的音频、图片、视频链接要确保可访问

🚀 发布到商店​

发布步骤​

  1. 完成测试：确保所有接口都测试通过
  2. 点击发布：在插件编辑页面点击发布按钮
  3. 提交审核：
    • 点击Coze商店
    • 选择"插件商店"
    • 点击"上架插件"
    • 选择您的剪映小助手插件
  4. 填写信息：
    • 插件描述
    • 选择类目
    • 提交审核

🆘 常见问题​

Q: 如何修改已发布的插件？ A: 在资源库中找到插件，修改后重新测试和发布。

🤝 获取帮助​

如果在配置过程中遇到问题：

祝您配置成功！🎉