GenVR Skills — AI Media Generation & Utilities#

Generate images, videos, and perform various media processing tasks using the GenVR API. This standalone Node.js toolkit provides a pure CLI for interacting with GenVR's asynchronous task pipeline.

IMPORTANT: Most operations require a GENVR_API_KEY and a GENVR_UID. Get them from api.genvrresearch.com.

Usage#

Run via npx directly from the package:

List available models:

bash

npx genvr-skills list

Generate content (unified):

bash

npx genvr-skills generate --category imagegen --subcategory google_imagen3 prompt="A futuristic city in VR" height=1024 width=1024

Edit an image with Nano Banana 2:

bash

npx genvr-skills generate --category imgutils --subcategory google_nano_banana_2 image_url="https://media.genvr.com/assets/..." prompt="add a futuristic helmet"

Check job status:

bash

npx genvr-skills status --job-id "TASK_ID" --category "imagegen" --subcategory "google_imagen3"

Authentication#

Authentication is handled via environment variables:

Env VarDescriptionGENVR_API_KEYYour GenVR API TokenGENVR_UIDYour GenVR User ID

Core Commands#

list#

Lists all available categories and subcategories.

• --json: Output as raw JSON.

generate#

The primary command for starting new generation tasks.

• --category: The category of the model (e.g., imagegen).
• --subcategory: The specific model variant (e.g., google_imagen3).
• --filename: Optional output filename.
• --no-wait: Return immediately after starting the job.
• key=value: Model parameters (e.g., prompt="cat", steps=25).

status#

Retrieves the status or result of an existing task.

• --job-id: The ID returned by generate.
• --category: Required for v2 status check.
• --subcategory: Required for v2 status check.

Examples#

Generating a Cinematic 360 Panorama#

bash

npx genvr-skills generate --category 3dgen --subcategory panorama prompt="A hyper-realistic cinematic 360 panorama of an ancient bioluminescent forest at night, 8k resolution, ethereal lighting"

Professional Video Generation (Image-to-Video)#

Use a high-quality model like Google Veo 3 for image-to-video translation:

bash

npx genvr-skills generate --category videogen --subcategory google_veo3_i2v image_url="https://media.genvr.com/assets/..." prompt="The camera cinematicly glides through the scene as the bioluminescent plants begin to glow intensely, soft wind blowing through the leaves, masterpiece quality"

Filename Pattern#

Generated files follow the pattern: yyyy-mm-dd-hh-mm-ss-category.ext.

Tips#

• Run list frequently to see new tools added to the platform.
• Use --no-wait for video generation tasks, as they may take several minutes.
• Most models follow the standard OpenAPI schema; details at api.genvrresearch.com.