Ir para o conteúdo

PixVerse Swap

Integrar

ID do modelo pixverse/swap
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/pixverse/swap?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Arquivos como o exemplo: $ 0,40 400 créditos de API seus arquivos são medidos antes da execução Executar nesta página

Obter chave de API
PixVerse Imagem para vídeo até 720p

Ferramenta de substituição em vídeo que troca uma pessoa, um objeto ou o fundo usando uma imagem-alvo

PixVerse · Vídeo

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

•obrigatório video_url
Solte um arquivo ou

URL externa do vídeo para a operação de substituição.

•obrigatório image_url
Solte um arquivo ou

URL da imagem de destino para a operação de substituição.

resolution padrão 720p

Resolução da saída; 1080p não está disponível.

Avançado mode · keyframe_id · seed · original_sound_switch · enable_safety_checker
mode padrão person

Modo usado para a operação de substituição.

padrão 1

ID do quadro de mapeamento de rosto/objeto, selecionado entre 1 e (duration_seconds * 24). Os IDs referem-se à entrada após a normalização para 24 FPS; portanto, 1 identifica o primeiro quadro e 24 identifica o quadro 1 segundo após o início do vídeo.

Seed que controla a aleatoriedade durante a geração.

POST /run/pixverse/swap?wait=20 cotação → $ 0,40
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/pixverse/swap?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar esta solicitação

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar Lembrar. Obter uma chave de API

Sobre PixVerse Swap

Recebe um vídeo de origem e uma imagem de destino, e então substitui o conteúdo da imagem conforme `mode`: person, object ou fundo. `keyframe_id` escolhe o quadro usado para o mapeamento, contado a 24 FPS. A resolução de saída é 360p, 540p ou 720p, e `original_sound_switch` mantém o áudio original.

Parâmetros

Envie o nome canônico ou o nome nativo, não ambos. Nomes canônicos

NomeTipo PadrãoPermitido Descrição
video_urlobrigatório video
Tipourl · video
URL externa do vídeo para a operação de substituição.
modeopcional
Tipoenum
Padrãoperson
personobjectbackground
Modo usado para a operação de substituição.
keyframe_idopcional
Tipointeger
Padrão1
≥ 1
ID do quadro de mapeamento de rosto/objeto, selecionado entre 1 e (duration_seconds * 24). Os IDs referem-se à entrada após a normalização para 24 FPS; portanto, 1 identifica o primeiro quadro e 24 identifica o quadro 1 segundo após o início do vídeo.
image_urlobrigatório image
Tipourl · image
URL da imagem de destino para a operação de substituição.
resolutionopcional
Tipoenum
Padrão720p
360p540p720p
Resolução da saída; 1080p não está disponível.
seedopcional
Tipointeger | null
Seed que controla a aleatoriedade durante a geração.
original_sound_switchopcional
Tipoboolean
Padrãotrue
Controla se o áudio original é mantido.
enable_safety_checkeropcional
Tipoboolean
Padrãotrue
A filtragem pode ser relaxada definindo false, desde que o chamador esteja autorizado.
obrigatório Nome canônico, também aceito

Os parâmetros de arquivo aceitam uma URL https:// pública, um URI data: de até 10 MB ou o file_url de um upload. Arquivos

Saída

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "pixverse/swap",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 400,
    "usd": "0.40",
    "charged": 400,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.
Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.
Campos da saída
video
object {url, content_type, file_name, file_size}Vídeo resultante da operação de substituição.

Mais modelos: Imagem para vídeo

Para agentes de IA: esta página em Markdown está em https://doitong.com/pt-BR/developers/models/pixverse/swap.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt