Ir 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"

Arquivos como o exemplo: $ 1,013 1.013 créditos de API seus arquivos 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 quadro reestilizado, mantendo a identidade e o movimento do objeto

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

Prompt especificando o vídeo com estilo desejado.

•obrigatório video_url
Solte um arquivo ou

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

•obrigatório image_url
Solte um arquivo ou

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

resolution padrão 720p

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

padrão 81

Limita quantos quadros produzir; se a fonte contiver menos quadros, essa quantidade se tornará 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 assunto para SAM-3, identificando a região cujos pixels orientarão a geração. Fora desse assunto segmentado, a geração não é restringida.

padrão 30

Controle de qualidade e velocidade do clipe, expresso como uma quantidade de etapas de amostragem de difusão para cada clipe: usar mais etapas melhora a qualidade, mas leva mais tempo.

padrão 5

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

padrão 1

Aderência estrutural ao vídeo de origem, ajustada pela escala de condicionamento VACE.

Seed aleatório compartilhado entre todos os clipes ao gerar vários clipes, permitindo geração reproduzível.

Âncoras de identidade opcionais para vídeos longos: forneça quadros-chave com estilo alterado e os índices dos quadros de saída em que 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 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 ID-V2V

Regenera um vídeo de origem (`video_url`) com o visual de um primeiro quadro 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` de 17 a 241, e `segmentation_prompt` (person por padrão) seleciona o objeto cujos pixels condicionam o resultado.

Parâmetros

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

NomeTipo PadrãoPermitido Descrição
promptobrigatório
Tipostring
Prompt especificando o vídeo com estilo desejado.
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 do vídeo, fornecida como uma URL que aponta para o primeiro quadro com estilo alterado.
keyframesopcional
Tipoobject[]
≤ 5 itens
Âncoras de identidade opcionais para vídeos longos: forneça quadros-chave com estilo alterado e os índices dos quadros de saída em que devem aparecer.
keyframes[].image_urlobrigatório
Tipourl · image
URL da imagem com estilo alterado para uma âncora de identidade em um 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ção em `frame_index`.
keyframes[].frame_indexobrigatório
Tipointeger
≥ 1
Coloque o quadro-chave em uma posição de saída de pelo menos 1 e inferior à quantidade total de quadros da saída, usando indexação baseada em 0. A posição 0 é reservada para o quadro inicial com estilo alterado de `image_url`.
resolutionopcional
Tipoenum
Padrão720p
480p720p
Escolha 720p para saída 1280×720 ou 720×1280, ou 480p para saída 832×480 ou 480×832. A orientação do vídeo de origem determina quais dimensões se aplicam.
num_framesopcional
Tipointeger
Padrão81
17 – 241
Limita quantos quadros produzir; se a fonte contiver menos quadros, essa quantidade se tornará o limite superior.
segmentation_promptopcional
Tipostring
Padrãoperson
≤ 100 caracteres
Prompt de seleção do assunto para SAM-3, identificando a região cujos pixels orientarão a geração. Fora desse assunto segmentado, a geração não é restringida.
num_inference_stepsopcional
Tipointeger
Padrão30
2 – 40
Controle de qualidade e velocidade do clipe, expresso como uma quantidade de etapas de amostragem de difusão para cada clipe: usar mais etapas melhora a qualidade, mas leva mais tempo.
guidance_scaleopcional
Tiponumber
Padrão5
1 – 10
Intensidade da orientação sem classificador, equilibrando a aderência ao prompt e a criatividade.
vace_scaleopcional
Tiponumber
Padrão1
0 – 2
Aderência estrutural ao vídeo de origem, ajustada pela escala de condicionamento VACE.
seedopcional
Tipointeger | null
Seed aleatório compartilhado entre todos os clipes ao gerar vários clipes, permitindo geração reproduzível.
enable_safety_checkeropcional
Tipoboolean
Padrãotrue
Ativa verificações de segurança nas entradas e saídas.
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": "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"
  }
}
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}Arquivo de vídeo produzido pela geração.
seed
integerValor de seed aplicado durante a geração.

Mais modelos: Vídeo para vídeo

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