hiapi-product-spokesperson-video

Vidéo de Porte-Parole Produit HiAPI

Créez des vidéos produit de 3 à 15 secondes, en plan unique, avec la CLI locale. Estimez toujours avec --dry-run avant une requête payante. Créez une tâche payante uniquement lorsque l'utilisateur approuve explicitement la génération et que la commande inclut --spend.

Router le Scénario

Choisissez un seul scénario :

Scénario	Modèle	Entrée requise	P0 par défaut
synthetic-spokesperson	kling-3.0-omni/text-to-video	Prompt et dialogue optionnel	3s, 720p, 9:16, audio
talking-head	kling-3.0-omni/image-to-video	Une image de personne autorisée, prompt, dialogue, consentement	3s, 720p, audio
product-intro	seedance-2.0-fast	Prompt et 1 à 9 images produit	4s, 480p, 9:16, audio
brand-promo	seedance-2.0-fast	Prompt et 1 à 9 images de marque ou produit	4s, 480p, 9:16, audio

Avant de construire la requête, confirmez la durée cible. Si l'utilisateur ne l'a pas spécifiée, demandez combien de secondes la vidéo doit durer et indiquez la plage prise en charge : Kling 3 à 15 secondes ; Seedance 4 à 15 secondes. Proposez la valeur par défaut P0 du tableau, mais ne passez pas à --dry-run tant que l'utilisateur n'a pas choisi une durée ou accepté explicitement la valeur par défaut.

Refusez la génération talking-head sauf si l'utilisateur confirme l'autorisation et que la commande inclut --consent-confirmed. N'inventez pas d'allégations produit, d'approbations, de prix, de certifications ou de faits de marque.

Protéger les Dépenses et les Secrets

Exécutez d'abord les vérifications sans frais :

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

Exécutez ensuite la requête prévue avec --dry-run. Confirmez que l'estimation de prix public est dans la limite de l'utilisateur avant de remplacer --dry-run par --spend. La limite d'estimation côté client par défaut est de 0,50 $ ; ne la remplacez que dans le cadre d'un budget explicite approuvé par l'utilisateur. Ne créez pas plus d'une tâche payante par invocation.

Considérez ceci comme une garde d'estimation, et non comme un plafond de frais final appliqué par le serveur. HiAPI peut appliquer un ratio de groupe spécifique au compte lors de la précharge de la tâche. Jusqu'à ce que l'API de tâche prenne en charge un champ de coût maximum côté serveur, divulguez cette limitation avant la génération payante et maintenez une marge suffisante en dessous du budget total de l'utilisateur.

Lisez HIAPI_API_KEY depuis l'environnement du processus ou --env-file. N'imprimez, ne renvoyez, ne persistez et n'incluez jamais la clé dans les aperçus, artefacts, manifestes, erreurs ou journaux. Utilisez un stockage temporaire en P0.

Après l'installation, copiez .env.example vers un fichier .env ignoré, ou pointez --env-file vers un fichier d'environnement existant ignoré. Ne commitez jamais le fichier rempli. Masquez à la fois les données d'image intégrées et les URL d'images distantes des aperçus et des artefacts de requête enregistrés.

Exécuter Localement

Estimez une requête de tête parlante autorisée sans dépenser :

node scripts/hiapi-product-spokesperson-video.mjs `
  --scenario talking-head `
  --image-file "D:\media\personne-autorisee.jpg" `
  --prompt "Caméra fixe, contact visuel naturel, mouvement retenu" `
  --dialogue "Nouveau produit, maintenant disponible." `
  --consent-confirmed `
  --env-file "D:\chemin\vers\.env.local" `
  --max-cost-usd 0.50 `
  --dry-run

Pour synthetic-spokesperson, omettez l'image et les options de consentement. Pour les scénarios produit et marque, répétez --reference-image-file ou --reference-image-url. Les fichiers JPEG, PNG et WebP locaux sont convertis en data URIs et ne doivent pas dépasser 20 Mio chacun.

Reprendre Sans Dépenser à Nouveau

La CLI imprime la clé d'idempotence avant soumission et l'ID de tâche immédiatement après création. Si la soumission est interrompue avant qu'un ID de tâche ne soit renvoyé, réessayez avec la même --idempotency-key. Si l'interrogation est interrompue après la création, exécutez uniquement --task-id ID, --env-file et le --output-dir souhaité. Cela reprend l'interrogation et télécharge le résultat existant sans reconstruire ni soumettre à nouveau la requête d'origine.

Préserver le Package de Sortie

Écrivez chaque exécution réussie sous outputs/ sauf si --output-dir est fourni. Préservez :

• final.mp4 ;
• script.md et captions.srt ;
• prompt.json avec les médias intégrés et les URL d'images distantes masquées ;
• manifest.json avec scénario, modèle, ID de tâche, statut, estimation, hachage de requête, stockage, horodatage et expiration ;
• qc.json marqué pour révision humaine de la parole, synchronisation labiale, cohérence, continuité et exactitude des allégations.

Ne déclarez jamais de succès sans une tâche réussie en terminal et une vidéo locale utilisable.

Gérer les Échecs

• Ne réessayez pas les codes HTTP 400, 401, 402 ou 403.
• Réessayez la soumission des codes HTTP 409, 429 ou 503 au maximum trois fois avec la clé d'idempotence d'origine.
• Reprenez les interruptions d'interrogation avec --task-id ; ne soumettez jamais un remplacement automatiquement.
• Ne régénérez pas après un échec de qualité sans approbation explicite d'une autre exécution payante.
• Signalez l'ID de tâche, le statut terminal, l'estimation, le chemin de sortie local et les vérifications QC humaines en attente.