sun-guannan/VectCutAPI

VectCutAPI 是做什麼的？

VectCutAPI 是一個強大的雲端影片編輯 API 工具，可透過程式控制 CapCut/剪映 (JianYing) 進行專業影片編輯。使用此技能當使用者需要：(1) 程式化建立影片草稿專案、(2) 精準控制新增影片/音訊/圖片素材、(3) 新增文字、字幕與標題、(4) 套用特效、轉場與動畫、(5) 新增關鍵幀動畫、(6) 批次處理影片、(7) 生成 AI 影片、(8) 整合 n8n 工作流程。

---

主要功能

1. 影片草稿管理

• 使用 API 建立、讀取、更新和刪除影片草稿專案
• 支援自訂專案設定，如解析度、幀率與時長

2. 素材管理

• 新增影片、音訊與圖片素材
• 支援多種格式（MP4, MOV, AVI, PNG, JPG, WAV, MP3）
• 可精準設定素材在時間軸上的位置與時長

3. 文字與字幕

• 新增文字圖層，支援自訂字體、大小、顏色與對齊
• 自動字幕生成（需語音辨識基礎模型）
• 支援多語言字幕（SRT 與 VTT 格式）

4. 特效與動畫

• 套用內建特效與轉場（淡入淡出、滑動、縮放等）
• 關鍵幀動畫（位置、旋轉、透明度、縮放）
• 支援自訂動畫曲線（easing functions）

5. 批次處理

• 同時處理多個影片專案
• 支援模板化影片生成（使用 JSON 設定）
• 非同步工作處理，含回呼通知

6. AI 影片生成

• 利用 AI 模型自動產生影片內容
• 文字轉影片（TTS 配音與圖片生成）
• 自動場景分割與智慧剪輯

快速開始

安裝

npm install vectcut-api
# 或
pip install vectcut-api

基本使用範例

const VectCutAPI = require('vectcut-api');

const client = new VectCutAPI({
  apiKey: 'your-api-key-here',
  environment: 'production' // 或 'sandbox'
});

// 建立影片草稿
async function createDraft() {
  const draft = await client.drafts.create({
    name: '我的第一個影片',
    resolution: '1920x1080',
    fps: 30,
    duration: 60 // 秒
  });
  console.log(draft.id);
}

// 新增素材
async function addMedia(draftId) {
  const media = await client.media.add(draftId, {
    type: 'video',
    url: 'https://example.com/video.mp4',
    start: 0,
    duration: 10
  });
}

API 參考

完整的 API 參考文件請見 VectCutAPI 文件。

端點	方法	描述
/drafts	GET	列出所有草稿
/drafts	POST	建立新草稿
/drafts/:id	GET	取得草稿詳情
/drafts/:id	PUT	更新草稿
/drafts/:id	DELETE	刪除草稿
/media	POST	新增素材
/text	POST	新增文字層
/effects	POST	套用特效
/render	POST	開始渲染

環境變數

• VECTCUT_API_KEY - API 金鑰（必要）
• VECTCUT_ENV - 環境（預設：production）
• VECTCUT_CALLBACK_URL - 工作完成時的回呼 URL

支援與貢獻

如有問題或功能請求，請至 GitHub 儲存庫 提交 Issue。歡迎提交 Pull Request 貢獻。

授權

MIT 授權