Communitygithub.com

Produkt-Video

Plane und erstelle kurze Produkt- und E-Commerce-Videos mit Makernice, wie Produktpräsentationen, Werbeclips und Marktplatz-Listing-Videos. Deckt die Auswahl des Modus, das Schreiben des Prompts, die Wahl von Seitenverhältnis und Auflösung, die Preisprüfung und die Ausführung des Jobs ab.

Was ist Produkt-Video?

Diese Fähigkeit ermöglicht es einem KI-Agenten, mit der Makernice-Plattform kurze Produktvideos zu planen und zu generieren. Sie führt den Agenten durch einen Schritt-für-Schritt-Prozess: Erfassen der Produktdetails (Name, Foto, Verwendungszweck), Auswahl des geeigneten Modells und Modus (z.B. Bild-zu-Video, Text-zu-Video), Erstellen eines präzisen Prompts, Berechnung der Kosten und schließlich Ausführung des Generierungsjobs, nachdem der Benutzer zugestimmt hat. Die Fähigkeit behandelt wichtige Aspekte wie Seitenverhältnisse für verschiedene Plattformen (TikTok, YouTube, Marktplätze), Auflösungsoptionen (720p für Entwürfe, 1080p für Finale), Preisberechnung und Fehlerbehandlung (Netzwerkfehler, Ablehnungen, Budgetüberschreitungen). Sie unterstützt mehrere Referenzbilder, negative Prompts und die Verwaltung mehrerer Clips für längere Videos. Der Agent muss sich strikt an die Vorgaben halten, insbesondere bei der Verwendung eindeutiger request_ids und der korrekten Preisweitergabe.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/makernice/makernice-plugin/tree/HEAD/skills/product-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Produkt-Video?

Verwandle ein Produkt (idealerweise mit einem Foto) in einen kurzen Videoclip. Antworte in der Sprache des Benutzers. Alle Preise sind in USD.

1. Sammle die Kurzbeschreibung

Frage nur nach dem, was fehlt:

  • Produkt: was es ist, Material, Farbe, Größe, die eine Eigenschaft, die gezeigt werden soll.
  • Produktfoto: ein öffentlicher https-Link zu einem sauberen Foto. Lokale Dateien und private Links funktionieren nicht; der Benutzer muss das Bild zunächst unter einer öffentlichen https-URL hosten.
  • Wo es verwendet wird: dies bestimmt das Seitenverhältnis.
    • TikTok, Reels, Shorts, Stories: 9:16
    • Website-Hero, YouTube, Landingpage: 16:9
    • Marktplatz-Listing, Feed-Post: 1:1 (falls das Modell es anbietet)
  • Länge und Budget: die meisten Clips sind 5 bis 10 Sekunden lang. Für ein längeres Video plane mehrere kurze Clips anstelle eines langen.

2. Wähle Modell und Modus

Rufe list_models auf, dann rufe es erneut mit auf ein Kandidaten-ID gesetztem model auf, um dessen modes, aspect_ratios, durations, options und max_prompt_chars zu sehen.

  • Foto verfügbar: verwende einen i2v-Modus mit dem Foto als image_url. Dies bewahrt die tatsächliche Form, das Etikett und die Farbe des Produkts.
  • Mehrere Referenzfotos (Produkt aus verschiedenen Winkeln): verwende einen r2v-Modus, falls das Modell einen hat, mit reference_images, innerhalb von max_references.
  • Kein Foto: verwende einen t2v-Modus und beschreibe das Produkt genau.
  • Wenn ein Modell negative_prompt in options aufführt, kannst du es für Dinge wie „verzerrtes Etikett, zusätzliche Teile, unscharf“ verwenden.

3. Schreibe den Prompt

Ein Clip, eine Einstellung. Baue den Prompt in dieser Reihenfolge auf:

  1. Subjekt: das genaue Produkt, mit Material und Farbe („eine mattschwarze Keramikkaffeetasse mit Korkboden“).
  2. Aktion oder Kamerabewegung: nur eine Bewegung, zum Beispiel langsames Heranzoomen, sanfte 360-Grad-Umrundung, Draufsicht von oben, Makro-Schwenk über die Textur, Hand, die es aufhebt.
  3. Umgebung und Licht: Oberfläche, Hintergrund, Beleuchtung („auf einem hellen Eichentisch, sanftes Morgenfensterlicht, geringe Schärfentiefe“).
  4. Stil und Tempo: „sauberer Werbelook, ruhiges Tempo“.

Tipps:

  • Bitte das Modell nicht, Wörter, Preise oder Logos als Text darzustellen; sie kommen oft verzerrt heraus. Füge Text später in einem Editor hinzu.
  • Beschreibe bei i2v die Bewegung und die Szene, nicht das Aussehen des Produkts; das Foto definiert es bereits.
  • Bleibe unter max_prompt_chars.

Beispiel:

Eine mattschwarze Keramikkaffeetasse mit Korkboden auf einem hellen Eichentisch, aufsteigender Dampf, die Kamera fährt langsam heran, sanftes Morgenfensterlicht, geringe Schärfentiefe, sauberer Werbelook, ruhiges Tempo.

4. Auflösung und Preis

  • Erstelle zuerst einen Entwurf in 720p, um Bewegung und Bildausschnitt zu prüfen; das kostet weniger. Erstelle das Finale in 1080p für Webseite, Anzeigen oder große Bildschirme. 720p ist oft genug für Handy-Feeds.

  • Rufe estimate_cost für den Entwurf und die finalen Optionen auf und zeige dem Benutzer beide Preise, bevor etwas ausgeführt wird:

    {"input": {"model": "<model id>", "mode": "i2v", "prompt": "Eine mattschwarze Keramikkaffeetasse auf einem hellen Eichentisch, aufsteigender Dampf, die Kamera fährt langsam heran, sanftes Morgenlicht", "image_url": "https://example.com/tasse.jpg", "duration": 5, "resolution": "720p", "aspect_ratio": "9:16"}}
    

5. Generiere, nachdem der Benutzer zugestimmt hat

Rufe generate erst auf, nachdem der Benutzer den Preis gesehen und zugestimmt hat. Wenn der Benutzer bereits ein Budget festgelegt und dir grünes Licht gegeben hat, darfst du starten, ohne erneut zu fragen, solange der amount_usd innerhalb dieses Budgets liegt; verwende trotzdem den amount_usd, nicht das Budget, als max_cost_usd.

  • max_cost_usd: erforderlich. Verwende den genehmigten amount_usd von estimate_cost, genau wie zurückgegeben. Der Job wird abgelehnt, wenn der Preis höher ist.
  • request_id: erforderlich und eindeutig für jeden neuen Job, druckbares ASCII ohne Leerzeichen, maximal 64 Zeichen, zum Beispiel tasse-orbit-720p-1. Eine verwendete ID kann niemals für einen anderen Job wiederverwendet werden.
  • Wenn generate mit einem Netzwerkfehler, einem Timeout, einem Systemfehler oder „Zu viele Anfragen“ fehlschlägt, warte ein paar Sekunden und wiederhole es mit demselben input, demselben max_cost_usd und derselben request_id. Dieselbe ID gibt denselben Job zurück und wird nie zweimal berechnet.
{"input": {"model": "<model id>", "mode": "i2v", "prompt": "Eine mattschwarze Keramikkaffeetasse auf einem hellen Eichentisch, aufsteigender Dampf, die Kamera fährt langsam heran, sanftes Morgenlicht", "image_url": "https://example.com/tasse.jpg", "duration": 5, "resolution": "720p", "aspect_ratio": "9:16"}, "max_cost_usd": "<amount_usd von estimate_cost>", "request_id": "tasse-orbit-720p-1"}

Warte mit check_job, übergib job_id und setze wait_s auf 55; wenn der Job noch läuft, folge next_step und rufe erneut mit wait_s 55 auf. Führe keine enge Polling-Schleife aus.

Bei Erfolg gib den Ergebnislink von outputs und die console_url an. Links verfallen nach 24 Stunden; check_job gibt frische zurück. Wenn ein Output den state blocked und keine url hat, hat die Sicherheitsprüfung das Ergebnis nach der Generierung ausgeblendet; dieser Job wird trotzdem berechnet, und der Benutzer kann Makernice kontaktieren, um es überprüfen zu lassen. Fehlgeschlagene Jobs werden nicht berechnet; teile dem Benutzer den Grund aus error mit.

Für ein Multi-Clip-Video führe einen Job pro Clip aus, jeder mit eigenem estimate_cost, max_cost_usd und neuer request_id, und gib dem Benutzer die laufende Summe.

Umgang mit Ablehnungen

  • Preis über max_cost_usd: zeige den neuen Preis und frage nach, bevor du es mit einem neuen max_cost_usd und einer neuen request_id erneut versuchst.
  • Über dem Limit pro Job: schlage 720p oder eine kürzere Dauer vor, oder der Benutzer kann das Limit pro Job auf Makernice erhöhen.
  • Nicht genügend Guthaben oder Tageslimit erreicht: rufe get_balance auf und erkläre es. Wenn das get_topup_link-Tool verfügbar ist und der Benutzer fragt, wie er Guthaben aufladen kann, gib den Link einmal.
  • Falsche Einstellungen bei einem in der Warteschlange befindlichen Job: cancel_job mit seiner job_id gibt den reservierten Betrag vollständig frei.

Verwandte Skills