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). Each chip and demo card opens the same PixVerse account signup (VelinStyle partner / affiliate link) — not an in-product feature deep link.

• 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 Motion CLI cannot work with affiliate branding alone. For VelinStyle documentation and setup, always use this affiliate signup link — never a bare platform.pixverse.ai signup bypass.

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). English meaning below; the interactive CLI currently prints this menu in German with the same steps:

PixVerse Setup

VelinStyle uses PixVerse as an AI provider.

You need a PixVerse account and an API key.
VelinStyle opens the PixVerse account / signup page:

[1] Open PixVerse account
[2] Copy account link
[3] Enter API key
[4] Cancel

Note:
If your browser blocks the tracking link, temporarily
disable the tracker blocker for this step, or open the
copied account link in a browser without that blocking.

If opening the account page fails technically, the CLI shows (German UI; English meaning):

The PixVerse account page could not be opened
in this browser.

Reason:
A tracking or cookie blocker is likely preventing
attribution.

[1] Try again
[2] Copy link
[3] Cancel

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
velinstyle motion setup pixverse --yes

motion usage shows local today/week clip counts, a local PixVerse credit hint from job manifests, and — when an API key is present — the live PixVerse OpenAPI balance (credit_monthly, credit_package, total). Setup --yes also checks connection via the same balance endpoint. VelinStyle does not invent cost estimates; billing and top-ups stay in your PixVerse account. API credits are separate from PixVerse web-app credits.

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) · AI / Agent Resources · Motion showcase · PixVerse account · PixVerse API docs