Scrptly Video Generator MCP Server

chính thức

Một tác nhân video AI có thể tạo ra các video chuyên nghiệp và phức tạp chỉ với lời nhắc đơn giản và hình ảnh ngữ cảnh.

Tài liệu

closeLoginsearchSearchSignup1,000

←Máy chủ MCP của Scrptly

Máy chủ MCP (Model Connector Protocol) của Scrptly cho phép bạn kết nối Scrptly với Mô hình Ngôn ngữ Lớn (LLM) ưa thích thông qua giao diện MCP. Điều này cho phép bạn tận dụng các LLM tùy chỉnh để tạo video chuyên nghiệp thông qua Tác nhân AI của Scrptly.

Thiết lập Máy chủ MCP

Bạn có thể kết nối Máy chủ MCP của Scrptly với LLM bạn chọn thông qua cấu hình này:

  • URL Điểm cuối: https://mcp.scrptly.com/
  • Xác thực: Sử dụng khóa API Scrptly của bạn để xác thực. Phương thức xác thực được sử dụng là Bearer Token trong tiêu đề Authorization.

Đối với các máy khách yêu cầu cấu hình JSON, đây là ví dụ thiết lập:

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

Sử dụng Máy chủ MCP

Máy chủ MCP của Scrptly hoạt động như một cầu nối giữa LLM của bạn và Tác nhân Video AI của Scrptly. Khi bạn gửi yêu cầu đến Máy chủ MCP, nó sẽ gọi API Tác nhân Video AI của Scrptly để tạo video dựa trên các lời nhắc được LLM của bạn xử lý.

MCP của Scrptly hiện hỗ trợ công cụ sau:

Tạo Video AI — generateAiVideo

Tạo video dựa trên lời nhắc văn bản và các hình ảnh ngữ cảnh tùy chọn.

Tham số Đầu vào:

  • prompt: [chuỗi] Một lời nhắc văn bản chi tiết để tạo video. Nó nên bao gồm thời lượng video, phong cách hình ảnh, cốt truyện/nội dung và bất kỳ điều gì liên quan để tạo ra video chất lượng cao.
  • context : [mảng các đối tượng] Một mảng tùy chọn các hình ảnh ngữ cảnh để hướng dẫn quá trình tạo video. Mỗi hình ảnh nên có một URL và mô tả ngắn gọn.
    • context[].url : [chuỗi] URL của hình ảnh ngữ cảnh sẽ được sử dụng trong quá trình tạo video.
    • context[].description : [chuỗi] Mô tả ngắn gọn về hình ảnh ngữ cảnh và cách nó nên được sử dụng trong video.
  • approveUpTo : [số] Chi phí tối đa (tính bằng token) mà người dùng chấp thuận để tạo video. Tùy chọn nhưng rất được khuyến nghị. Mặc định là 10.000 token.

Tham số Đầu ra:

  • taskId: [chuỗi] ID của tác vụ được tạo để tạo video AI.
  • projectId: [chuỗi] ID của dự án video AI được tạo trên Scrptly.
  • projectUrl: [chuỗi] URL để xem và quản lý/tinh chỉnh dự án video AI đã tạo trên Scrptly.

Lấy Trạng thái Tác vụ — getTaskStatus

Kiểm tra trạng thái của tác vụ tạo video AI.

  • taskId: [chuỗi] ID của tác vụ tạo video AI cần kiểm tra trạng thái.

  • status: [chuỗi] Trạng thái hiện tại của tác vụ tạo video AI. Các giá trị có thể là 'awaiting', 'processing', 'success', và 'failed'.

  • statusMessage: [chuỗi] Thông báo chi tiết về trạng thái hiện tại của tác vụ.

  • resultVideoUrl: [chuỗi] URL của tệp video đã tạo, nếu tác vụ hoàn thành thành công.

  • projectId: [chuỗi] ID của dự án video AI được tạo trên Scrptly.

  • projectUrl: [chuỗi] URL để xem và quản lý/tinh chỉnh dự án video AI đã tạo trên Scrptly.