Přejít na obsah

Ltx 2.3 Quality · Reference Video to Video

Integrace

ID modelu ltx-2.3-quality/reference-video-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ltx-2.3-quality/reference-video-to-video?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"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Soubory jako v příkladu: 0,27 $ 270 kreditů API · ≈ 29,05 ₽ vaše soubory se před spuštěním změří Spustit na této stránce

Získat API klíč
Lightricks · 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 použitý k řízení generování.

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

URL odkazující na referenční video používané k řízení pohybu a struktury.

resolution výchozí auto

Rozměry výstupního videa, které ovlivňují také stabilní délku: menší velikosti umožňují více snímků, větší snižují maximum. Vestavěný odhad řízení udržuje velikost blízko oficiálního pracovního postupu řízení; přímé řízení pomocí `skip_control_preprocess` a `control_video_url` místo toho respektuje explicitní rozměry se zarovnáním na 64px. V režimu přímého řízení `auto` převezme rozměry zdroje a poměr stran v mezích LTX.

výchozí 121

Počet výstupních snímků podléhající rozpočtu stability IC-LoRA založenému na součinu rozlišení a počtu snímků. Odpověď 422 znamená překročení tohoto rozpočtu: snižte rozlišení nebo `num_frames`. Rozpočet umožňuje přibližně 150 snímků při rozměrech třídy 720p a více při menších velikostech.

Pokročilé negative_prompt · control_video_url · image · mid_image_url · end_image · video_quality · video_write_mode · video_strength · strength · frames_per_second · num_inference_steps · guidance_scale · seed · skip_control_preprocess · preserve_original_video · enable_prompt_expansion · enable_safety_checker
výchozí color distortion, ove...

Negativní prompt určující, čemu se má generování vyhnout.

Přetáhněte soubor nebo

Volitelné předem vypočítané řídicí video, použité místo vestavěného odhadu řízení, pokud je dodáno společně s `skip_control_preprocess`. Po převzorkování na shodné rozměry výstupu a počet snímků se stane přímým řídicím signálem. Video může například obsahovat již vykreslenou kompozici hloubky, hran nebo pózy.

image_url
Přetáhněte soubor nebo

Volitelný styl ukotvení obrázku nebo identita postavy jako klíčový snímek prvního snímku.

Přetáhněte soubor nebo

Volitelný vzhled ukotvení obrázku přibližně uprostřed klipu, doplňující počáteční klíčový snímek `image_url`. Pomáhá vzhledu sledovat pohyb kamery místo postupného odchylování; vyžaduje `image_url`.

end_image_url
Přetáhněte soubor nebo

Volitelný vzhled ukotvení obrázku v posledním snímku klipu. Užitečné, když pohyb kamery končí na jiném místě než počáteční obrázek; vyžaduje `image_url`.

video_quality výchozí high

Předvolba kvality použitá pro výstupní video.

video_write_mode výchozí balanced

Režim zápisu výsledného videa.

výchozí 0.6

Volnost změny pohybu a struktury referenčního videa řídí tato síla podmiňování: nižší hodnoty umožňují větší změny.

výchozí 1

Řízení odšumování pro vzorkování převodu referenčního videa na video, jehož účinek závisí na `preserve_original_video`. Když je režim vypnutý, pouze zkracuje plán odšumování; při zapnutí řídí transformaci zdrojových pixelů, přičemž 1.0 vše znovu vygeneruje a nižší hodnoty zachovají více (například 0.5 zachová přibližně 50 %).

výchozí 24

Snímková frekvence výstupního videa měřená ve snímcích za sekundu.

výchozí 15

Nastavte počet kroků inference, maximálně 30; beze změny se použije 15.

výchozí 1

Upravte vedení bez klasifikátoru pomocí této škály; její výchozí nastavení cílí na vysokou kvalitu i rychlé generování.

Seed zajišťující reprodukovatelné generování. Nastavení na None vybere seed náhodně.

POST /run/ltx-2.3-quality/reference-video-to-video?wait=20 cena → 0,27 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ltx-2.3-quality/reference-video-to-video?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"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/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 Ltx 2.3 Quality · Reference Video to Video

Vytvoří nové video z povinného `prompt` a referenčního `video_url`, který dodává pohyb a strukturu. Volitelné `image_url`, `mid_image_url` a `end_image_url` ukotví vzhled na začátku, uprostřed a na konci. `video_strength` a `strength` (obě 0 až 1) řídí, jak přesně sleduje nebo zachovává zdroj, a `control_video_url` může dodat předem vypočítaný řídicí signál. `resolution` nabízí automatické nebo pevné předvolby, například čtverec a portrétní či krajinné 16:9.

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 použitý k řízení generování.
video_urlpovinné video
Typurl · video
URL odkazující na referenční video používané k řízení pohybu a struktury.
control_video_urlvolitelné
Typurl · video
Volitelné předem vypočítané řídicí video, použité místo vestavěného odhadu řízení, pokud je dodáno společně s `skip_control_preprocess`. Po převzorkování na shodné rozměry výstupu a počet snímků se stane přímým řídicím signálem. Video může například obsahovat již vykreslenou kompozici hloubky, hran nebo pózy.
skip_control_preprocessvolitelné
Typboolean
Výchozífalse
Přímý režim řízení používající `control_video_url` místo interního odhadu hloubky, hran nebo pózy; bez této URL se nastavení ignoruje. Rozměry výstupu v tomto režimu respektují explicitní rozměry se zarovnáním na 64, aby RGB a řídicí video zůstaly shodné, zatímco `auto` převezme rozměry zdroje a poměr stran v mezích LTX.
preserve_original_videovolitelné
Typboolean
Výchozífalse
Režim zachování původního videa, dostupný pouze s `skip_control_preprocess`, `video_url` a `control_video_url`. Ve výchozím nastavení je vypnutý a zachovává standardní zpracování řízení; jeho zapnutí zahájí generování z `video_url` při zachování strukturálního vedení z `control_video_url`. Odšumování pomocí `strength` určuje zachované množství; nižší hodnoty zachovají více původních pixelů.
image_urlvolitelné image
Typurl · image
Volitelný styl ukotvení obrázku nebo identita postavy jako klíčový snímek prvního snímku.
mid_image_urlvolitelné
Typurl · image
Volitelný vzhled ukotvení obrázku přibližně uprostřed klipu, doplňující počáteční klíčový snímek `image_url`. Pomáhá vzhledu sledovat pohyb kamery místo postupného odchylování; vyžaduje `image_url`.
end_image_urlvolitelné end_image
Typurl · image
Volitelný vzhled ukotvení obrázku v posledním snímku klipu. Užitečné, když pohyb kamery končí na jiném místě než počáteční obrázek; vyžaduje `image_url`.
video_strengthvolitelné
Typnumber
Výchozí0.6
0 – 1
Volnost změny pohybu a struktury referenčního videa řídí tato síla podmiňování: nižší hodnoty umožňují větší změny.
strengthvolitelné
Typnumber
Výchozí1
0 – 1
Řízení odšumování pro vzorkování převodu referenčního videa na video, jehož účinek závisí na `preserve_original_video`. Když je režim vypnutý, pouze zkracuje plán odšumování; při zapnutí řídí transformaci zdrojových pixelů, přičemž 1.0 vše znovu vygeneruje a nižší hodnoty zachovají více (například 0.5 zachová přibližně 50 %).
num_framesvolitelné
Typinteger
Výchozí121
9 – 481
Počet výstupních snímků podléhající rozpočtu stability IC-LoRA založenému na součinu rozlišení a počtu snímků. Odpověď 422 znamená překročení tohoto rozpočtu: snižte rozlišení nebo `num_frames`. Rozpočet umožňuje přibližně 150 snímků při rozměrech třídy 720p a více při menších velikostech.
resolutionvolitelné
Typobject
Výchozíauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Rozměry výstupního videa, které ovlivňují také stabilní délku: menší velikosti umožňují více snímků, větší snižují maximum. Vestavěný odhad řízení udržuje velikost blízko oficiálního pracovního postupu řízení; přímé řízení pomocí `skip_control_preprocess` a `control_video_url` místo toho respektuje explicitní rozměry se zarovnáním na 64px. V režimu přímého řízení `auto` převezme rozměry zdroje a poměr stran v mezích LTX.
frames_per_secondvolitelné
Typnumber
Výchozí24
1 – 60
Snímková frekvence výstupního videa měřená ve snímcích za sekundu.
num_inference_stepsvolitelné
Typinteger
Výchozí15
8 – 30
Nastavte počet kroků inference, maximálně 30; beze změny se použije 15.
guidance_scalevolitelné
Typnumber
Výchozí1
1 – 20
Upravte vedení bez klasifikátoru pomocí této škály; její výchozí nastavení cílí na vysokou kvalitu i rychlé generování.
generate_audiovolitelné
Typboolean
Výchozítrue
Přepínač zvukové stopy vráceného MP4: vypnuto vytvoří soubor pouze s videem, zapnuto zahrne zvuk.
negative_promptvolitelné
Typstring
Výchozícolor distortion, overexposure, static, blurry details, subtitles, style, artwork, painting, frame, still, dim overall tone, worst quality, low quality, JPEG compression artifacts, ugly, mutilated, extra fingers, poorly drawn hands, poorly drawn face, deformed, disfigured, malformed limbs, fused fingers, motionless frame, cluttered background, three legs, crowded background, walking backwards
Negativní prompt určující, čemu se má generování vyhnout.
seedvolitelné
Typinteger | null
Seed zajišťující reprodukovatelné generování. Nastavení na None vybere seed náhodně.
enable_prompt_expansionvolitelné
Typboolean
Výchozítrue
Určuje, zda je povoleno rozšíření promptu.
enable_safety_checkervolitelné
Typboolean
Výchozítrue
Určuje, zda je povolena kontrola bezpečnosti.
video_qualityvolitelné
Typenum
Výchozíhigh
lowmediumhighmaximum
Předvolba kvality použitá pro výstupní video.
video_write_modevolitelné
Typenum
Výchozíbalanced
fastbalancedsmall
Režim zápisu výsledného videa.
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": "ltx-2.3-quality/reference-video-to-video",
  "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": 270,
    "usd": "0.27",
    "charged": 270,
    "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"
  },
  "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,
    "prompt": "string"
  },
  "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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 vytvořené modelem.
seed
integerSkutečný seed použitý během generování.
prompt
stringPrompt generování včetně případného rozšíření použitého před použitím.

Další modely: Video na video

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