Avançar 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"

Ficheiros como o exemplo: 0,40 $ 400 créditos da API os seus ficheiros 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 utilizando uma imagem de destino

PixVerse · Vídeo

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

•obrigatório video_url
Largue um ficheiro ou

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

•obrigatório image_url
Largue um ficheiro ou

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

resolution predefiniçã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 predefinição person

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

predefinição 1

ID do frame 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, pelo que 1 identifica o primeiro frame e 24 identifica o frame 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 este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar Lembrar. Obter uma chave de API

Sobre PixVerse Swap

Recebe um vídeo de origem e uma imagem-alvo e substitui o conteúdo pela imagem de acordo com `mode`: person, object ou fundo. `keyframe_id` seleciona o frame utilizado para o mapeamento, contado a 24 FPS. A resolução da 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 PredefiniçãoPermitido Descrição
video_urlobrigatório video
Tipourl · video
URL de vídeo externo para a operação de substituição.
modeopcional
Tipoenum
Predefiniçãoperson
personobjectbackground
Modo utilizado para a operação de substituição.
keyframe_idopcional
Tipointeger
Predefinição1
≥ 1
ID do frame 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, pelo que 1 identifica o primeiro frame e 24 identifica o frame 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
Predefiniçã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
Predefiniçãotrue
Controla se o áudio original é mantido.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
A filtragem pode ser flexibilizada definindo false, desde que o autor do pedido esteja autorizado.
obrigatório Nome canónico, também aceite

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

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"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
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á disponível em https://doitong.com/pt-PT/developers/models/pixverse/swap.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt