Přejít na obsah

ID-V2V

Integrace

ID modelu 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"

Soubory jako v příkladu: 1,013 $ 1 013 kreditů API vaše soubory se před spuštěním změří Spustit na této stránce

Získat API klíč
Open model Video na video až 720p #stylized#transform#editing

Mění styl videa podle upraveného prvního snímku při zachování identity objektu a pohybu

Open model · Video

Zde se zobrazí váš první výsledek

Níže sestavte požadavek a spusťte ho pomocí svého API klíče. Výstupy se kopírují do našeho úložiště a uchovávají se navždy nebo 7 dne zdarma.

Sestavit požadavek

Ovládací prvky se generují ze schématu modelu. Kód a cena se aktualizují podle provedených změn.

•povinné

Prompt určující požadované restylizované video.

•povinné video_url
Přetáhněte soubor nebo

Reference pohybu a záběru pro generování, zadaná jako URL zdrojového videa.

•povinné image_url
Přetáhněte soubor nebo

Reference identity a stylu pro regeneraci videa, zadaná jako URL odkazující na restylizovaný první snímek.

resolution výchozí 720p

Zvolte 720p pro výstup 1280×720 nebo 720×1280, případně 480p pro výstup 832×480 nebo 480×832. Orientace zdrojového videa určuje, které rozměry se použijí.

výchozí 81

Omezí počet vytvořených snímků; pokud zdroj obsahuje méně snímků, jeho počet snímků se stane horní hranicí.

Pokročilé segmentation_prompt · num_inference_steps · guidance_scale · vace_scale · seed · enable_safety_checker · keyframes
0 / 100

Prompt pro výběr objektu pro SAM-3, který určuje oblast, jejíž pixely budou řídit generování. Mimo tento segmentovaný objekt není generování omezeno.

výchozí 30

Řízení kvality a rychlosti klipu vyjádřené počtem difuzních vzorkovacích kroků pro každý klip: více kroků zvyšuje kvalitu, ale trvá déle.

výchozí 5

Síla classifier-free guidance vyvažující dodržení promptu a kreativitu.

výchozí 1

Dodržení struktury zdrojového videa upravené pomocí měřítka podmiňování VACE.

Náhodný seed sdílený všemi klipy při generování více klipů, který umožňuje reprodukovatelné generování.

Volitelné kotvy identity pro dlouhá videa: zadejte restylizované klíčové snímky s indexy výstupních snímků, na kterých se mají objevit.

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

Spustit tento požadavek

Váš klíč zůstává v tomto prohlížeči: odesílá se pouze do Doitong API a uloží se do localStorage jen tehdy, když zaškrtnete možnost Zapamatovat. Získat klíč API

O modelu ID-V2V

Znovu vygeneruje zdrojové video (`video_url`) ve vzhledu upraveného prvního snímku (`image_url`) podle `prompt`. Až 5 `keyframes` může ukotvit identitu v delších klipech. Výstup má rozlišení 480p nebo 720p s `num_frames` od 17 do 241 a `segmentation_prompt` (výchozí hodnota person) vybere objekt, jehož pixely ovlivní výsledek.

Parametry

Odešlete buď kanonický název, nebo nativní název, ne oba. Kanonické názvy

NázevTyp VýchozíPovolené Popis
promptpovinné
Typstring
Prompt určující požadované restylizované video.
video_urlpovinné video
Typurl · video
Reference pohybu a záběru pro generování, zadaná jako URL zdrojového videa.
image_urlpovinné image
Typurl · image
Reference identity a stylu pro regeneraci videa, zadaná jako URL odkazující na restylizovaný první snímek.
keyframesvolitelné
Typobject[]
≤ 5 položek
Volitelné kotvy identity pro dlouhá videa: zadejte restylizované klíčové snímky s indexy výstupních snímků, na kterých se mají objevit.
keyframes[].image_urlpovinné
Typurl · image
URL restylizovaného obrázku pro kotvu identity v dlouhém videu; poměr stran obrázku se od výstupního nesmí lišit o více než 0.1. Obrázek se zobrazí beze změny na `frame_index`.
keyframes[].frame_indexpovinné
Typinteger
≥ 1
Umístěte klíčový snímek na výstupní pozici alespoň 1 a menší než celkový počet výstupních snímků, s indexováním od 0. Pozice 0 je vyhrazena restylizovanému počátečnímu snímku z `image_url`.
resolutionvolitelné
Typenum
Výchozí720p
480p720p
Zvolte 720p pro výstup 1280×720 nebo 720×1280, případně 480p pro výstup 832×480 nebo 480×832. Orientace zdrojového videa určuje, které rozměry se použijí.
num_framesvolitelné
Typinteger
Výchozí81
17 – 241
Omezí počet vytvořených snímků; pokud zdroj obsahuje méně snímků, jeho počet snímků se stane horní hranicí.
segmentation_promptvolitelné
Typstring
Výchozíperson
≤ 100 znaků
Prompt pro výběr objektu pro SAM-3, který určuje oblast, jejíž pixely budou řídit generování. Mimo tento segmentovaný objekt není generování omezeno.
num_inference_stepsvolitelné
Typinteger
Výchozí30
2 – 40
Řízení kvality a rychlosti klipu vyjádřené počtem difuzních vzorkovacích kroků pro každý klip: více kroků zvyšuje kvalitu, ale trvá déle.
guidance_scalevolitelné
Typnumber
Výchozí5
1 – 10
Síla classifier-free guidance vyvažující dodržení promptu a kreativitu.
vace_scalevolitelné
Typnumber
Výchozí1
0 – 2
Dodržení struktury zdrojového videa upravené pomocí měřítka podmiňování VACE.
seedvolitelné
Typinteger | null
Náhodný seed sdílený všemi klipy při generování více klipů, který umožňuje reprodukovatelné generování.
enable_safety_checkervolitelné
Typboolean
Výchozítrue
Povolí bezpečnostní kontroly vstupů i výstupů.
povinné Kanonický název, také podporován

Parametry souborů přijímají veřejnou adresu https:// URL, data: URI do 10 MB nebo file_url nahraného souboru. Soubory

Výstup

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"
  }
}
Vaše soubory, vaše volbaKaždý outputs[].url je kopie v našem úložišti: uchovávaná navždy (zpoplatněná za GB-měsíc) nebo 7 dne zdarma podle nastavení účtu nebo ?storage=.
Stejná struktura u každého modelutype, url, content_type, width, height a duration pro obrázky, video i zvuk. output je vlastní objekt výsledku modelu.
Pole výstupu
video
object {url, content_type, file_name, file_size}Video soubor vytvořený generováním.
seed
integerHodnota seedu použitá při generování.

Další modely: Video na video

Pro AI agenty: tato stránka je ve formátu Markdown na adrese https://doitong.com/cs/developers/models/id-v2v.md. Všechny modely a návody: https://doitong.com/developers/llms.txt