Skip to content

ID-V2V

Integrate

Model id 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"

Files like the example: $1.013 1,013 API credits your files are measured before the run Run it on this page

Get API key
Open model Video to Video up to 720p #stylized#transform#editing

Restyles a video from a restyled first frame while keeping subject identity and motion

Open model · Video

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required

Prompt specifying the desired restyled video.

•required video_url
Drop a file, or

Motion and framing reference for generation, supplied as the source video's URL.

•required image_url
Drop a file, or

Identity and style reference for video regeneration, supplied as a URL pointing to the restyled first frame.

resolution default 720p

Choose 720p for 1280×720 or 720×1280 output, or 480p for 832×480 or 480×832 output. The source video's orientation determines which dimensions apply.

default 81

Limit how many frames to produce; if the source contains fewer frames, its frame count becomes the upper bound.

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

Subject-selection prompt for SAM-3, identifying the region whose pixels will guide generation. Outside that segmented subject, generation is unconstrained.

default 30

Clip-quality and speed control expressed as a diffusion sampling step count for each clip: using more steps improves quality but takes longer.

default 5

Classifier-free guidance strength, balancing adherence to the prompt against creativity.

default 1

Structural adherence to the source video, adjusted through the VACE conditioning scale.

Random seed shared across all clips when generating multiple clips, allowing reproducible generation.

Optional identity anchors for long videos: supply restyled keyframes with the output frame indices where they must appear.

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

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About ID-V2V

Regenerates a source video (`video_url`) in the look of a restyled first frame (`image_url`) guided by a `prompt`. Up to 5 `keyframes` can anchor identity in longer clips. Output is 480p or 720p with `num_frames` from 17 to 241, and `segmentation_prompt` (default person) selects the subject whose pixels condition the result.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
promptrequired
Typestring
Prompt specifying the desired restyled video.
video_urlrequired video
Typeurl · video
Motion and framing reference for generation, supplied as the source video's URL.
image_urlrequired image
Typeurl · image
Identity and style reference for video regeneration, supplied as a URL pointing to the restyled first frame.
keyframesoptional
Typeobject[]
≤ 5 items
Optional identity anchors for long videos: supply restyled keyframes with the output frame indices where they must appear.
keyframes[].image_urlrequired
Typeurl · image
Restyled image URL for an identity anchor in a long video; the image's aspect ratio must differ from the output's by no more than 0.1. The image appears without alteration at `frame_index`.
keyframes[].frame_indexrequired
Typeinteger
≥ 1
Place the keyframe at an output position of at least 1 and below the output's total frame count, using 0-based indexing. Position 0 is reserved for the restyled starting frame from `image_url`.
resolutionoptional
Typeenum
Default720p
480p720p
Choose 720p for 1280×720 or 720×1280 output, or 480p for 832×480 or 480×832 output. The source video's orientation determines which dimensions apply.
num_framesoptional
Typeinteger
Default81
17 – 241
Limit how many frames to produce; if the source contains fewer frames, its frame count becomes the upper bound.
segmentation_promptoptional
Typestring
Defaultperson
≤ 100 characters
Subject-selection prompt for SAM-3, identifying the region whose pixels will guide generation. Outside that segmented subject, generation is unconstrained.
num_inference_stepsoptional
Typeinteger
Default30
2 – 40
Clip-quality and speed control expressed as a diffusion sampling step count for each clip: using more steps improves quality but takes longer.
guidance_scaleoptional
Typenumber
Default5
1 – 10
Classifier-free guidance strength, balancing adherence to the prompt against creativity.
vace_scaleoptional
Typenumber
Default1
0 – 2
Structural adherence to the source video, adjusted through the VACE conditioning scale.
seedoptional
Typeinteger | null
Random seed shared across all clips when generating multiple clips, allowing reproducible generation.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Enables safety checks on both inputs and outputs.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

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"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
video
object {url, content_type, file_name, file_size}Video file produced by generation.
seed
integerSeed value applied during generation.

More models: Video to Video

For AI agents: this page as Markdown is at https://doitong.com/en-US/developers/models/id-v2v.md. All models and guides: https://doitong.com/developers/llms.txt