Use Wan Animate Replace pela Rivya Public API v1 com o ID de modelo wan-2-2-animate-replace, entradas compatíveis, parâmetros, regras da Files API, créditos e exemplos de resposta.

Disponível via APIEntrada de URL prontaVídeo

ID do modelo da API

wan-2-2-animate-replace

Entradas

url

Files API

Não obrigatório para a requisição mínima

Créditos base

Capacidade

Vídeo

Cobrança

FIXED

Limite de prompt

Sem limite de prompt documentado

Contrato da requisição

Envie o ID do modelo no nível superior. Controles específicos do modelo ficam em params.

Chave	Tipo	Obrigatório	Padrão	Descrição
model	string	Sim	wan-2-2-animate-replace	Use wan-2-2-animate-replace como ID do modelo da API.
prompt	string	Não	-	Texto de prompt para modelos que aceitam entrada de texto.
params	object	Não	-	Objeto de parâmetros específico do modelo. Use as linhas abaixo para ver as chaves permitidas.
client_request_id	string	Não	-	ID opcional do cliente para rastrear requisições no seu sistema.

Parâmetros do modelo

Chave	Tipo	Obrigatório	Padrão	Intervalo	Opções	Descrição
video_url	text	Não	-	-	-	Cole uma URL pública de vídeo que o serviço de geração consiga buscar diretamente. Este modelo espera um asset hospedado, como MP4, MOV ou MKV, não um caminho de upload local.
image_url	text	Não	-	-	-	Cole uma URL pública da imagem de substituição. JPEG, PNG ou WebP funcionam melhor; quando a proporção difere, o serviço upstream irá redimensionar e recortar ao centro.
resolution	select	Não	480p	-	480p, 580p, 720p	As faixas atuais são `480p`, `580p` e `720p`. Faixas de saída mais altas geralmente significam maior custo em créditos e esperas mais longas.

Requisição mínima

{
  "model": "wan-2-2-animate-replace",
  "params": {
    "video_url": "https://example.com/input.mp4",
    "image_url": "https://example.com/reference.png",
    "resolution": "480p"
  }
}

Resposta de criação

O endpoint de criação retorna um ID público de tarefa. Consulte o endpoint de status até a tarefa ser concluída ou falhar.

{
  "id": "task_wan_2_2_animate_replace_example",
  "status": "queued",
  "model": "wan-2-2-animate-replace",
  "reserved_credits": 20,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Erros comuns

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Este modelo aceita entrada de URL pública por meio dos parâmetros do modelo.

Integração da API de Wan Animate Replace

Contrato da requisição

Parâmetros do modelo

Requisição mínima

Resposta de criação

Erros comuns

Docs de API relacionados