Visão geral/OpenAPI/Edit e continue

Edit e continue

Renova uma criação existente ou continue a sua última tarefa descansada.

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.