Velin Motion Clips 1.3.0

Clip Motion macht aus Standbildern kurze Motion-Clips per CLI. Getrennt von Page Motion (DOM-Registry / velin-motion-Attribute). Package @birdapi/velinstyle-motion. English

Versionsverlauf

1 Releasesv1.3.0

Bild→Clip-Pipeline über `@birdapi/velinstyle-motion` (lokal + optional PixVerse).

1.3.0NeuMotion Clips

Lokale Clip-Engine, Presets, CLI-Wizard, PixVerse-Provider, `.velin/motion/`-Config; Validierung leerer/falscher Inputs.

Motion-Package installieren; PixVerse-Keys nie committen. Leere / Nicht-Bild-Inputs werden vor der Verarbeitung abgelehnt.

Änderungsprotokoll Aktualisieren

Lokal vs AI

	Lokal (Standard)	AI
Engine	CSS / Web Animations HTML	Provider-API (zuerst PixVerse)
Kosten	Kostenlos, offline	Credits + API-Key
Ausgabe	`.html` + `.css`-Clip	MP4 (oder Dry-Run-Manifest)
Reproduzierbar	Ja	Abhängig von Provider/Seed

Schnellstart

# Interaktiver Wizard
velinstyle motion create atelier.webp

# Non-interaktiv
velinstyle motion create hero.png --preset cinematic --yes -o ./motion-output

# Shortcuts
velinstyle motion zoom logo.png --yes
velinstyle motion pan shot.webp --duration 5 --yes

# Clip-Presets
velinstyle motion presets --clips

Eingabe: Datei muss existieren, nicht leer sein, Endung .webp / .png / .jpg / .jpeg haben und echte PNG/JPEG/WebP-Daten enthalten (leere Dateien und umbenannte Textdateien werden abgewiesen).

create ohne --yes öffnet einen TTY-Wizard: Soft Zoom / Cinematic / Atelier Reveal / Rotate / Particle Reveal / Rotate + Explosion / AI Animation / eigener Mini-Prompt → bestätigen → Clip schreiben.

Mini-Prompts

velinstyle motion create atelier.webp --ai
# Was soll passieren?
# > rechts rein

VelinStyle schlägt strukturierte Profile vor und übersetzt sie in ein Motion-Profil / AI-Prompt-Template. Du schreibst keine rohen PixVerse-Prompts.

Atelier

velinstyle motion atelier ./assets --count 10 --preset atelier --yes

Verarbeitet N Bilder → Clips unter ./motion-output/ mit Summary (Anzahl · Gesamtdauer).

Transition & Sequence

velinstyle motion transition a.webp b.webp --yes
velinstyle motion sequence 01.webp 02.webp 03.webp --provider pixverse --yes

AI-Pfad nutzt Provider-Capabilities (transition, multi_transition, 2–7 Keyframes). Ohne Key: motion setup pixverse oder Env. Mit --yes ohne Key → Exit 1.

Konfiguration

Unter .velin/motion/ (config.json, .env, presets/, jobs/, cache/):

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

Niemals Klartext-API-Key in config.json. Env PIXVERSE_API_KEY oder .velin/motion/.env. Keys werden nie geloggt, in --json oder Manifesten ausgegeben.

Ausführlicher Partner-Leitfaden: PixVerse einrichten.

PixVerse-Setup

AI-Animationen laufen über externe Anbieter. PixVerse ist ein unterstützter Partner — kein VelinStyle-Kernfeature. Branding: VelinStyle Motion · AI Provider: PixVerse.

velinstyle motion providers
velinstyle motion setup pixverse

CLI: velinstyle motion setup pixverse — Menü: Partnerlink öffnen · Partnerlink kopieren · API-Key eingeben (Affiliate-first; kein nackter Platform-Bypass)
API-Key im PixVerse-Konto anlegen
Key einfügen — Speichern in .velin/motion/.env
velinstyle motion create image.webp --ai --yes

Wenn der Partnerlink nicht öffnet (Tracker-/Cookie-Blocker), bietet die CLI Erneut versuchen oder Link kopieren — keinen Direct-Bypass. Ausführlich: PixVerse einrichten.

Jeder Live-Request sendet API-KEY + auto-generierte Ai-trace-id (UUID). Mit --yes und ohne Key → Exit 1. Dry-Run nur mit VELIN_MOTION_DRY_RUN=1. Docs: docs.platform.pixverse.ai.

Usage

velinstyle motion usage

Zeigt Clip-Zähler (heute / Woche) und einen PixVerse-Credit-Hinweis aus lokalen Job-Manifesten.

Velin Motion (Page) · CLI-Referenz