HiAPI Produkt-Sprecher-Video

Was macht HiAPI Produkt-Sprecher-Video?

Erstellen Sie 3-15 Sekunden lange, einmalige Produktvideos mit der lokalen CLI. Schätzen Sie immer mit --dry-run, bevor Sie eine kostenpflichtige Anfrage stellen. Erstellen Sie eine kostenpflichtige Aufgabe nur, wenn der Benutzer die Generierung explizit genehmigt und der Befehl --spend enthält.

Leiten Sie das Szenario

Wählen Sie genau ein Szenario:

Szenario	Modell	Erforderliche Eingabe	P0-Standard
synthetic-spokesperson	kling-3.0-omni/text-to-video	Prompt und optionaler Dialog	3s, 720p, 9:16, Audio
talking-head	kling-3.0-omni/image-to-video	Ein autorisiertes Personenbild, Prompt, Dialog, Zustimmung	3s, 720p, Audio
product-intro	seedance-2.0-fast	Prompt und 1-9 Produktbilder	4s, 480p, 9:16, Audio
brand-promo	seedance-2.0-fast	Prompt und 1-9 Marken- oder Produktbilder	4s, 480p, 9:16, Audio

Bestätigen Sie vor dem Erstellen der Anfrage die Zieldauer. Falls der Benutzer sie nicht angegeben hat, fragen Sie, wie viele Sekunden das Video haben soll, und geben Sie den unterstützten Bereich an: Kling 3-15 Sekunden; Seedance 4-15 Sekunden. Bieten Sie den P0-Standard aus der Tabelle an, aber fahren Sie erst mit --dry-run fort, wenn der Benutzer eine Dauer gewählt oder den Standard explizit akzeptiert hat.

Lehnen Sie die talking-head-Generierung ab, es sei denn, der Benutzer bestätigt die Autorisierung und der Befehl enthält --consent-confirmed. Erfinden Sie keine Produktbehauptungen, Befürwortungen, Preise, Zertifizierungen oder Markenfakten.

Schützen Sie Ausgaben und Geheimnisse

Führen Sie zuerst die kostenlosen Prüfungen aus:

node scripts/hiapi-product-spokesperson-video.mjs --check --env-file "D:\path\to\.env.local"

Führen Sie dann die gewünschte Anfrage mit --dry-run aus. Bestätigen Sie, dass die öffentliche Preisschätzung innerhalb des Budgets des Benutzers liegt, bevor Sie --dry-run durch --spend ersetzen. Die standardmäßige clientseitige Schätzungsgrenze beträgt $0.50; überschreiben Sie diese nur innerhalb eines explizit vom Benutzer genehmigten Budgets. Erstellen Sie nicht mehr als eine kostenpflichtige Aufgabe pro Aufruf.

Behandeln Sie dies als eine Schätzungsabsicherung, nicht als eine serverseitig erzwungene Endkostenobergrenze. HiAPI kann während der Vorabbuchung der Aufgabe ein kontospezifisches Gruppenverhältnis anwenden. Bis die Aufgaben-API ein serverseitiges Maximal-Kosten-Feld unterstützt, legen Sie diese Einschränkung vor der kostenpflichtigen Generierung offen und halten Sie ausreichend Spielraum unter dem Gesamtbudget des Benutzers.

Lesen Sie HIAPI_API_KEY aus der Prozessumgebung oder --env-file. Geben Sie den Schlüssel niemals aus, geben Sie ihn zurück, speichern Sie ihn dauerhaft oder fügen Sie ihn in Vorschauen, Artefakten, Manifesten, Fehlern oder Protokollen ein. Verwenden Sie temporären Speicher in P0.

Kopieren Sie nach der Installation .env.example in eine ignorierte .env oder zeigen Sie mit --env-file auf eine vorhandene ignorierte Umgebungsdatei. Übergeben Sie niemals die befüllte Datei im Commit. Entfernen Sie sowohl eingebettete Bilddaten als auch entfernte Bild-URLs aus Vorschauen und gespeicherten Anfrageartefakten.

Lokal ausführen

Schätzen Sie eine autorisierte Talking-Head-Anfrage ohne Ausgaben:

node scripts/hiapi-product-spokesperson-video.mjs `
  --scenario talking-head `
  --image-file "D:\media\authorized-person.jpg" `
  --prompt "Feste Kamera, natürlicher Augenkontakt, zurückhaltende Bewegung" `
  --dialogue "Neues Produkt, jetzt erhältlich." `
  --consent-confirmed `
  --env-file "D:\path\to\.env.local" `
  --max-cost-usd 0.50 `
  --dry-run

Für synthetic-spokesperson lassen Sie die Bild- und Zustimmungsoptionen weg. Für Produkt- und Markenszenarien wiederholen Sie --reference-image-file oder --reference-image-url. Lokale JPEG-, PNG- und WebP-Dateien werden in Daten-URIs konvertiert und dürfen jeweils 20 MiB nicht überschreiten.

Fortsetzen ohne erneute Ausgaben

Die CLI gibt den Idempotenzschlüssel vor der Übermittlung aus und die Aufgaben-ID unmittelbar nach der Erstellung. Falls die Übermittlung unterbrochen wird, bevor eine Aufgaben-ID zurückgegeben wird, wiederholen Sie den Vorgang mit demselben --idempotency-key. Falls das Polling nach der Erstellung unterbrochen wird, führen Sie nur --task-id ID, --env-file und das gewünschte --output-dir aus. Dies setzt das Polling fort und lädt das vorhandene Ergebnis herunter, ohne die ursprüngliche Anfrage neu zu erstellen oder erneut zu übermitteln.

Bewahren Sie das Ausgabepaket auf

Schreiben Sie jeden erfolgreichen Durchlauf in outputs/, sofern kein --output-dir angegeben ist. Bewahren Sie auf:

• final.mp4;
• script.md und captions.srt;
• prompt.json mit entfernten eingebetteten Medien und Bild-URLs;
• manifest.json mit Szenario, Modell, Aufgaben-ID, Status, Schätzung, Anforderungshash, Speicher, Zeitstempel und Ablauf;
• qc.json markiert für manuelle Überprüfung von Sprache, Lippenbewegungen, Konsistenz, Kontinuität und Behauptungsgenauigkeit.

Behaupten Sie niemals Erfolg ohne eine erfolgreiche abgeschlossene Aufgabe und ein verwendbares lokales Video.

Fehlerbehandlung

• Wiederholen Sie keine HTTP 400, 401, 402 oder 403.
• Wiederholen Sie die Übermittlung bei HTTP 409, 429 oder 503 maximal dreimal mit dem ursprünglichen Idempotenzschlüssel.
• Setzen Sie Polling-Unterbrechungen mit --task-id fort; übermitteln Sie niemals automatisch einen Ersatz.
• Wiederholen Sie keine Generierung nach einem Qualitätsfehler ohne explizite Genehmigung für einen weiteren kostenpflichtigen Durchlauf.
• Melden Sie die Aufgaben-ID, den Endstatus, die Schätzung, den lokalen Ausgabepfad und die ausstehenden manuellen Qualitätskontrollprüfungen.