Avançar para o conteúdo

ID-V2V

Integrar

ID do modelo id-v2v
# 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/id-v2v?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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: 1,013 $ 1013 créditos da API os seus ficheiros são medidos antes da execução Executar nesta página

Obter chave de API
Open model Vídeo para vídeo até 720p #stylized#transform#editing

Reestiliza um vídeo a partir de um primeiro fotograma reestilizado, mantendo a identidade e o movimento do sujeito

Open model · 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

Prompt que especifica o vídeo pretendido com novo estilo.

•obrigatório video_url
Largue um ficheiro ou

Referência de movimento e enquadramento para a geração, fornecida como URL do vídeo de origem.

•obrigatório image_url
Largue um ficheiro ou

Referência de identidade e estilo para regeneração de vídeo, fornecida como URL que aponta para o primeiro frame com novo estilo.

resolution predefinição 720p

Escolha 720p para uma saída de 1280×720 ou 720×1280, ou 480p para uma saída de 832×480 ou 480×832. A orientação do vídeo de origem determina quais as dimensões aplicáveis.

predefinição 81

Limita o número de frames a produzir; se a fonte contiver menos frames, o número de frames da fonte torna-se o limite superior.

Avançado segmentation_prompt · num_inference_steps · guidance_scale · vace_scale · seed · enable_safety_checker · keyframes
0 / 100

Prompt de seleção do objeto para SAM-3, que identifica a região cujos píxeis orientarão a geração. Fora desse objeto segmentado, a geração não tem restrições.

predefinição 30

Controlo da qualidade e velocidade do clipe, expresso como um número de passos de amostragem de difusão para cada clipe: utilizar mais passos melhora a qualidade, mas demora mais tempo.

predefinição 5

Intensidade da orientação sem classificador, equilibrando a adesão ao prompt e a criatividade.

predefinição 1

Adesão estrutural ao vídeo de origem, ajustada através da escala de condicionamento VACE.

Seed aleatória partilhada por todos os clipes ao gerar vários clipes, permitindo uma geração reprodutível.

Âncoras de identidade opcionais para vídeos longos: forneça keyframes com novo estilo e os índices de frame da saída onde devem aparecer.

POST /run/id-v2v?wait=20 cotação → 1,013 $
# 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/id-v2v?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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 ID-V2V

Regenera um vídeo de origem (`video_url`) com o visual de um primeiro fotograma reestilizado (`image_url`), orientado por um `prompt`. Até 5 `keyframes` podem fixar a identidade em clipes mais longos. A saída é 480p ou 720p, com `num_frames` entre 17 e 241, e `segmentation_prompt` (person por predefinição) seleciona o sujeito cujos píxeis condicionam o resultado.

Parâmetros

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

NomeTipo PredefiniçãoPermitido Descrição
promptobrigatório
Tipostring
Prompt que especifica o vídeo pretendido com novo estilo.
video_urlobrigatório video
Tipourl · video
Referência de movimento e enquadramento para a geração, fornecida como URL do vídeo de origem.
image_urlobrigatório image
Tipourl · image
Referência de identidade e estilo para regeneração de vídeo, fornecida como URL que aponta para o primeiro frame com novo estilo.
keyframesopcional
Tipoobject[]
≤ 5 itens
Âncoras de identidade opcionais para vídeos longos: forneça keyframes com novo estilo e os índices de frame da saída onde devem aparecer.
keyframes[].image_urlobrigatório
Tipourl · image
URL da imagem com novo estilo para uma âncora de identidade num vídeo longo; a proporção da imagem não pode diferir da saída em mais de 0.1. A imagem aparece sem alterações em `frame_index`.
keyframes[].frame_indexobrigatório
Tipointeger
≥ 1
Coloque o keyframe numa posição de saída igual ou superior a 1 e inferior ao número total de frames da saída, utilizando indexação baseada em 0. A posição 0 está reservada para o frame inicial com novo estilo de `image_url`.
resolutionopcional
Tipoenum
Predefinição720p
480p720p
Escolha 720p para uma saída de 1280×720 ou 720×1280, ou 480p para uma saída de 832×480 ou 480×832. A orientação do vídeo de origem determina quais as dimensões aplicáveis.
num_framesopcional
Tipointeger
Predefinição81
17 – 241
Limita o número de frames a produzir; se a fonte contiver menos frames, o número de frames da fonte torna-se o limite superior.
segmentation_promptopcional
Tipostring
Predefiniçãoperson
≤ 100 caracteres
Prompt de seleção do objeto para SAM-3, que identifica a região cujos píxeis orientarão a geração. Fora desse objeto segmentado, a geração não tem restrições.
num_inference_stepsopcional
Tipointeger
Predefinição30
2 – 40
Controlo da qualidade e velocidade do clipe, expresso como um número de passos de amostragem de difusão para cada clipe: utilizar mais passos melhora a qualidade, mas demora mais tempo.
guidance_scaleopcional
Tiponumber
Predefinição5
1 – 10
Intensidade da orientação sem classificador, equilibrando a adesão ao prompt e a criatividade.
vace_scaleopcional
Tiponumber
Predefinição1
0 – 2
Adesão estrutural ao vídeo de origem, ajustada através da escala de condicionamento VACE.
seedopcional
Tipointeger | null
Seed aleatória partilhada por todos os clipes ao gerar vários clipes, permitindo uma geração reprodutível.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
Ativa verificações de segurança nas entradas e nas saídas.
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": "id-v2v",
  "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": 1013,
    "usd": "1.013",
    "charged": 1013,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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
    },
    "seed": 42
  },
  "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}Ficheiro de vídeo produzido pela geração.
seed
integerValor da seed aplicado durante a geração.

Mais modelos: Vídeo para vídeo

Para agentes de IA: esta página em Markdown está disponível em https://doitong.com/pt-PT/developers/models/id-v2v.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt