JSPM

@visionengine/img2video

1.0.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 3
  • Score
    100M100P100Q33508F
  • License MIT

VisionEngine Image To Video MCP Server - Async image-to-video via backend proxy

Package Exports

  • @visionengine/img2video
  • @visionengine/img2video/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@visionengine/img2video) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

VE Image To Video MCP

Async MCP server for image-to-video generation via ve-backend proxy.

Environment

  • API_URL: backend proxy url, default https://api.visionengine-tech.com/api/v1/img2video
  • API_KEY: user API key from VisionEngine backend (required for submit/query and remote upload)
  • MODEL: platform model id, default @preset/vec-1-0-img2video
  • WORKDIR: local workspace root
  • DEFAULT_OUTPUT_DIR: default relative output directory, default public/videos
  • FILE_MODE: local file handling mode, local or remote, default remote
  • REMOTION_WORK_DIR: shared mount root used in local mode, default /vec
  • BASE_URL: backend public base url used for /save and /shared links, default https://api.visionengine-tech.com
  • REMOTE_IMAGE_UPLOAD_PATH: remote upload path for local images in remote mode, default public/images
  • REMOTE_AUDIO_UPLOAD_PATH: remote upload path for local audios in remote mode, default public/audios

Tools

  • submit
  • query

submit

Submit an async image-to-video task and receive a taskId for later polling.

imagePath supports:

  • public image URL
  • base64 image data URL
  • local image file path

audioPath supports:

  • public audio URL
  • local audio file path

When local files are used:

  • FILE_MODE=local: convert local absolute path to backend shared download URL by removing REMOTION_WORK_DIR prefix
  • FILE_MODE=remote (default): upload local file to backend /save, then convert returned file path to /shared/...?...download=true

Recommended upstream constraints:

  • image formats: JPEG/JPG/PNG/BMP/WEBP
  • image size: <= 10MB
  • image edge length: 240~8000 px
  • audio formats: mp3/wav preferred
  • audio size: <= 15MB
  • duration parameter: 2~15 seconds

query

Query a submitted task by taskId.

  • If still running, the tool returns current taskStatus and suggests querying again after about 15 seconds.
  • If succeeded, it returns outputVideoUrl and by default downloads the result locally.
  • Set downloadResult=false if you only want the current status or the remote result URL.

Note: upstream result URLs may expire within 24 hours, so prompt download is recommended.