1. Docs
2. Motion
3. PixVerse

PixVerse AI Video Partner beta Guide

Detailed setup and workflow for PixVerse as the optional AI video provider behind VelinStyle Motion Clips. You need a PixVerse account and an API key. Deutsch

Style demos

Color-matched capability previews in the PixVerse look (magenta · violet · orange). Open PixVerse via the VelinStyle partner link to try the real product.

• Text to Video
• Image to Video
• Start Now
• Viral Effects

What PixVerse is

PixVerse is an AI video platform for text-to-video and image-to-video. In VelinStyle it powers the optional AI path of Motion Clips (velinstyle motion … --provider pixverse / --ai) when you want MP4 output instead of the free local HTML/CSS clip engine.

• Text & Image to Video — prompt or still image → short clip
• Templates & effects — ready-made starts and viral-style effects on the platform
• API — key-based generation used by the VelinStyle CLI
• CLI / Agent / Canvas — PixVerse’s own tooling; VelinStyle integrates via API + setup wizard

Official API docs: docs.platform.pixverse.ai/.

Why it sits next to Motion Clips

Full clip CLI reference: Velin Motion Clips.

1. Create a PixVerse account

1. Open PixVerse and register or sign in to your account: PixVerse account (same destination as the banner above).
2. Confirm you can open the dashboard / create flows (Text to Video, Image to Video).

You need a real PixVerse account — the Motions CLI cannot work with affiliate branding alone.

2. Create an API key

1. In your PixVerse account, open the developer / API area (see API documentation for the current path).
2. Create an API key for automation.
3. Copy the key once — treat it like a password.

Never commit the key to git, paste it into config.json as plaintext, or put it in screenshots. Prefer environment variables.

3. Wire the key into VelinStyle (CLI)

velinstyle motion providers
velinstyle motion setup pixverse

Visible CLI menu (account + API key — no bare platform.pixverse.ai bypass):

PixVerse Setup

VelinStyle verwendet PixVerse als AI-Provider.

Du brauchst ein PixVerse-Konto und einen API-Key.
VelinStyle öffnet die PixVerse-Konto-/Signup-Seite:

[1] PixVerse-Konto öffnen
[2] Konto-Link kopieren
[3] API-Key eingeben
[4] Abbrechen

Hinweis:
Wenn dein Browser den Tracking-Link blockiert, deaktiviere
für diesen Vorgang deinen Tracking-Blocker oder öffne den
kopierten Konto-Link in einem Browser ohne entsprechende Blockierung.

If opening the account page fails technically, the CLI shows:

Die PixVerse-Konto-Seite konnte in diesem Browser nicht
geöffnet werden.

Grund:
Ein Tracking- oder Cookie-Blocker verhindert vermutlich
die Attribution.

[1] Erneut versuchen
[2] Link kopieren
[3] Abbrechen

Prefer saving the key to .velin/motion/.env:

PIXVERSE_API_KEY=your_key_here

Or export in the shell:

# Windows PowerShell
$env:PIXVERSE_API_KEY = "your_key_here"

# macOS / Linux
export PIXVERSE_API_KEY=your_key_here

Config under .velin/motion/config.json references the env var (example):

{
  "provider": "pixverse",
  "api_key": "${PIXVERSE_API_KEY}",
  "model": "v6",
  "quality": "720p",
  "default_duration": 5,
  "output_dir": "./motion-output",
  "pixverse": { "setup_completed": true }
}

pixverse.setup_completed stops the CLI from auto-reopening signup after the first successful setup.

4. First AI clip from the CLI

# Interactive (wizard can suggest AI)
velinstyle motion create atelier.webp --ai

# Non-interactive
velinstyle motion create hero.webp --provider pixverse --yes -o ./motion-output

# Transition / multi-keyframe (provider capabilities)
velinstyle motion transition a.webp b.webp --provider pixverse --yes
velinstyle motion sequence 01.webp 02.webp 03.webp --provider pixverse --yes

• Without a key and with --yes → exit code 1 (fail fast).
• Dry-run only via VELIN_MOTION_DRY_RUN=1 (no live credit spend).
• Each live request sends API-KEY + auto-generated Ai-trace-id (UUID).
• VelinStyle maps mini-prompts to structured profiles — you do not write raw PixVerse prompts in the Motions wizard.

5. Credits and usage

velinstyle motion usage

Shows local today/week clip counts and a PixVerse credit hint from job manifests. Actual balance and billing live in your PixVerse account — VelinStyle only reports what it can infer locally.

6. Using PixVerse on the web

Besides the CLI, the PixVerse product covers:

• Text to Video / Image to Video — core generation
• Templates & Marketing Hub — guided shorts for ads
• Agent — conversational direction of shots
• Canvas — node-based workflows
• PixVerse CLI — their terminal tool (separate from velinstyle motion)

For VelinStyle projects, prefer velinstyle motion so outputs land in ./motion-output/ with Velin manifests and usage tracking.

Checklist

• [ ] PixVerse account created / signed in
• [ ] API key created; stored in PIXVERSE_API_KEY / .velin/motion/.env
• [ ] velinstyle motion setup pixverse completed
• [ ] Test: velinstyle motion create sample.webp --ai --yes
• [ ] Optional: velinstyle motion usage

Try PixVerse

Related

Motion Clips guide · CLI · motion · Velin Motion (page) · Motion showcase · PixVerse account · PixVerse API docs