HiAPI Food Commercial Video
Crie uma curta e apetitosa cena comercial. Mantenha o produto fiel, a física plausível e o limite da tarefa paga explícito.
Roteie a Requisição
Escolha uma receita e uma rota de mídia:
| Receita | Melhor para |
|---|---|
product-hero | Alimentos embalados, latas, garrafas, potes, fotos de herói de e-commerce |
coffee-pour | Café, chá, leite, crema, vapor, bebidas de cafeteria |
beverage-splash | Refrigerante, suco, água com gás, shots de bebida energética |
food-macro | Textura, ponto de cozimento, regagem, puxada de queijo, detalhes empratados |
restaurant-atmosphere | Um prato chegando em um salão de jantar ou ambiente de balcão |
| Entrada de mídia | Rota | Modelo |
|---|---|---|
| Nenhuma imagem | Texto para vídeo | kling-3.0-omni/text-to-video |
Exatamente uma --hero-image-* | Imagem de herói para vídeo | kling-3.0-omni/image-to-video |
1-9 --reference-image-* | Geração com múltiplas referências | seedance-2.0-fast |
Não misture imagens de herói e de referência. Prefira uma imagem de herói ou de referência sempre que a geometria da embalagem, a colocação do rótulo, a cor da marca ou um prato específico precisarem permanecer reconhecíveis.
Não lide com uma pessoa falando, provando ou apresentando, nem com orientações de ação e câmera vindas de um vídeo existente. Roteie essas requisições para uma skill dedicada de porta-voz ou transferência de movimento; se nenhuma estiver disponível, explique que esta skill não suporta o fluxo de trabalho.
Construa o Briefing
Confirme o produto ou prato, uma ação principal, um movimento de câmera, proporção de saída, duração e quaisquer alegações que devem ser evitadas. Se o usuário omitiu a duração, roteie a requisição primeiro, ofereça um menu curto e personalizado e aguarde uma escolha ou aceitação explícita do padrão de baixo custo de 4 segundos antes de --dry-run.
Aceite cada segundo inteiro dentro da faixa do modelo selecionado: Kling text-to-video e hero image-to-video suportam 3-15 segundos; Seedance Fast com imagem de referência suporta 4-15 segundos. Use essas faixas de planejamento sem transformá-las em predefinições rígidas:
| Duração | Melhor ajuste |
|---|---|
| 3-4 segundos | Gancho imediato, splash ou revelação do pacote; 3 segundos é exclusivo Kling |
| 5-6 segundos | Tomada de herói rápida para redes sociais ou e-commerce com uma breve exibição do produto |
| 7-9 segundos | Derramamento completo, regagem, textura ou revelação com tempo de assentamento legível |
| 10-12 segundos | Revelação lenta premium ou atmosfera de restaurante com ritmo contido |
| 13-15 segundos | Longa tomada deliberada apenas quando o movimento permanece significativo; maior custo e risco de continuidade |
Duração maior não permite cortes extras ou batidas não relacionadas: mantenha uma ação, um movimento de câmera e uma tomada contínua. A receita fornece padrões concisos; sobrescreva-os com --action, --setting, --lighting, --texture, --camera ou --sound quando o briefing exigir.
Leia references/prompting.md para obter os padrões da receita e restrições de veracidade específicas para alimentos.
Proteja Gastos e Segredos
Visualize offline o payload completo editado primeiro:
node scripts/hiapi-food-commercial-video.mjs `
--recipe coffee-pour `
--prompt "Uma xícara de cerâmica de café torrado escuro para uma cafeteria premium" `
--duration 4 `
--ratio 9:16 `
--preview
Execute verificações reais apenas depois de informar ao usuário que ele contata a HiAPI, mas não cria tarefa paga:
node scripts/hiapi-food-commercial-video.mjs --check --env-file "D:\path\to\.env.local"
Em seguida, precifique a requisição pretendida a partir do catálogo público ativo:
node scripts/hiapi-food-commercial-video.mjs `
--recipe product-hero `
--hero-image-file "D:\media\product.jpg" `
--prompt "A lata de água com gás fornecida em um balcão frio limpo" `
--duration 4 `
--dry-run
Use --spend --approved-request-hash HASH apenas depois que o usuário aprovar explicitamente a estimativa ao vivo, o orçamento e o hash impressos pelo --dry-run correspondente. O limite padrão de estimativa do cliente é $0.50; sobrescreva --max-cost-usd apenas dentro de um orçamento aprovado. Isso não é um limite de cobrança final imposto pelo servidor porque as taxas do grupo de conta podem ser aplicadas. Crie no máximo uma tarefa paga por invocação.
Leia HIAPI_API_KEY do ambiente do processo ou --env-file. Nunca imprima, persista ou inclua em artefatos. Mantenha o host fixo da API e o armazenamento temporário de saída.
Retome com Segurança
A CLI vincula sua chave de idempotência ao hash da requisição aprovada, imprime-o antes do envio e imprime o ID da tarefa imediatamente após a criação. Reutilize exatamente essa --idempotency-key se o envio for interrompido antes que um ID de tarefa seja retornado. Se uma resposta de chave duplicada já contiver um ID de tarefa, não anexe o briefing atual; retome a tarefa existente separadamente. Depois que um ID de tarefa existir, retome apenas com:
node scripts/hiapi-food-commercial-video.mjs --task-id TASK_ID --env-file "D:\path\to\.env.local"
Nunca envie uma substituição automaticamente após falhas de sondagem ou revisão de qualidade.
Revise o Pacote
Preserve final.mp4, brief.md, prompt.json editado, manifest.json e qc.json específico para alimentos. Trate generated_unreviewed como o status automatizado final. Exija revisão humana antes de publicar ou fazer alegações sobre produto, ingrediente, alérgeno, álcool, nutrição, certificação ou saúde.
Leia references/output.md para semântica de artefatos e a lista de verificação de QC. Leia references/api.md ao alterar rotas, lógica de precificação, tentativas ou manipulação de tarefas.