Vidéo Publicitaire Alimentaire HiAPI
Créez un court plan publicitaire appétissant en une seule prise. Gardez le produit authentique, la physique plausible et la délimitation de la tâche payante explicite.
Aiguiller la Demande
Choisissez une recette et une route média :
| Recette | Idéal pour |
|---|---|
product-hero | Produits emballés, canettes, bouteilles, bocaux, plans héroïques e-commerce |
coffee-pour | Café, thé, lait, crème, vapeur, boissons de café |
beverage-splash | Soda, jus, eau pétillante, boissons énergisantes |
food-macro | Texture, cuisson, filet, filage de fromage, détails en assiette |
restaurant-atmosphere | Un plat arrivant dans une salle à manger ou un comptoir de service |
| Entrée média | Route | Modèle |
|---|---|---|
| Aucune image | Texte-vers-vidéo | kling-3.0-omni/text-to-video |
Exactement une --hero-image-* | Image héroïque vers vidéo | kling-3.0-omni/image-to-video |
1-9 --reference-image-* | Génération multi-référence | seedance-2.0-fast |
Ne mélangez pas les images héroïques et les images de référence. Privilégiez une image héroïque ou de référence dès que la géométrie de l'emballage, le placement de l'étiquette, la couleur de la marque ou un plat spécifique doit rester reconnaissable.
Ne gérez pas une personne qui parle, goûte ou présente, ni les indications d'action et de caméra provenant d'une vidéo existante. Aiguillez ces demandes vers une compétence dédiée installée de porte-parole ou de transfert de mouvement ; si aucune n'est disponible, expliquez que cette compétence ne prend pas en charge ce flux de travail.
Construire le Brief
Confirmez le produit ou le plat, une action principale, un mouvement de caméra, le ratio de sortie, la durée, et toute réclamation qui doit être évitée. Si l'utilisateur a omis la durée, aiguillez d'abord la demande, proposez un court menu adapté, et attendez un choix ou une acceptation explicite de la durée par défaut de 4 secondes à faible coût avant --dry-run.
Acceptez chaque seconde entière dans la plage du modèle sélectionné : Kling texte-vers-vidéo et image héroïque-vers-vidéo prennent en charge 3 à 15 secondes ; Seedance Fast génération d'image de référence prend en charge 4 à 15 secondes. Utilisez ces bandes de planification sans les transformer en préréglages fixes :
| Durée | Meilleur ajustement |
|---|---|
| 3-4 secondes | Accroche immédiate, éclaboussure ou dévoilement du pack ; 3 secondes est réservé à Kling |
| 5-6 secondes | Plan héroïque rapide pour réseau social ou e-commerce avec une courte mise en valeur du produit |
| 7-9 secondes | Versement complet, filet, texture ou dévoilement avec un temps de stabilisation lisible |
| 10-12 secondes | Dévoilement lent premium ou ambiance de restaurant avec rythme retenu |
| 13-15 secondes | Longue prise délibérée uniquement lorsque le mouvement reste significatif ; coût et risque de continuité les plus élevés |
Une durée plus longue ne permet pas de coupes supplémentaires ou de séquences sans rapport : gardez une action, un mouvement de caméra et une prise continue. La recette fournit des valeurs par défaut concises ; remplacez-les par --action, --setting, --lighting, --texture, --camera ou --sound lorsque le brief l'exige.
Consultez references/prompting.md pour les valeurs par défaut des recettes et les contraintes de vérité spécifiques à l'alimentaire.
Protéger les Dépenses et les Secrets
Prévisualisez d'abord la charge utile complète expurgée hors ligne :
node scripts/hiapi-food-commercial-video.mjs `
--recipe coffee-pour `
--prompt "Une tasse en céramique de café torréfié foncé pour un café haut de gamme" `
--duration 4 `
--ratio 9:16 `
--preview
Effectuez de véritables vérifications uniquement après avoir informé l'utilisateur qu'il contacte HiAPI mais ne crée aucune tâche payante :
node scripts/hiapi-food-commercial-video.mjs --check --env-file "D:\chemin\vers\.env.local"
Ensuite, estimez le prix de la demande prévue à partir du catalogue public en direct :
node scripts/hiapi-food-commercial-video.mjs `
--recipe product-hero `
--hero-image-file "D:\media\product.jpg" `
--prompt "La canette d'eau pétillante fournie sur un comptoir froid et propre" `
--duration 4 `
--dry-run
Utilisez --spend --approved-request-hash HASH seulement après que l'utilisateur a explicitement approuvé l'estimation en direct, le budget et le hash imprimés par le --dry-run correspondant. La limite d'estimation client par défaut est de 0,50 $ ; remplacez --max-cost-usd uniquement dans le cadre d'un budget approuvé. Il ne s'agit pas d'un plafond de facturation finale appliqué par le serveur car des ratios de groupe de compte peuvent s'appliquer. Créez au maximum une tâche payante par invocation.
Lisez HIAPI_API_KEY depuis l'environnement du processus ou --env-file. Ne l'imprimez, ne la conservez jamais et ne l'incluez jamais dans les artefacts. Conservez l'hôte API fixe et le stockage de sortie temporaire.
Reprendre en Toute Sécurité
Le CLI lie sa clé d'idempotence au hash de la requête approuvée, l'imprime avant la soumission, et imprime l'ID de la tâche immédiatement après sa création. Réutilisez exactement cette --idempotency-key si la soumission est interrompue avant qu'un ID de tâche ne soit renvoyé. Si une réponse de clé en double contient déjà un ID de tâche, n'attachez pas le brief actuel ; reprenez la tâche existante séparément. Après l'existence d'un ID de tâche, reprenez uniquement avec :
node scripts/hiapi-food-commercial-video.mjs --task-id TASK_ID --env-file "D:\chemin\vers\.env.local"
Ne soumettez jamais automatiquement un remplacement après des échecs d'interrogation ou de révision de qualité.
Examiner le Package
Conservez final.mp4, brief.md, prompt.json expurgé, manifest.json, et qc.json spécifique à l'alimentaire. Traitez generated_unreviewed comme le statut automatisé final. Exigez une révision humaine avant la publication ou toute réclamation concernant le produit, l'ingrédient, l'allergène, l'alcool, la nutrition, la certification ou la santé.
Consultez references/output.md pour la sémantique des artefacts et la liste de contrôle QC. Consultez references/api.md lors du changement de routes, de la logique de tarification, des tentatives ou de la gestion des tâches.