ID-V2V

Unganisha

Kitambulisho cha modeli 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"

const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/id-v2v?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "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"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "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",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/id-v2v", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

# 1. Connect once (Claude Code; Cursor, VS Code, Claude Desktop: https://doitong.com/sw/developers/docs/mcp)
claude mcp add --transport http doitong-models https://api.doitong.com/v1/mcp \
  --header "Authorization: Bearer $DOITONG_API_KEY"

# 2. Your agent calls the "run" tool with:
{
  "model_id": "id-v2v",
  "input": {
    "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"
  }
}

Piga modeli ya ID-V2V (id-v2v) kupitia Doitong API. Nyaraka za mawakala: https://doitong.com/sw/developers/models/id-v2v.md

POST https://api.doitong.com/v1/run/id-v2v?wait=20
Authorization: Bearer $DOITONG_API_KEY
Content-Type: application/json

{
  "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"
}

Ikiwa hali ya jibu ni "queued" au "running", piga GET https://api.doitong.com/v1/requests/REQUEST_ID?wait=20 mara kwa mara hadi iwe "succeeded"; faili ziko kwenye outputs[].url. POST https://api.doitong.com/v1/quote/id-v2v yenye mwili uleule hurejesha bei kamili kabla ya kuendesha.

Faili kama mfano: $ 1.013 salio za API 1,013 faili zako hupimwa kabla ya kuendesha Iendeshe kwenye ukurasa huu

Pata ufunguo wa API

Open model Video hadi Video hadi 720p #stylized#transform#editing

Hubadilisha mtindo wa video kutoka kwa fremu ya kwanza iliyobadilishwa huku ikihifadhi utambulisho na mwendo wa mhusika

OpenAPI Markdown

Open model · Video

Tokeo lako la kwanza linaonekana hapa

Unda ombi hapa chini na uliendeshe kwa ufunguo wako wa API. Matokeo yanakiliwa kwenye hifadhi yetu, yakihifadhiwa milele au 7 siku bila malipo.

Unda ombi

Bei kwa kila sekunde ya video yako ya kutolewa

Bei kulingana na uingizaji wako

$ 0.20 / sekunde ya video ya tokeo

salio za API 200 / sekunde ya video ya tokeo

Ombi hili: sekunde 5.0625 × $ 0.20 $ 1.013 salio za API 1,013

Endesha · $ 1.013

Hutozwa tu ikifanikiwa, na kurejeshewa kiotomatiki ikishindwa.

num_frames chaguomsingi 81

Faili zako za kuingiza

video_url

Urefu, s Kasi ya fremu, fps

Kikokotoo hutumia nambari hizi. POST /quote/id-v2v hupima faili zako halisi na kurejesha bei kamili.

Faili zako hupimwa kabla ya kuendeshwa (urefu, mwonekano, kasi ya fremu); makadirio hurejesha bei kamili na uendeshaji hutozwa kiasi hicho hicho.

Endpoint ya makadirio: POST /quote/{id}

Unda ombi

Vidhibiti vinazalishwa kutoka kwenye schema ya modeli. Msimbo na bei husasishwa unapovibadilisha.

prompt •inahitajika

Kidokezo kinachobainisha video iliyorekebishwa inayotakiwa.

video •inahitajika video_url

Dondosha faili, au

Marejeleo ya mwendo na fremu kwa uzalishaji, yanayotolewa kama URL ya video chanzo.

image •inahitajika image_url

Dondosha faili, au

Marejeleo ya utambulisho na mtindo kwa uzalishaji upya wa video, yanayotolewa kama URL inayoelekeza kwenye fremu ya kwanza iliyorekebishwa.

resolution chaguomsingi 720p

Chagua 720p kwa tokeo la 1280×720 au 720×1280, au 480p kwa tokeo la 832×480 au 480×832. Mwelekeo wa video chanzo huamua vipimo vitakavyotumika.

num_frames chaguomsingi 81

Punguza idadi ya fremu za kuzalisha; ikiwa chanzo kina fremu chache, idadi yake ya fremu huwa kikomo cha juu.

Ya kina segmentation_prompt · num_inference_steps · guidance_scale · vace_scale · seed · enable_safety_checker · keyframes

segmentation_prompt 0 / 100

Kidokezo cha kuchagua mada kwa SAM-3, kinachobainisha eneo ambalo pikseli zake zitaongoza uzalishaji. Nje ya mada hiyo iliyogawanywa, uzalishaji hauna vikwazo.

num_inference_steps chaguomsingi 30

Udhibiti wa ubora na kasi ya klipu unaoonyeshwa kama idadi ya hatua za sampuli za diffusion kwa kila klipu: kutumia hatua nyingi huboresha ubora lakini huchukua muda zaidi.

guidance_scale chaguomsingi 5

Nguvu ya mwongozo usio na klasifaya, inayosawazisha ufuasi wa kidokezo na ubunifu.

vace_scale chaguomsingi 1

Ufuasi wa muundo wa video chanzo, unaorekebishwa kupitia kipimo cha kuweka masharti cha VACE.

seed

Mbegu ya nasibu inayoshirikiwa na klipu zote wakati wa kuzalisha klipu nyingi, ikiruhusu uzalishaji unaoweza kurudiwa.

keyframes

Viashiria vya hiari vya utambulisho kwa video ndefu: toa fremu muhimu zilizorekebishwa pamoja na faharasa za fremu za tokeo zinapopaswa kuonekana.

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

const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/id-v2v?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "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"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");

import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "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",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/id-v2v", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "id-v2v",
      "input": {
        "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"
      },
      "wait_seconds": 20
    }
  }
}

Endesha ombi hili

Ufunguo wa API

Key yako inabaki kwenye kivinjari hiki: inatumwa kwa Doitong API pekee na kuhifadhiwa (localStorage) tu ukiweka tiki kwenye Kumbuka. Kumbuka katika kivinjari hiki Pata ufunguo wa API

Kuhusu ID-V2V

Huzalisha upya video ya chanzo (`video_url`) kwa mwonekano wa fremu ya kwanza iliyobadilishwa (`image_url`), ikiongozwa na `prompt`. Hadi `keyframes` 5 zinaweza kushikilia utambulisho katika klipu ndefu. Matokeo ni 480p au 720p yenye `num_frames` kutoka 17 hadi 241, na `segmentation_prompt` (person kwa chaguomsingi) huchagua mhusika ambaye pikseli zake huongoza matokeo.

Vigezo

Tuma jina rasmi au jina asilia, si yote mawili. Majina rasmi

JinaAina ChaguomsingiInaruhusiwa Maelezo

promptinahitajika

Ainastring

Kidokezo kinachobainisha video iliyorekebishwa inayotakiwa.

video_urlinahitajika video

Ainaurl · video

Marejeleo ya mwendo na fremu kwa uzalishaji, yanayotolewa kama URL ya video chanzo.

image_urlinahitajika image

Ainaurl · image

Marejeleo ya utambulisho na mtindo kwa uzalishaji upya wa video, yanayotolewa kama URL inayoelekeza kwenye fremu ya kwanza iliyorekebishwa.

keyframessi lazima

Ainaobject[]

≤ vipengee 5

Viashiria vya hiari vya utambulisho kwa video ndefu: toa fremu muhimu zilizorekebishwa pamoja na faharasa za fremu za tokeo zinapopaswa kuonekana.

keyframes[].image_urlinahitajika

Ainaurl · image

URL ya picha iliyorekebishwa kwa kiashiria cha utambulisho katika video ndefu; uwiano wa picha lazima utofautiane na wa tokeo kwa isiyozidi 0.1. Picha huonekana bila mabadiliko kwenye `frame_index`.

keyframes[].frame_indexinahitajika

Ainainteger

≥ 1

Weka fremu muhimu katika nafasi ya tokeo ya angalau 1 na iliyo chini ya jumla ya fremu za tokeo, ukitumia faharasa ya kuanzia 0. Nafasi 0 imetengwa kwa fremu ya mwanzo iliyorekebishwa kutoka `image_url`.

resolutionsi lazima

Ainaenum

Chaguomsingi720p

480p720p

Chagua 720p kwa tokeo la 1280×720 au 720×1280, au 480p kwa tokeo la 832×480 au 480×832. Mwelekeo wa video chanzo huamua vipimo vitakavyotumika.

num_framessi lazima

Ainainteger

Chaguomsingi81

17 – 241

Punguza idadi ya fremu za kuzalisha; ikiwa chanzo kina fremu chache, idadi yake ya fremu huwa kikomo cha juu.

segmentation_promptsi lazima

Ainastring

Chaguomsingiperson

≤ herufi 100

Kidokezo cha kuchagua mada kwa SAM-3, kinachobainisha eneo ambalo pikseli zake zitaongoza uzalishaji. Nje ya mada hiyo iliyogawanywa, uzalishaji hauna vikwazo.

num_inference_stepssi lazima

Ainainteger

Chaguomsingi30

2 – 40

Udhibiti wa ubora na kasi ya klipu unaoonyeshwa kama idadi ya hatua za sampuli za diffusion kwa kila klipu: kutumia hatua nyingi huboresha ubora lakini huchukua muda zaidi.

guidance_scalesi lazima

Ainanumber

Chaguomsingi5

1 – 10

Nguvu ya mwongozo usio na klasifaya, inayosawazisha ufuasi wa kidokezo na ubunifu.

vace_scalesi lazima

Ainanumber

Chaguomsingi1

0 – 2

Ufuasi wa muundo wa video chanzo, unaorekebishwa kupitia kipimo cha kuweka masharti cha VACE.

seedsi lazima

Ainainteger | null

Mbegu ya nasibu inayoshirikiwa na klipu zote wakati wa kuzalisha klipu nyingi, ikiruhusu uzalishaji unaoweza kurudiwa.

enable_safety_checkersi lazima

Ainaboolean

Chaguomsingitrue

Huwasha ukaguzi wa usalama kwenye maingizo na matokeo.

inahitajika Jina rasmi, pia linakubalika

Vigezo vya faili vinakubali URL ya umma ya https://, data: URI ya hadi 10 MB, au file_url ya upakiaji. Faili

Tokeo

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

Faili zako, chaguo lakoKila outputs[].url ni nakala kwenye hifadhi yetu: huhifadhiwa milele (hutozwa kwa GB kwa mwezi) au 7 siku bila malipo, kulingana na mpangilio wa akaunti yako au ?storage=.

Muundo uleule kwenye kila modelitype, url, content_type, width, height na duration, kwa picha, video na sauti. output ni kitu cha matokeo cha modeli yenyewe.

Sehemu za tokeo

video: object {url, content_type, file_name, file_size}Faili ya video iliyozalishwa.
seed: integerThamani ya seed inayotumika wakati wa uzalishaji.

Miundo zaidi: Video hadi Video

Kwa mawakala wa AI: ukurasa huu katika Markdown unapatikana kwenye https://doitong.com/sw/developers/models/id-v2v.md. Modeli na miongozo yote: https://doitong.com/developers/llms.txt

Tokeo lako la kwanza linaonekana hapa

Unda ombi

Endesha ombi hili

Kuhusu ID-V2V

Vigezo

Tokeo

Tofauti nyingine za ID-V2V

ID-V2V Relight Tofauti: 2

Miundo zaidi: Video hadi Video

AMT Interpolation Tofauti: 2

AnimateDiff Turbo · Video to Video Tofauti: 2

AnimateDiff · Video to Video Tofauti: 2

Bernini-R Edit Video Tofauti: 5