HiAPI Fashion Lookbook Video
Crie um único take de moda curto. Mantenha a pessoa autorizada, a peça de roupa reconhecível, os papéis das referências explícitos e a geração paga aprovada separadamente.
Roteie a Requisição
Escolha uma receita:
| Receita | Melhor para |
|---|---|
runway-walk | Uma caminhada de corpo inteiro terminando em uma pose controlada |
outfit-transition | Exatamente uma transformação de roupa inicial para alvo |
lookbook-pose | Uma virada lenta ou pose que mostra um look completo |
person-showcase | Um retrato de moda sem fala com movimento contido |
Escolha a rota de mídia com base nos ativos fornecidos:
| Entrada de mídia | Rota | Modelo |
|---|---|---|
| Nenhuma imagem | Texto-para-vídeo | kling-3.0-omni/text-to-video |
| Exatamente uma imagem de pessoa ou look completo, nenhuma outra imagem | Imagem-para-vídeo | kling-3.0-omni/image-to-video |
| Qualquer referência de peça de roupa ou estilo, até 9 imagens no total | Geração com múltiplas referências | seedance-2.0-fast |
Use no máximo uma imagem de pessoa, seis imagens de peça de roupa para um look alvo e duas imagens de estilo. O limite combinado é de nove. A transição de look guiada por referência requer uma imagem de pessoa e pelo menos uma imagem de peça de roupa. A transição de look apenas com texto é fictícia e não pode prometer uma peça de roupa ou identidade específica.
Delegue um apresentador falante para $hiapi-product-spokesperson-video. Delegue orientação de ação ou câmera a partir de um vídeo para $hiapi-reference-motion-transfer. Delegue montagem de múltiplos planos, legendas, música, logotipos ou composição de CTA para um fluxo de trabalho de edição de vídeo.
Confirme Direitos e Escopo
Antes de usar qualquer imagem, confirme que o usuário a possui ou está autorizado a usá-la. Exija --asset-rights-confirmed para cada requisição de mídia e adicionalmente exija --person-consent-confirmed quando uma imagem de pessoa for fornecida. Não infira consentimento, propriedade ou uma licença comercial limpa a partir da própria imagem.
Descreva a saída gerada como visualização criativa de moda. Não a descreva como evidência de ajuste exato, tamanho, alfaiataria, desempenho do tecido ou como uma peça de roupa ficará em um comprador. Não faça afirmações sobre tipo de corpo, idade, etnia, questões médicas ou atratividade.
Confirme a receita, uma ação principal, um movimento de câmera, duração, proporção de saída, detalhes da peça alvo e se áudio é necessário. O áudio gerado fica desligado por padrão. Leia references/prompting.md para valores padrão de receita, papéis de referência, temporização e restrições de verdade na moda.
Pré-visualize Antes de Gastar
Visualize offline o payload completo editado:
node scripts/hiapi-fashion-lookbook-video.mjs `
--recipe lookbook-pose `
--prompt "Um modelo adulto apresenta um look estruturado preto de noite" `
--duration 5 `
--ratio 9:16 `
--preview
Para uma pessoa autorizada e peça alvo:
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 "Uma mudança limpa para o vestido de noite fornecido" `
--garment-details "Preserve o decote quadrado, cintura ajustada, bainha no tornozelo e botões prateados" `
--duration 5 `
--ratio 9:16 `
--preview
Execute verificações ao vivo somente após informar o usuário de que ele contata a HiAPI, mas não cria nenhuma tarefa paga:
node scripts/hiapi-fashion-lookbook-video.mjs --check --env-file "D:\path\to\.env.local"
Em seguida, precifique a requisição exata com --dry-run. Ele lê o catálogo público ao vivo e não cria nenhuma tarefa. O limite de estimativa local padrão é $1.00; sobrescreva --max-cost-usd somente dentro de um orçamento aprovado. O preço público não é um limite de cobrança final no lado do servidor, pois as proporções do grupo de contas podem ser aplicadas.
Use --spend --approved-request-hash HASH somente após o usuário aprovar explicitamente a estimativa ao vivo correspondente, o orçamento e o hash da requisição. Uma invocação cria no máximo uma tarefa paga. Leia a chave da API de HIAPI_API_KEY ou --env-file; nunca imprima ou persista a chave.
Retome com Segurança
O CLI vincula sua chave de idempotência ao hash de requisição aprovado e imprime o ID da tarefa imediatamente após a criação. Reutilize exatamente a --idempotency-key impressa apenas se o envio foi interrompido antes que um ID de tarefa fosse retornado. Após a existência de um ID de tarefa, retome sem reenviar:
node scripts/hiapi-fashion-lookbook-video.mjs --task-id TASK_ID --env-file "D:\path\to\.env.local"
Nunca crie automaticamente uma tarefa substituta após falha de polling, download ou revisão de qualidade.
Revise o Pacote
Preserve final.mp4, brief.md, prompt.json editado, manifest.json e qc.json. Trate generated_unreviewed como o status automatizado final. Exija revisão humana antes de publicação, uso em e-commerce, publicidade paga ou fazer afirmações sobre peça de roupa, identidade, ajuste, tamanho, material, origem, certificação ou desempenho.
Leia references/output.md para semântica de artefatos e a lista de verificação de QC de moda. Leia references/api.md antes de alterar modelos, rotas, preços, tentativas ou manipulação de tarefas.