Vai al contenuto

ID-V2V

Integra

ID del modello 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"

File come nell'esempio: 1,013 $ 1013 crediti API i tuoi file vengono misurati prima dell'esecuzione Esegui in questa pagina

Ottieni la chiave API
Open model Da video a video fino a 720p #stylized#transform#editing

Rielabora lo stile di un video a partire da un primo fotogramma modificato, mantenendo identità e movimento del soggetto

Open model · Video

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio

Prompt che specifica il video con stile modificato desiderato.

•obbligatorio video_url
Trascina un file oppure

Riferimento per movimento e inquadratura usato nella generazione, fornito come URL del video sorgente.

•obbligatorio image_url
Trascina un file oppure

Riferimento per identità e stile nella rigenerazione video, fornito come URL che punta al primo fotogramma con stile modificato.

resolution predefinito 720p

Scegli 720p per output 1280×720 o 720×1280, oppure 480p per output 832×480 o 480×832. L'orientamento del video sorgente determina quali dimensioni applicare.

predefinito 81

Limita il numero di fotogrammi da produrre; se la sorgente ne contiene meno, il relativo numero di fotogrammi diventa il limite superiore.

Avanzate segmentation_prompt · num_inference_steps · guidance_scale · vace_scale · seed · enable_safety_checker · keyframes
0 / 100

Prompt per la selezione del soggetto in SAM-3, che identifica la regione i cui pixel guideranno la generazione. Al di fuori del soggetto segmentato, la generazione non è vincolata.

predefinito 30

Controllo di qualità e velocità della clip espresso come numero di passaggi di campionamento della diffusione per ciascuna clip: più passaggi migliorano la qualità ma richiedono più tempo.

predefinito 5

Intensità della guidance classifier-free, che bilancia l'aderenza al prompt e la creatività.

predefinito 1

Aderenza strutturale al video sorgente, regolata tramite la scala di condizionamento VACE.

Seed casuale condiviso tra tutte le clip quando se ne generano più di una, per consentire una generazione riproducibile.

Ancoraggi facoltativi dell'identità per video lunghi: fornisci fotogrammi chiave modificati con gli indici dei fotogrammi di output in cui devono apparire.

POST /run/id-v2v?wait=20 preventivo → 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"

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su ID-V2V

Rigenera un video sorgente (`video_url`) nello stile di un primo fotogramma rielaborato (`image_url`), guidato da un `prompt`. Fino a 5 `keyframes` possono ancorare l'identità nelle clip più lunghe. L'output è in 480p o 720p con `num_frames` da 17 a 241 e `segmentation_prompt` (person per impostazione predefinita) seleziona il soggetto i cui pixel condizionano il risultato.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
promptobbligatorio
Tipostring
Prompt che specifica il video con stile modificato desiderato.
video_urlobbligatorio video
Tipourl · video
Riferimento per movimento e inquadratura usato nella generazione, fornito come URL del video sorgente.
image_urlobbligatorio image
Tipourl · image
Riferimento per identità e stile nella rigenerazione video, fornito come URL che punta al primo fotogramma con stile modificato.
keyframesfacoltativo
Tipoobject[]
≤ 5 elementi
Ancoraggi facoltativi dell'identità per video lunghi: fornisci fotogrammi chiave modificati con gli indici dei fotogrammi di output in cui devono apparire.
keyframes[].image_urlobbligatorio
Tipourl · image
URL dell'immagine modificata per un ancoraggio dell'identità in un video lungo; le proporzioni dell'immagine non devono differire da quelle dell'output di più di 0.1. L'immagine appare senza modifiche a `frame_index`.
keyframes[].frame_indexobbligatorio
Tipointeger
≥ 1
Posiziona il fotogramma chiave in una posizione di output pari almeno a 1 e inferiore al numero totale di fotogrammi dell'output, usando l'indicizzazione a partire da 0. La posizione 0 è riservata al fotogramma iniziale modificato proveniente da `image_url`.
resolutionfacoltativo
Tipoenum
Predefinito720p
480p720p
Scegli 720p per output 1280×720 o 720×1280, oppure 480p per output 832×480 o 480×832. L'orientamento del video sorgente determina quali dimensioni applicare.
num_framesfacoltativo
Tipointeger
Predefinito81
17 – 241
Limita il numero di fotogrammi da produrre; se la sorgente ne contiene meno, il relativo numero di fotogrammi diventa il limite superiore.
segmentation_promptfacoltativo
Tipostring
Predefinitoperson
≤ 100 caratteri
Prompt per la selezione del soggetto in SAM-3, che identifica la regione i cui pixel guideranno la generazione. Al di fuori del soggetto segmentato, la generazione non è vincolata.
num_inference_stepsfacoltativo
Tipointeger
Predefinito30
2 – 40
Controllo di qualità e velocità della clip espresso come numero di passaggi di campionamento della diffusione per ciascuna clip: più passaggi migliorano la qualità ma richiedono più tempo.
guidance_scalefacoltativo
Tiponumber
Predefinito5
1 – 10
Intensità della guidance classifier-free, che bilancia l'aderenza al prompt e la creatività.
vace_scalefacoltativo
Tiponumber
Predefinito1
0 – 2
Aderenza strutturale al video sorgente, regolata tramite la scala di condizionamento VACE.
seedfacoltativo
Tipointeger | null
Seed casuale condiviso tra tutte le clip quando se ne generano più di una, per consentire una generazione riproducibile.
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Abilita i controlli di sicurezza sia sugli input sia sugli output.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

Output

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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
video
object {url, content_type, file_name, file_size}File video prodotto dalla generazione.
seed
integerValore seed applicato durante la generazione.

Altri modelli: Da video a video

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/id-v2v.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt