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)
- TikTok, Reels, Shorts, Stories:
- 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 alsimage_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, mitreference_images, innerhalb vonmax_references. - Kein Foto: verwende einen
t2v-Modus und beschreibe das Produkt genau. - Wenn ein Modell
negative_promptinoptionsauffü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:
- Subjekt: das genaue Produkt, mit Material und Farbe („eine mattschwarze Keramikkaffeetasse mit Korkboden“).
- 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.
- Umgebung und Licht: Oberfläche, Hintergrund, Beleuchtung („auf einem hellen Eichentisch, sanftes Morgenfensterlicht, geringe Schärfentiefe“).
- 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
i2vdie 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 in1080pfür Webseite, Anzeigen oder große Bildschirme.720pist oft genug für Handy-Feeds. -
Rufe
estimate_costfü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 genehmigtenamount_usdvonestimate_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 Beispieltasse-orbit-720p-1. Eine verwendete ID kann niemals für einen anderen Job wiederverwendet werden.- Wenn
generatemit einem Netzwerkfehler, einem Timeout, einem Systemfehler oder „Zu viele Anfragen“ fehlschlägt, warte ein paar Sekunden und wiederhole es mit demselbeninput, demselbenmax_cost_usdund derselbenrequest_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 neuenmax_cost_usdund einer neuenrequest_iderneut versuchst. - Über dem Limit pro Job: schlage
720poder 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_balanceauf und erkläre es. Wenn dasget_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_jobmit seinerjob_idgibt den reservierten Betrag vollständig frei.