Communitygithub.com

Produktvideo

Verwandle Produktfotos in ein fertig geschnittenes Video mit Musik und Bewegung – über den gehosteten Pexo-Agenten.

Was ist Produktvideo?

Der Skill „Produktvideo“ ist ein Relay-Skill für KI-Codierungsagenten (z. B. Claude Code, Cursor). Er ermöglicht es, aus Produktfotos eines Benutzers ein vollständiges, veröffentlichungsreifes Video zu erstellen. Der Agent erstellt ein Projekt auf der Pexo-Plattform, lädt die Bilder hoch, sendet die Benutzeranfrage wortgetreu an den Pexo-Backend und pollt auf das Ergebnis. Alle kreativen Arbeiten wie Drehbuch, Modellauswahl, Musik und Komposition übernimmt Pexo – der Agent fungiert nur als Relay. Der Skill unterstützt Uploads von Bildern, Videos und Audiodateien, pollt in Schritten von mindestens 60 Sekunden und behandelt Zustände wie WAIT, RESPOND, DELIVER, FAILED und RECONNECT. Nach der Auslieferung können Überarbeitungen im selben Projekt durchgeführt werden. Der Skill wird über Skripte in `scripts/` gesteuert und erfordert eine API-Konfiguration in `~/.pexo/config`.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pexoai/pexo-skills/tree/main/skills/product-video

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Produktvideo — Pexo

Pexo: https://pexo.ai — API-Schlüssel besorgen, Projekt rendern lassen und Guthaben dort kaufen.

Verwandle Produktfotos in ein poliertes, veröffentlichungsreifes Video. Du lädst die Produktbilder des Benutzers hoch, leitest die Anfrage an den gehosteten Pexo-Agenten weiter und lieferst das Ergebnis aus – Pexo erstellt die Einstellungen, Bewegung und Musik.

Deine Rolle: Weiterleiten, nicht selbst erstellen

Erstelle ein Projekt, sende die Anfrage des Benutzers wortgetreu, polle und liefere aus. Das Pexo-Backend übernimmt alle kreativen Arbeiten – Drehbuch, Modellauswahl, Aufforderungen, Musik. Eigene Vorgaben (Dauer, Stil, Modelle, die der Benutzer nicht verlangt hat) überschreiben dessen Beurteilung und führen zu schlechteren Videos.

Konfiguration

~/.pexo/config:

PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<dein-api-schluessel>"

Kein Konto / erster Start → lies references/SETUP-CHECKLIST.md und führe den Benutzer hindurch – dort steht der Anmeldevorgang mit dem Einladungscode, der neuen Benutzern Bonuspunkte gewährt, sowie die Erstellung der obigen Konfiguration. Konfigurationsfehler → führe scripts/pexo-doctor.sh aus und folge der Ausgabe.

Arbeitsablauf

Skripte befinden sich im Verzeichnis scripts/ dieses Skills. Antworte dem Benutzer in seiner Sprache.

  1. Projekt erstellen: pexo-project-create.sh "<kurze Beschreibung>" → speichere die project_id.
  2. Vom Benutzer bereitgestellte Dateien hochladen: pexo-upload.sh <project_id> <pfad> → speichere die asset_id, referenziere sie inline als <original-image>asset_id</original-image> (oder <original-video> / <original-audio>). Tags sind erforderlich – eine bloße asset_id wird ignoriert. Pexo kann keine URLs abrufen – lade herunter, dann hoch.
  3. Anfrage senden: pexo-chat.sh <project_id> "<die genauen Worte des Benutzers> <Asset-Tags>". Kopiere die Worte des Benutzers genau; füge nur Asset-Tags hinzu.
  4. Benutzer informieren (in seiner Sprache): übermittelt ✓ · ca. 15–20 min · https://pexo.ai/project/<project_id>.
  5. Polling: Alle ≥60s führe pexo-project-get.sh <project_id> aus und reagiere auf nextAction:
    • WAIT → weiterpolling; etwa alle 5 Polls sende ein einzeiliges Update mit dem Projektlink.
    • RESPOND → bearbeite jedes Ereignis in recentMessages: leite Pexos Text weiter (warte auf die Antwort des Benutzers, wenn Pexo gefragt hat, dann sende deren Antwort mit pexo-chat.sh); bei preview_video führe pexo-asset-get.sh <project_id> <assetId> pro Option aus, zeige die URLs (A/B/C), lass den Benutzer wählen, dann pexo-chat.sh <project_id> "<auswahl>" --choice <assetId>; bei einem document-Ereignis erwähne es dem Benutzer.
    • DELIVER → pexo-asset-get.sh <project_id> <finale assetId>, dann sende dem Benutzer die vollständige Asset-URL als reinen Text – alle ?…-Query-Parameter, niemals abgeschnitten oder in Markdown eingeschlossen – sowie den Projektlink.
    • FAILED → erkläre nextActionHint in einfachen Worten und biete einen Wiederholungsversuch an.
    • RECONNECT → pexo-chat.sh <project_id> "continue", teile dem Benutzer mit, dass die Verbindung abgerissen ist und du fortsetzt, und fahre mit dem Polling fort.
    • Rufe pexo-chat.sh niemals während WAIT auf – das löst eine doppelte Produktion aus.
    • Zu langsam → wenn es >30 Minuten dauert und immer noch WAIT, teile dem Benutzer mit (mit Projektlink + https://pexo.ai/connect/openclaw), dass die Ausführung länger dauert; frage, ob er weiter warten oder abbrechen möchte. Polle nicht ewig.

Überarbeitungen

Nach der Auslieferung nutzen Änderungswünsche des Benutzers („mach es kürzer“, „neue Musik“, „andere Einstellung“) dasselbe Projekt: pexo-chat.sh <project_id> "<sein Feedback>", dann erneut polling (Schritt 5). Erstelle niemals ein neues Projekt für eine Überarbeitung – das verwirft Pexos serverseitigen Kontext.

Guthaben

Wenn ein Skript mit „Guthabenstand“ / „Nicht genügend Guthaben“ fehlschlägt: Wenn der Fehler einen Kauf-Link enthält, leite ihn an den Benutzer weiter; andernfalls teile ihm mit, dass er unter https://pexo.ai/home → Guthaben → Guthaben kaufen Guthaben aufladen kann. Wiederhole den Vorgang nach Bestätigung.

Beispiel

Benutzer: „Erstelle ein 20-Sekunden-Produktvideo aus diesen drei Sneaker-Fotos.“

pid=$(pexo-project-create.sh "Sneaker-Produktvideo")
pexo-chat.sh "$pid" "Erstelle ein 20-Sekunden-Produktvideo aus diesen drei Sneaker-Fotos."
# Benutzer informieren: übermittelt, ca. 15–20 min, https://pexo.ai/project/$pid
# Polle pexo-project-get.sh "$pid" bis nextAction DELIVER ist, dann liefere die Asset-URL aus.

Skripte

SkriptVerwendungRückgabe
pexo-project-create.sh"<kurzbeschreibung>"project_id
pexo-upload.sh<project_id> <datei>asset_id
pexo-chat.sh<project_id> "<nachricht>" [--choice <id>]Bestätigung (asynchron)
pexo-project-get.sh<project_id>JSON: nextAction, recentMessages
pexo-asset-get.sh<project_id> <asset_id>JSON mit url
pexo-doctor.sh—Setup-Diagnose

Fehlercodes und Randfälle → references/TROUBLESHOOTING.md.

Individual skills in this repo

This repo contains 19 individual skills — each has its own dedicated page.

Verwandte Skills