HiAPI Fashion Lookbook Video
Crea un video corto de moda de una sola toma. Asegúrate de que la persona esté autorizada, la prenda sea reconocible, los roles de referencia sean explícitos y la generación de pago sea aprobada por separado.
Enrutar la Solicitud
Elige una receta:
| Receta | Mejor para |
|---|---|
runway-walk | Una caminata de cuerpo completo que termina en una pose controlada |
outfit-transition | Exactamente una transformación de atuendo inicial a objetivo |
lookbook-pose | Un giro lento o pose que muestra un look completo |
person-showcase | Un retrato de moda sin palabras con movimiento contenido |
Elige la ruta de medios según los activos proporcionados:
| Entrada de medios | Ruta | Modelo |
|---|---|---|
| Sin imagen | Texto a video | kling-3.0-omni/text-to-video |
| Exactamente una imagen de persona o look completo, sin otra imagen | Imagen a video | kling-3.0-omni/image-to-video |
| Cualquier referencia de prenda o estilo, hasta 9 imágenes en total | Generación multirreferencia | seedance-2.0-fast |
Usa como máximo una imagen de persona, seis imágenes de prenda para un look objetivo y dos imágenes de estilo. El límite combinado es de nueve. La outfit-transition basada en referencias requiere una imagen de persona y al menos una imagen de prenda. La outfit-transition solo con texto es ficticia y no puede prometer una prenda o identidad específica.
Delega un presentador con palabras a $hiapi-product-spokesperson-video. Delega la guía de acción o cámara a partir de un video a $hiapi-reference-motion-transfer. Delega el ensamblaje de múltiples tomas, subtítulos, música, logotipos o composición de CTA a un flujo de trabajo de edición de video.
Confirmar Derechos y Alcance
Antes de usar cualquier imagen, confirma que el usuario es propietario o está autorizado a usarla. Exige --asset-rights-confirmed para cada solicitud de medios y, adicionalmente, exige --person-consent-confirmed cuando se proporcione una imagen de persona. No infieras consentimiento, propiedad ni una licencia comercial limpia a partir de la imagen misma.
Describe el resultado generado como visualización de moda creativa. No lo describas como evidencia de ajuste exacto, talla, sastrería, rendimiento de la tela o cómo se verá una prenda en un comprador. No hagas afirmaciones sobre forma corporal, edad, etnia, médicas o de atractivo.
Confirma la receta, una acción principal, un movimiento de cámara, duración, relación de aspecto, detalles de la prenda objetivo y si se necesita audio. El audio generado está desactivado por defecto. Lee references/prompting.md para conocer los valores predeterminados de la receta, roles de referencia, tiempos y restricciones de veracidad en la moda.
Previsualizar Antes de Gastar
Previsualiza la carga útil completa redactada localmente:
node scripts/hiapi-fashion-lookbook-video.mjs `
--recipe lookbook-pose `
--prompt "Un modelo adulto presenta un look estructurado de noche en negro" `
--duration 5 `
--ratio 9:16 `
--preview
Para una persona autorizada y una prenda objetivo:
node scripts/hiapi-fashion-lookbook-video.mjs `
--recipe outfit-transition `
--person-image-file "D:\media\person.jpg" `
--garment-image-file "D:\media\dress-front.jpg" `
--garment-image-file "D:\media\dress-back.jpg" `
--person-consent-confirmed `
--asset-rights-confirmed `
--prompt "Un cambio limpio hacia el vestido de noche proporcionado" `
--garment-details "Conservar el escote cuadrado, la cintura ajustada, el dobladillo al tobillo y los botones plateados" `
--duration 5 `
--ratio 9:16 `
--preview
Ejecuta verificaciones en vivo solo después de informar al usuario de que se contacta a HiAPI pero no se crea ninguna tarea de pago:
node scripts/hiapi-fashion-lookbook-video.mjs --check --env-file "D:\path\to\.env.local"
Luego, calcula el precio de la solicitud exacta con --dry-run. Esto lee el catálogo público en vivo y no crea ninguna tarea. El límite de estimación local predeterminado es $1.00; anula --max-cost-usd solo dentro de un presupuesto aprobado. El precio público no es un límite de cargo final del lado del servidor porque pueden aplicar proporciones de grupo de cuenta.
Usa --spend --approved-request-hash HASH solo después de que el usuario apruebe explícitamente la estimación en vivo coincidente, el presupuesto y el hash de la solicitud. Una invocación crea como máximo una tarea de pago. Lee la clave de API de HIAPI_API_KEY o --env-file; nunca la imprimas ni la persistas.
Reanudar de Manera Segura
La CLI vincula su clave de idempotencia al hash de solicitud aprobado e imprime el ID de la tarea inmediatamente después de su creación. Reutiliza la clave --idempotency-key impresa exacta solo si el envío fue interrumpido antes de que se devolviera un ID de tarea. Después de que exista un ID de tarea, reanuda sin reenviar:
node scripts/hiapi-fashion-lookbook-video.mjs --task-id TASK_ID --env-file "D:\path\to\.env.local"
Nunca crees automáticamente una tarea de reemplazo después de un fallo en el sondeo, la descarga o la revisión de calidad.
Revisar el Paquete
Conserva final.mp4, brief.md, prompt.json redactado, manifest.json y qc.json. Trata generated_unreviewed como el estado automático final. Exige revisión humana antes de la publicación, uso en ecommerce, publicidad pagada o hacer afirmaciones sobre prendas, identidad, ajuste, talla, material, origen, certificación o rendimiento.
Lee references/output.md para conocer la semántica de los artefactos y la lista de verificación de control de calidad de moda. Lee references/api.md antes de cambiar modelos, rutas, precios, reintentos o manejo de tareas.