¿Qué hace HiAPI Video Comercial de Alimentos y Bebidas?
Cree un plano corto y apetitoso de anuncio comercial. Mantenga el producto veraz, la física plausible y el límite de tareas pagadas explícito.
Enrutar la Solicitud
Elija una receta y una ruta de medios:
| Receta | Mejor para |
|---|---|
product-hero | Alimentos envasados, latas, botellas, frascos, tomas hero de ecommerce |
coffee-pour | Café, té, leche, crema, vapor, bebidas de cafetería |
beverage-splash | Refrescos, jugos, agua con gas, tomas de bebidas energéticas |
food-macro | Textura, punto de cocción, baño de salsa, estiramiento de queso, detalles en plato |
restaurant-atmosphere | Un plato que llega a un comedor o entorno de servicio de mostrador |
| Entrada de medios | Ruta | Modelo |
|---|---|---|
| Sin imagen | Texto a video | kling-3.0-omni/text-to-video |
Exactamente una --hero-image-* | Hero imagen a video | kling-3.0-omni/image-to-video |
1-9 --reference-image-* | Generación multireferencia | seedance-2.0-fast |
No mezcle imágenes hero y de referencia. Prefiera una imagen hero o de referencia siempre que la geometría del empaque, la ubicación de la etiqueta, el color de la marca o un plato específico deban permanecer reconocibles.
No maneje a una persona hablando, probando o presentando, ni guía de acción y cámara desde un video existente. Enrute esas solicitudes a una skill dedicada de presentador o transferencia de movimiento instalada; si no hay ninguna disponible, explique que esta skill no admite ese flujo de trabajo.
Construir el Brief
Confirme el producto o plato, una acción principal, un movimiento de cámara, la relación de aspecto de salida, la duración y cualquier afirmación que deba evitarse. Si el usuario omitió la duración, enrute la solicitud primero, ofrezca un menú corto personalizado y espere una elección o aceptación explícita del valor predeterminado de bajo costo de 4 segundos antes de --dry-run.
Acepte cada segundo completo en el rango del modelo seleccionado: Kling texto a video y hero imagen a video admiten 3-15 segundos; Seedance Fast generación con imágenes de referencia admite 4-15 segundos. Use estas bandas de planificación sin convertirlas en valores predeterminados rígidos:
| Duración | Mejor ajuste |
|---|---|
| 3-4 segundos | Gancho inmediato, salpicadura o revelación de empaque; 3 segundos solo para Kling |
| 5-6 segundos | Toma hero rápida para redes sociales o ecommerce con una breve pausa en el producto |
| 7-9 segundos | Vertido completo, baño de salsa, textura o revelación con tiempo de asentamiento legible |
| 10-12 segundos | Revelación lenta premium o ambiente de restaurante con ritmo contenido |
| 13-15 segundos | Toma larga deliberada solo cuando el movimiento sigue siendo significativo; mayor costo y riesgo de continuidad |
Una duración más larga no permite cortes adicionales o beats no relacionados: mantenga una acción, un movimiento de cámara y un plano continuo. La receta proporciona valores predeterminados concisos; anúlelos con --action, --setting, --lighting, --texture, --camera o --sound cuando el brief lo requiera.
Lea references/prompting.md para valores predeterminados de recetas y restricciones de veracidad específicas de alimentos.
Proteger Gastos y Secretos
Previsualice la carga útil completa censurada sin conexión primero:
node scripts/hiapi-food-commercial-video.mjs `
--recipe coffee-pour `
--prompt "Una taza de cerámica de café de tueste oscuro para una cafetería premium" `
--duration 4 `
--ratio 9:16 `
--preview
Ejecute comprobaciones reales solo después de informar al usuario que se contacta a HiAPI pero no se crea ninguna tarea paga:
node scripts/hiapi-food-commercial-video.mjs --check --env-file "D:\ruta\a\.env.local"
Luego presupueste la solicitud prevista desde el catálogo público en vivo:
node scripts/hiapi-food-commercial-video.mjs `
--recipe product-hero `
--hero-image-file "D:\media\producto.jpg" `
--prompt "La lata de agua con gas proporcionada sobre una encimera fría y limpia" `
--duration 4 `
--dry-run
Use --spend --approved-request-hash HASH solo después de que el usuario apruebe explícitamente la estimación en vivo, el presupuesto y el hash impresos por el --dry-run correspondiente. El límite de estimación del cliente predeterminado es $0.50; anule --max-cost-usd solo dentro de un presupuesto aprobado. Esto no es un tope de cargo final impuesto por el servidor, ya que pueden aplicarse ratios de grupo de cuenta. Cree como máximo una tarea paga por invocación.
Lea HIAPI_API_KEY del entorno del proceso o de --env-file. Nunca imprima, persista ni la incluya en artefactos. Mantenga el host fijo de la API y el almacenamiento temporal de salida.
Reanudar de Forma Segura
La CLI vincula su clave de idempotencia al hash de solicitud aprobado, lo imprime antes del envío e imprime el ID de la tarea inmediatamente después de la creación. Reutilice esa --idempotency-key exacta si el envío se interrumpe antes de que se devuelva un ID de tarea. Si una respuesta de clave duplicada ya contiene un ID de tarea, no adjunte el brief actual; reanude la tarea existente por separado. Después de que exista un ID de tarea, reanude solo con:
node scripts/hiapi-food-commercial-video.mjs --task-id ID_TAREA --env-file "D:\ruta\a\.env.local"
Nunca envíe un reemplazo automáticamente después de fallos en la encuesta o revisión de calidad.
Revisar el Paquete
Conserve final.mp4, brief.md, prompt.json censurado, manifest.json y qc.json específico de alimentos. Trate generated_unreviewed como el estado automatizado final. Requiera revisión humana antes de publicar o hacer afirmaciones sobre producto, ingrediente, alérgenos, alcohol, nutrición, certificación o salud.
Lea references/output.md para la semántica de los artefactos y la lista de verificación de control de calidad. Lea references/api.md al cambiar rutas, lógica de precios, reintentos o manejo de tareas.