Siirry sisältöön

ID-V2V

Integroi

Mallin tunniste 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"

Esimerkin kaltaiset tiedostot: 1,013 $ 1 013 API-krediittiä tiedostosi mitataan ennen suorittamista Suorita tällä sivulla

Hanki API-avain
Open model Videosta videoksi enintään 720p #stylized#transform#editing

Muokkaa videon tyyliä muokatun ensimmäisen ruudun perusteella säilyttäen kohteen identiteetin ja liikkeen

Open model · Video

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

•pakollinen

Kehote, joka määrittää halutun uudelleentyylitellyn videon.

•pakollinen video_url
Pudota tiedosto tai

Generoinnin liike- ja rajausviite lähdevideon URL-osoitteena.

•pakollinen image_url
Pudota tiedosto tai

Videon uudelleengeneroinnin identiteetti- ja tyyliviite URL-osoitteena, joka osoittaa uudelleentyyliteltyyn ensimmäiseen ruutuun.

resolution oletus 720p

Valitse 720p, jos haluat tulosteen koossa 1280×720 tai 720×1280, tai 480p, jos haluat tulosteen koossa 832×480 tai 480×832. Lähdevideon suunta määrää käytettävät mitat.

oletus 81

Rajoita tuotettavien ruutujen määrää. Jos lähteessä on vähemmän ruutuja, sen ruutumäärästä tulee yläraja.

Lisäasetukset segmentation_prompt · num_inference_steps · guidance_scale · vace_scale · seed · enable_safety_checker · keyframes
0 / 100

SAM-3:n kohteenvalintakehote, joka määrittää alueen, jonka pikselit ohjaavat generointia. Tämän segmentoidun kohteen ulkopuolella generointia ei rajoiteta.

oletus 30

Leikkeen laadun ja nopeuden säätö kunkin leikkeen diffuusio-otannan askelmääränä. Suurempi askelmäärä parantaa laatua mutta vie enemmän aikaa.

oletus 5

Luokittimettoman ohjauksen voimakkuus, joka tasapainottaa kehotteen noudattamista ja luovuutta.

oletus 1

Lähdevideon rakenteen noudattaminen, jota säädetään VACE-ohjauksen kertoimella.

Kaikille leikkeille yhteinen satunnaissiemen useita leikkeitä generoitaessa. Mahdollistaa toistettavan generoinnin.

Valinnaiset identiteettiankkurit pitkille videoille: anna uudelleentyylitellyt avainruudut sekä tulosteen ruutuindeksit, joissa niiden on esiinnyttävä.

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

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: ID-V2V

Luo `video_url`-lähdevideon uudelleen muokatun ensimmäisen ruudun (`image_url`) tyyliin `prompt`-kehotteen ohjaamana. Enintään 5 `keyframes`-ruutua voi ankkuroida identiteetin pidemmissä leikkeissä. Tuloste on 480p tai 720p, `num_frames` on 17–241, ja `segmentation_prompt` (oletus person) valitsee kohteen, jonka pikselit ohjaavat tulosta.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
promptpakollinen
Tyyppistring
Kehote, joka määrittää halutun uudelleentyylitellyn videon.
video_urlpakollinen video
Tyyppiurl · video
Generoinnin liike- ja rajausviite lähdevideon URL-osoitteena.
image_urlpakollinen image
Tyyppiurl · image
Videon uudelleengeneroinnin identiteetti- ja tyyliviite URL-osoitteena, joka osoittaa uudelleentyyliteltyyn ensimmäiseen ruutuun.
keyframesvalinnainen
Tyyppiobject[]
≤ 5 kohdetta
Valinnaiset identiteettiankkurit pitkille videoille: anna uudelleentyylitellyt avainruudut sekä tulosteen ruutuindeksit, joissa niiden on esiinnyttävä.
keyframes[].image_urlpakollinen
Tyyppiurl · image
Uudelleentyylitellyn kuvan URL-osoite pitkän videon identiteettiankkuriksi. Kuvan kuvasuhde saa poiketa tulosteen kuvasuhteesta enintään 0.1. Kuva esiintyy muuttamattomana kohdassa `frame_index`.
keyframes[].frame_indexpakollinen
Tyyppiinteger
≥ 1
Sijoita avainruutu tulosteessa kohtaan, joka on vähintään 1 ja pienempi kuin tulosteen ruutujen kokonaismäärä. Indeksointi alkaa nollasta. Kohta 0 on varattu uudelleentyylitellylle aloitusruudulle, jonka lähde on `image_url`.
resolutionvalinnainen
Tyyppienum
Oletus720p
480p720p
Valitse 720p, jos haluat tulosteen koossa 1280×720 tai 720×1280, tai 480p, jos haluat tulosteen koossa 832×480 tai 480×832. Lähdevideon suunta määrää käytettävät mitat.
num_framesvalinnainen
Tyyppiinteger
Oletus81
17 – 241
Rajoita tuotettavien ruutujen määrää. Jos lähteessä on vähemmän ruutuja, sen ruutumäärästä tulee yläraja.
segmentation_promptvalinnainen
Tyyppistring
Oletusperson
≤ 100 merkkiä
SAM-3:n kohteenvalintakehote, joka määrittää alueen, jonka pikselit ohjaavat generointia. Tämän segmentoidun kohteen ulkopuolella generointia ei rajoiteta.
num_inference_stepsvalinnainen
Tyyppiinteger
Oletus30
2 – 40
Leikkeen laadun ja nopeuden säätö kunkin leikkeen diffuusio-otannan askelmääränä. Suurempi askelmäärä parantaa laatua mutta vie enemmän aikaa.
guidance_scalevalinnainen
Tyyppinumber
Oletus5
1 – 10
Luokittimettoman ohjauksen voimakkuus, joka tasapainottaa kehotteen noudattamista ja luovuutta.
vace_scalevalinnainen
Tyyppinumber
Oletus1
0 – 2
Lähdevideon rakenteen noudattaminen, jota säädetään VACE-ohjauksen kertoimella.
seedvalinnainen
Tyyppiinteger | null
Kaikille leikkeille yhteinen satunnaissiemen useita leikkeitä generoitaessa. Mahdollistaa toistettavan generoinnin.
enable_safety_checkervalinnainen
Tyyppiboolean
Oletustrue
Ottaa turvatarkistukset käyttöön sekä syötteille että tulosteille.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
video
object {url, content_type, file_name, file_size}Generoinnissa tuotettu videotiedosto.
seed
integerGeneroinnin aikana käytetty siemenen arvo.

Lisää malleja: Videosta videoksi

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/id-v2v.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt