Edit Conteúdo existente
Explicador Vídeo aceita mensagens de seguimento em língua natural:
POST /creations/{id}/messages
O exemplo:
{ "content": "Keep everything else and make the second scene easier for new employees", "input_file_ids": [], "idempotency_key": "video-edit-20260901-001"}
Uma mensagem pode descrever uma mudança de vídeo inteiro ou nomear uma cena selecionada. A KPainter planeja o alcance afetado e continua a produzir quando a conta e o orçamento permitem.
A AI Image e a AI App não anunciam atualmente o mesmo fluxo de trabalho de edição de conversação. Crie um novo resultado quando as capacidades não expõem um caminho de refinamento suportado.
Continue uma tarefa descansada
Quando GET /creations/{id} retorna parado, verifique as ações disponíveis primeiro. Solicite apenas uma ação presente nessa lista:
POST /creations/{id}/actions
{ "action": "resume_after_recharge", "idempotency_key": "resume-20260901-001"}
As possíveis ações incluem:
- resume_after_recharge depois que o equilíbrio é suficiente
- aprove_overage após o usuário aceitar uma estimativa revisada
- Retirar-se somente quando KPainter explicitamente marca uma retração como segura
Impotência e Segurança
- Reutilizar a mesma ID-Potency_key para a mesma mensagem ou ação após uma interrupção de transporte.
- Não mantenha o botão de recuperação de uma tarefa velha ativo depois de uma tarefa mais nova começar.
- Continue apenas a última tarefa interrompida; o serviço valida isso novamente.
- Não invente uma ação quando as ações disponíveis estão vazias.
- Verifique o status antes de retirar uma solicitação remota incerta.
- Envie apenas o ID de criação documentado, a ação e a chave de identidade.
As mensagens e ações são asynchrônicas. Depois de uma resposta 202, continue a pesquisar GET /creations/{id}; refresque as saídas apenas após uma entrega usável estiver disponível.
