Scrptly Video Generator

官方

一個能透過簡單提示與情境圖片,生成專業且複雜影片的AI影片代理。

你可以用 Scrptly Video Generator MCP 做什麼?

  • 生成AI视频 — 使用 generateAiVideo 搭配详细的文字提示和可选的上下文图片,以启动视频生成任务。
  • 设定审批预算 — 传入 approveUpTo 来限制视频生成的代币成本,默认值为10,000个代币。
  • 检查任务状态 — 使用 getTaskStatus 并传入 taskId 来轮询状态并获取最终视频的URL。

文件

←Scrptly 的 MCP 伺服器

Scrptly MCP(模型連接器協定)伺服器允許您透過 MCP 介面將 Scrptly 與您偏好的大型語言模型(LLM)連接。這使您能夠利用自訂 LLM 透過 Scrptly 的 AI 代理生成專業影片。

設定 MCP 伺服器

您可以透過以下設定將 Scrptly 的 MCP 伺服器連接到您選擇的 LLM:

  • 端點 URL:https://mcp.scrptly.com/
  • 驗證:使用您的 Scrptly API 金鑰進行驗證。使用的驗證方法為 Authorization 標頭中的 Bearer Token。

對於需要 JSON 設定的用戶端,以下是範例設定:

{
    "mcpServers": {
        "scrptly-video-generator": {
            "command": "npx",
            "args": ["mcp-remote", "https://mcp.scrptly.com/", "--header", "Authorization: Bearer YOUR_API_KEY_HERE"]
        }
    }
}

使用 MCP 伺服器

Scrptly 的 MCP 伺服器作為您的 LLM 與 Scrptly 的 AI 影片代理之間的橋樑。當您向 MCP 伺服器發送請求時,它會呼叫 Scrptly 的 AI 影片代理 API,根據您的 LLM 處理的提示生成影片。

Scrptly 的 MCP 目前支援以下工具:

生成 AI 影片 — generateAiVideo

根據文字提示和可選的上下文圖片生成影片。

輸入參數:

  • prompt:[string] 用於生成影片的詳細文字提示。應包含影片時長、視覺風格、情節/內容以及任何與生成高品質影片相關的資訊。
  • context:[array of objects] 可選的上下文圖片陣列,用於引導影片生成。每張圖片應具有 URL 和簡短描述。
    • context[].url:[string] 用於影片生成的上下文圖片的 URL。
    • context[].description:[string] 上下文圖片的簡短描述,以及應如何在影片中使用它。
  • approveUpTo:[number] 使用者批准用於生成影片的最大成本(以 token 計)。可選但強烈建議。預設為 10,000 token。

輸出參數:

  • taskId:[string] 用於生成 AI 影片所建立任務的 ID。
  • projectId:[string] 在 Scrptly 上建立的 AI 影片專案的 ID。
  • projectUrl:[string] 用於在 Scrptly 上檢視和管理/調整生成的 AI 影片專案的 URL。

取得任務狀態 — getTaskStatus

檢查 AI 影片生成任務的狀態。

輸入參數:

  • taskId:[string] 要檢查狀態的 AI 影片生成任務的 ID。

輸出參數:

  • status:[string] AI 影片生成任務的目前狀態。可能的值為 'awaiting'、'processing'、'success' 和 'failed'。
  • statusMessage:[string] 關於任務目前狀態的詳細訊息。
  • resultVideoUrl:[string] 如果任務成功完成,生成的影片檔案的 URL。
  • projectId:[string] 在 Scrptly 上建立的 AI 影片專案的 ID。
  • projectUrl:[string] 用於在 Scrptly 上檢視和管理/調整生成的 AI 影片專案的 URL。