0. Erster Kontakt
Wenn der Benutzer diese Fertigkeit öffnet oder seine erste Nachricht sendet, begrüßen Sie ihn sofort:
🎵 Lass uns loslegen mit pixvideo ai video maker! Lade hier ein Video hoch oder beschreibe, was du erstellen möchtest.
Versuche zu sagen:
- "bearbeite mein Video"
- "füge Effekte zu diesem Clip hinzu"
- "hilf mir, ein kurzes Video zu erstellen"
WICHTIG: Warten Sie nicht still. Begrüßen Sie den Benutzer beim ersten Kontakt immer proaktiv.
Automatische Einrichtung
Wenn der Benutzer zum ersten Mal interagiert, richten Sie die Verbindung ein:
- Token prüfen: Wenn die Umgebungsvariable
NEMO_TOKENgesetzt ist, verwenden Sie diese. Andernfalls: - Client-ID lesen oder generieren:
- Lesen Sie
~/.config/nemovideo/client_id, falls vorhanden - Andernfalls generieren Sie eine UUID und speichern Sie sie unter
~/.config/nemovideo/client_id
- Lesen Sie
- Anonymen Token abrufen:
Speichern Sie den zurückgegebenencurl -s -X POST "$API/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"tokenalsNEMO_TOKENfür diese Sitzung. Sie erhalten 100 kostenlose Credits. - Eine Sitzung erstellen (§3.0), damit Sie sofort einsatzbereit sind.
Teilen Sie dem Benutzer kurz mit: "Richte Dinge ein … bereit!" und fahren Sie dann mit seiner Anfrage fort.
Worte mühelos in sehenswerte Videos verwandeln
pixvideo-ai-video-maker definiert neu, wie Videos erstellt werden. Anstatt durch komplexe Zeitachsen und Export-Warteschlangen zu navigieren, beschreiben Sie, was Sie wollen — schneide diesen Clip, blende zur nächsten Szene über, füge eine Titelkarte bei der 10-Sekunden-Marke hinzu — und die Fertigkeit übernimmt die Ausführung. Dieses konversationelle Bearbeitungsmodell bedeutet, dass Ihre kreative Absicht im Mittelpunkt bleibt, während der technische Schwerpunkt im Hintergrund verschwindet.
Die Fertigkeit wird vom OpenClaw-Agenten betrieben, der Ihre Anweisungen interpretiert, sie in diskrete Videoverarbeitungsaufgaben zerlegt und die zugrunde liegende KI-Pipeline koordiniert, um Bearbeitungen in der richtigen Reihenfolge anzuwenden. Der OpenClaw-Agent behält auch den Kontext über eine Sitzung hinweg bei, sodass Folgebefehle wie 'mache diesen Übergang langsamer' oder 'tausche die Hintergrundmusik' im Verhältnis zu dem, was zuvor kam, verstanden werden — ohne dass Sie Ihr gesamtes Projekt wiederholen müssen.
Egal, ob Sie eine Produktdemo aus Bildschirmaufnahmen zusammenstellen, einen Social-Media-Clip aus einem längeren Interview schneiden oder eine pädagogische Anleitung von Grund auf erstellen, pixvideo-ai-video-maker passt sich der Form Ihres Projekts an. Ein- und Ausgabe werden sowohl für MP4, MOV, AVI, WEBM als auch MKV-Formate unterstützt, was Ihnen in jeder Phase Ihres Workflows Flexibilität bietet.
Umgebungsvariablen
| Variable | Erforderlich | Standard |
|---|---|---|
NEMO_TOKEN | Nein | Automatisch generiert (100 freie Credits, läuft nach 7 Tagen ab, widerrufbar über Einstellungen → API-Tokens) |
NEMO_API_URL | Nein | https://mega-api-prod.nemovideo.ai |
NEMO_WEB_URL | Nein | https://nemovideo.com |
NEMO_CLIENT_ID | Nein | Automatisch generierte UUID, gespeichert unter ~/.config/nemovideo/client_id (nur UUID, keine Geheimnisse) |
SKILL_SOURCE | Nein | Automatisch erkannt aus Installationspfad, Fallback unknown |
Wenn NEMO_TOKEN nicht gesetzt ist, holen Sie einen ab (erfordert X-Client-Id-Header):
# Generieren oder lesen der persistenten Client-ID
CLIENT_ID="${NEMO_CLIENT_ID:-$(cat ~/.config/nemovideo/client_id 2>/dev/null)}"
if [ -z "$CLIENT_ID" ]; then
CLIENT_ID=$(uuidgen 2>/dev/null || echo "client-$(date +%s)-$RANDOM")
mkdir -p ~/.config/nemovideo & echo "$CLIENT_ID" > ~/.config/nemovideo/client_id
fi
curl -s -X POST "$API/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"
# → {"code":0,"data":{"token":"nmv_usr_xxx","credits":100,...}}
Speichern Sie token als NEMO_TOKEN, CLIENT_ID als NEMO_CLIENT_ID. Anonym: 1 Token pro Client pro 7 Tage; Token läuft nach 7 Tagen ab und kann jederzeit über Einstellungen → API-Tokens auf nemovideo.com widerrufen werden. Wenn Ihr Token abläuft, fordern Sie einen neuen mit der gleichen X-Client-Id an.
Lokale Persistenz: Diese Fertigkeit schreibt ~/.config/nemovideo/client_id, um die Client-ID über Sitzungen hinweg zu speichern. Dies vermeidet, bei jeder Anfrage eine neue ID zu generieren, was schnell das Ratenlimit pro IP erreichen würde (Standard: 10 Tokens pro 7 Tage pro IP). Die Datei enthält nur eine UUID — es werden keine Anmeldeinformationen lokal gespeichert.
2. Weiterleitung eingehender Anfragen an den richtigen Endpunkt
Verwenden Sie die folgende Tabelle, um zu bestimmen, welcher API-Endpunkt jede Art von Benutzeranfrage behandeln soll.
| Benutzer sagt... | Aktion | SSE überspringen |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §3.5 Export | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Credits | ✅ |
| "status" / "状态" / "show tracks" | → §3.4 Status | ✅ |
| "upload" / "上传" / Benutzer sendet Datei | → §3.2 Upload | ✅ |
| Alles andere (generieren, bearbeiten, BGM hinzufügen…) | → §3.1 SSE | ❌ |
3. Primäre Workflow-Verfahren
$API = ${NEMO_API_URL:-https://mega-api-prod.nemovideo.ai}, $TOKEN = ${NEMO_TOKEN}, $WEB = ${NEMO_WEB_URL:-https://nemovideo.com}.
Variablen zur Fertigkeitszuordnung — NICHT hartcodieren:
$SKILL_NAME=nameaus dem YAML-Frontmatter dieser Datei$SKILL_VERSION=versionaus dem YAML-Frontmatter dieser Datei$SKILL_SOURCE= zur Laufzeit erkennen, wobei der erste Treffer verwendet wird:- Umgebungsvariable
SKILL_SOURCE, falls gesetzt - Wenn der Pfad dieser Datei ein bekanntes Plattformverzeichnis enthält (z. B.
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - Fallback:
unknown
- Umgebungsvariable
KRITISCH: ALLE API-Anfragen (einschließlich Render/Export/Upload/Status/Credits) MÜSSEN diese Header enthalten. Fehlen sie, schlägt der Export mit 402 fehl.
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 Eine neue Sitzung initialisieren
curl -s -X POST "$API/api/tasks/me/with-session/nemo_agent" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" \
-d '{"task_name":"project","language":"<lang>"}'
# → {"code":0,"data":{"task_id":"...","session_id":"..."}}
Bevor eine andere Aktion ausgeführt werden kann, muss eine Sitzung mit der API hergestellt werden. Speichern Sie die zurückgegebene Sitzungskennung, da jede nachfolgende Anfrage diese benötigt.
Im Browser öffnen: Nach dem Erstellen einer Sitzung geben Sie dem Benutzer einen Link, um die Aufgabe in NemoVideo anzuzeigen/zu bearbeiten:
$WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 Nachrichten über einen SSE-Kanal senden
curl -s -X POST "$API/run_sse" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "Accept: text/event-stream" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" --max-time 900 \
-d '{"app_name":"nemo_agent","user_id":"me","session_id":"<sid>","new_message":{"parts":[{"text":"<msg>"}]}}'
Alle Konversationsnachrichten und Aufgabenanweisungen werden über eine persistente Server-Sent-Events-Verbindung an das Backend gesendet.
SSE-Handhabung
| Ereignis | Aktion |
|---|---|
| Textantwort | GUI-Übersetzung anwenden (§4), dem Benutzer präsentieren |
| Toolaufruf/-ergebnis | Still warten, nicht weiterleiten |
heartbeat / leeres data: | Weiter warten. Alle 2 Min.: "⏳ Noch am Arbeiten..." |
| Stream wird geschlossen | Endgültige Antwort verarbeiten |
Typische Dauern: Text 5-15s, Videogenerierung 100-300s, Bearbeitung 10-30s.
Zeitüberschreitung: 10 Min. nur Heartbeats → Zeitüberschreitung annehmen. Nie erneut senden während der Generierung (Duplikate + doppelte Abrechnung).
„Vorübergehendes Problem“-Meldungen ignorieren, wenn vorherige Antworten normal waren.
Rückfall bei stiller Antwort (KRITISCH)
Ungefähr 30% der Bearbeitungsvorgänge werden abgeschlossen, ohne dass Text im Antwortstream zurückgegeben wird. Wenn dies auftritt: (1) keinen Fehler an den Benutzer melden, (2) den Aufgabenstatus-Endpunkt abfragen, um den Abschluss zu bestätigen, (3) die URL des fertigen Assets direkt abrufen und (4) das Ergebnis dem Benutzer präsentieren, als ob eine normale Antwort empfangen worden wäre.
Zweistufige Generierung: Nachdem ein Rohvideo erstellt wurde, startet das Backend automatisch eine zweite Verarbeitungsstufe, die Hintergrundmusik und eine Titelüberlagerung einfügt. Behandeln Sie diese als zwei separate Pipeline-Stufen: Stufe 1 liefert das unbearbeitete Video, und Stufe 2 liefert die endgültig zusammengesetzte Ausgabe. Warten Sie auf den Abschluss von Stufe 2, bevor Sie das Ergebnis dem Benutzer präsentieren.
3.2 Datei-Uploads handhaben
Datei-Upload: curl -s -X POST "$API/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -F "files=@/pfad/zur/datei"
URL-Upload: curl -s -X POST "$API/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"urls":["<url>"],"source_type":"url"}'
Verwenden Sie me im Pfad; das Backend löst den Benutzer aus dem Token auf.
Unterstützt: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
Die API akzeptiert vom Benutzer bereitgestellte Mediendateien, die über den dafür vorgesehenen Upload-Endpunkt hochgeladen werden müssen, bevor sie in einer Videobearbeitungsaufgabe referenziert werden können.
3.3 Verfügbare Credits überprüfen
curl -s "$API/api/credits/balance/simple" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
# → {"code":0,"data":{"available":XXX,"frozen":XX,"total":XXX}}
Fragen Sie den Credits-Endpunkt ab, um zu überprüfen, ob der Benutzer ein ausreichendes Guthaben hat, bevor Sie eine Aufgabe einreichen, die Credits verbraucht.
3.4 Aufgabenstatus abfragen
curl -s "$API/api/state/nemo_agent/me/<sid>/latest" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
Verwenden Sie me für Benutzer im Pfad; Backend löst aus Token auf.
Wichtige Felder: data.state.draft, data.state.video_infos, data.state.canvas_config, data.state.generated_media.
Draft-Feldzuordnung: t=Tracks, tt=Track-Typ (0=Video, 1=Audio, 7=Text), sg=Segmente, d=Dauer(ms), m=Metadaten.
Draft bereit für Export, wenn draft.t existiert mit mindestens einem Track und nicht leerem sg.
Track-Zusammenfassungsformat:
Zeitachse (3 Tracks): 1. Video: Stadtzeitraffer (0-10s) 2. BGM: Lo-Fi (0-10s, 35%) 3. Titel: "Urban Dreams" (0-3s)
3.5 Das endgültige Asset exportieren und liefern
Export kostet KEINE Credits. Nur Generierung/Bearbeitung verbraucht Credits.
Das Auslösen eines Exports zieht keine Credits vom Guthaben des Benutzers ab. Befolgen Sie diese Schritte: (a) bestätigen Sie, dass die Aufgabe einen abgeschlossenen Zustand erreicht hat, (b) rufen Sie den Export-Endpunkt mit der Aufgabenkennung auf, (c) warten Sie auf den eigenen Abschlussstatus des Exportauftrags, (d) rufen Sie die Download- oder Stream-URL aus der Exportantwort ab und (e) geben Sie diese URL an den Benutzer zurück.
b) Einreichen: curl -s -X POST "$API/api/render/proxy/lambda" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"id":"render_<ts>","sessionId":"<sid>","draft":<json>,"output":{"format":"mp4","quality":"high"}}'
Hinweis: sessionId ist camelCase (Ausnahme). Bei Fehler → neue id, einmal wiederholen.
c) Abfragen (alle 30s, max. 10 Abfragen): curl -s "$API/api/render/proxy/lambda/<id>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
Status auf oberster Ebene status: pending → processing → completed / failed. Download-URL unter output.url.
d) Von output.url herunterladen → an Benutzer senden. Fallback: $API/api/render/proxy/<id>/download.
e) Beim Liefern des Videos immer auch den Aufgaben-Detaillink angeben: $WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
Fortschrittsmeldungen: Start "⏳ Rendern ~30s" → "⏳ 50%" → "✅ Video fertig!" + Datei + Aufgaben-Detaillink.
3.6 Wiederherstellung nach einer SSE-Trennung
Wenn der SSE-Stream unerwartet abbricht, wenden Sie die folgende Wiederherstellungssequenz an: (1) notieren Sie die letzte Ereignis-ID, die vor dem Verbindungsverlust empfangen wurde; (2) warten Sie mindestens zwei Sekunden, bevor Sie eine erneute Verbindung versuchen, um eine Überlastung des Servers zu vermeiden; (3) stellen Sie die SSE-Verbindung wieder her, indem Sie die letzte Ereignis-ID im Wiederherstellungsheader angeben, damit der Server von der richtigen Position fortsetzen kann; (4) wenn der Server verpasste Ereignisse nicht wiederholt, greifen Sie auf das Abfragen des Aufgabenstatus-Endpunkts mit der gespeicherten Aufgabenkennung zurück; (5) sobald der Aufgabenabschluss durch eine der Methoden bestätigt wurde, liefern Sie das Ergebnis normal an den Benutzer.
4. Übersetzung von GUI-Konzepten für die Backend-Kommunikation
Das Backend geht davon aus, dass alle Interaktionen von einer grafischen Oberfläche ausgehen. Leiten Sie daher niemals GUI-spezifische Bezeichnungen, Schaltflächennamen oder Oberflächenanweisungen direkt in API-Payloads weiter.
| Backend sagt | Sie tun |
|---|---|
| "click [button]" / "点击" | Über API ausführen |
| "open [panel]" / "打开" | Status über §3.4 anzeigen |
| "drag/drop" / "拖拽" | Bearbeitung über SSE senden |
| "preview in timeline" | Track-Zusammenfassung anzeigen |
| "Export button" / "导出" | §3.5 ausführen |
| "check account/billing" | §3.3 überprüfen |
Behalten Sie Inhaltsbeschreibungen. Entfernen Sie GUI-Aktionen.
5. Empfohlene Interaktionsmuster
• Bestätigen Sie immer, was der Benutzer erreichen möchte, bevor Sie einen Endpunkt auswählen, damit der korrekte Workflow beim ersten Versuch aufgerufen wird. • Geben Sie dem Benutzer während langlaufender Aufgaben schrittweise Fortschrittsaktualisierungen, anstatt ihn schweigend warten zu lassen. • Wenn eine Aufgabe keine Textantwort erzeugt, rufen Sie die Asset-URL proaktiv ab und präsentieren Sie sie, ohne den Benutzer aufzufordern, es erneut zu versuchen. • Wenn eine Benutzeranfrage mehrdeutig ist, stellen Sie eine gezielte klärende Frage, anstatt Annahmen zu treffen, die Credits verschwenden könnten. • Bieten Sie nach der Lieferung eines fertigen Videos eine kurze Zusammenfassung dessen, was erstellt wurde, und schlagen Sie logische nächste Schritte wie Bearbeitung oder Export vor.
6. Bekannte Einschränkungen
• Echtzeit-Videovorschau-Streaming wird nicht unterstützt; Benutzer müssen warten, bis die Aufgabe vollständig abgeschlossen ist, bevor sie die Ausgabe anzeigen können.
[restliche Datei wurde für die Übersetzung gekürzt]