Мазмұнға өту

Ltx 2.3 Quality · Reference Video to Video

Интеграциялау

Модель идентификаторы 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"

Мысалдағыдай файлдар: 0,27 $ 270 API кредиті · ≈ 29,05 ₽ файлдарыңыз іске қосу алдында өлшенеді Осы бетте іске қосу

API кілтін алу
Lightricks Бейнеден бейнеге Кірістірілген аудио

Анықтамалық бейне бағыттайтын, нұсқауға негізделген генерация; бірінші, ортаңғы және соңғы негізгі кадр кескіндері қосымша берілуі мүмкін

Lightricks · Бейне

Алғашқы нәтижеңіз осында пайда болады

Төменде сұрау құрып, оны API кілтіңізбен іске қосыңыз. Шығыстар сақтау орнымызға көшіріліп, мәңгі немесе 7 күн тегін сақталады.

Сұрау жасау

Басқару элементтері модель схемасынан жасалады. Оларды өзгерткен сайын код пен баға жаңартылады.

•міндетті

Генерацияны бағыттайтын нұсқау.

•міндетті video_url
Файлды тастаңыз немесе

Қозғалыс пен құрылымды бағыттау үшін пайдаланылатын сілтемелік бейнеге апаратын URL.

resolution әдепкі auto

Шығыс бейнесінің өлшемдері тұрақты ұзақтыққа да әсер етеді: кіші өлшемдер көбірек кадрға, үлкен өлшемдер азырақ максималды кадр санына мүмкіндік береді. Кірістірілген басқару бағалауы өлшемді ресми басқару жұмыс процесіне жақын ұстайды; `skip_control_preprocess` және `control_video_url` арқылы тікелей басқару оның орнына 64px тураланған нақты өлшемдерді сақтайды. Тікелей басқару режимінде `auto` LTX шектері аясында бастапқы өлшемдер мен арақатынасты алады.

әдепкі 121

Шығыс кадрларының саны; ол ажыратымдылық пен кадрлар көбейтіндісіне негізделген IC-LoRA тұрақтылық бюджетіне бағынады. 422 жауабы бұл бюджеттен асқанын білдіреді: ажыратымдылықты немесе `num_frames` мәнін азайтыңыз. Бюджет 720p класты өлшемдерде шамамен 150 кадрға, ал кіші өлшемдерде одан да көп кадрға мүмкіндік береді.

Қосымша 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
әдепкі color distortion, ove...

Генерацияда болмауы тиіс нәрселерді көрсететін теріс нұсқау.

Файлды тастаңыз немесе

`skip_control_preprocess` параметрімен бірге берілгенде кірістірілген басқару бағалауының орнына пайдаланылатын алдын ала есептелген басқару бейнесі. Шығыс өлшемдері мен кадрлар санына сәйкестендірілген қайта үлгілеуден кейін ол тікелей басқару сигналына айналады. Мысалы, бейнеде алдын ала көрсетілген тереңдік, жиек немесе поза композиті болуы мүмкін.

image_url
Файлды тастаңыз немесе

Бірінші кадрдағы негізгі кадр ретінде пайдаланылатын кескінді бекіту стилі немесе кейіпкер тұлғасы.

Файлды тастаңыз немесе

Клиптің орта тұсындағы кескінді бекіту көрінісі; бастапқы `image_url` негізгі кадрын толықтырады. Ол көріністің ауытқымай, камера қозғалысын қадағалауына көмектеседі; `image_url` қажет.

end_image_url
Файлды тастаңыз немесе

Клиптің соңғы кадрындағы кескінді бекіту көрінісі. Камера қозғалысы бастапқы кескіннен басқа жерде аяқталғанда пайдалы; `image_url` қажет.

video_quality әдепкі high

Шығыс бейнесіне қолданылатын сапа профилі.

video_write_mode әдепкі balanced

Нәтижелік бейнені жазу режимі.

әдепкі 0.6

Сілтемелік бейненің қозғалысы мен құрылымын өзгерту еркіндігін осы шарттау күші басқарады: төмен мәндер көбірек өзгеріске мүмкіндік береді.

әдепкі 1

Сілтемелік бейнеден бейнеге үлгілеуге арналған шуды азайту басқаруы; әсері `preserve_original_video` параметріне байланысты. Бұл режим өшірулі болса, тек шуды азайту кестесін қысқартады; қосулы болса, бастапқы пикселдердің түрленуін басқарады: 1.0 барлығын қайта генерациялайды, ал төмен мәндер көбірек бөлігін сақтайды (мысалы, 0.5 шамамен 50%-ын сақтайды).

әдепкі 24

Секундына кадрмен өлшенетін шығыс бейнесінің кадр жиілігі.

әдепкі 15

30-ға дейін орындалатын inference қадамдарының санын орнатыңыз; өзгеріссіз қалдырылса, 15 қолданылады.

әдепкі 1

Осы шкала арқылы classifier-free бағыттауды реттеңіз; әдепкі баптау жоғары сапа мен жылдам генерацияға бағытталған.

Генерацияны қайта өндіруге мүмкіндік беретін seed. None мәнін орнатсаңыз, seed кездейсоқ таңдалады.

POST /run/ltx-2.3-quality/reference-video-to-video?wait=20 бағасы → 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"

Осы сұрауды іске қосу

Кілтіңіз осы браузерде қалады: ол тек Doitong API-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

Ltx 2.3 Quality · Reference Video to Video туралы

Қажетті `prompt` және қозғалыс пен құрылымды беретін референс `video_url` арқылы жаңа бейне жасайды. Қосымша `image_url`, `mid_image_url` және `end_image_url` бастапқы, ортаңғы және соңғы көріністі бекітеді. `video_strength` және `strength` (екеуі де 0-ден 1-ге дейін) бастапқы бейнені қаншалықты дәл ұстанатынын немесе сақтайтынын басқарады, ал `control_video_url` алдын ала есептелген басқару сигналын бере алады. `resolution` автоматты немесе шаршы және 16:9 портреттік не альбомдық сияқты бекітілген алдын ала орнатылған параметрлерді ұсынады.

Параметрлер

Канондық атауды немесе төл атауды жіберіңіз, екеуін қатар жібермеңіз. Канондық атаулар

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
promptміндетті
Түріstring
Генерацияны бағыттайтын нұсқау.
video_urlміндетті video
Түріurl · video
Қозғалыс пен құрылымды бағыттау үшін пайдаланылатын сілтемелік бейнеге апаратын URL.
control_video_urlміндетті емес
Түріurl · video
`skip_control_preprocess` параметрімен бірге берілгенде кірістірілген басқару бағалауының орнына пайдаланылатын алдын ала есептелген басқару бейнесі. Шығыс өлшемдері мен кадрлар санына сәйкестендірілген қайта үлгілеуден кейін ол тікелей басқару сигналына айналады. Мысалы, бейнеде алдын ала көрсетілген тереңдік, жиек немесе поза композиті болуы мүмкін.
skip_control_preprocessміндетті емес
Түріboolean
Әдепкіfalse
Тереңдікті, жиектерді немесе позаны ішкі бағалаудың орнына `control_video_url` пайдаланатын тікелей басқару режимі; бұл URL берілмесе, параметр еленбейді. Бұл режимде шығыс өлшемдері RGB және басқару бейнелерін сәйкестендіру үшін 64-ке тураланған нақты өлшемдерді сақтайды, ал `auto` LTX шектері аясында бастапқы өлшемдер мен арақатынасты алады.
preserve_original_videoміндетті емес
Түріboolean
Әдепкіfalse
Тек `skip_control_preprocess`, `video_url` және `control_video_url` параметрлерімен қолжетімді бастапқы бейнені сақтау режимі. Әдепкі бойынша өшірулі болғанда стандартты басқару өңдеуін сақтайды; қосылғанда генерацияны `video_url` арқылы бастап, `control_video_url` мәнінен құрылымдық нұсқауды сақтайды. `strength` арқылы шуды азайту сақталатын мөлшерді белгілейді: төмен мәндер бастапқы пикселдерді көбірек сақтайды.
image_urlміндетті емес image
Түріurl · image
Бірінші кадрдағы негізгі кадр ретінде пайдаланылатын кескінді бекіту стилі немесе кейіпкер тұлғасы.
mid_image_urlміндетті емес
Түріurl · image
Клиптің орта тұсындағы кескінді бекіту көрінісі; бастапқы `image_url` негізгі кадрын толықтырады. Ол көріністің ауытқымай, камера қозғалысын қадағалауына көмектеседі; `image_url` қажет.
end_image_urlміндетті емес end_image
Түріurl · image
Клиптің соңғы кадрындағы кескінді бекіту көрінісі. Камера қозғалысы бастапқы кескіннен басқа жерде аяқталғанда пайдалы; `image_url` қажет.
video_strengthміндетті емес
Түріnumber
Әдепкі0.6
0 – 1
Сілтемелік бейненің қозғалысы мен құрылымын өзгерту еркіндігін осы шарттау күші басқарады: төмен мәндер көбірек өзгеріске мүмкіндік береді.
strengthміндетті емес
Түріnumber
Әдепкі1
0 – 1
Сілтемелік бейнеден бейнеге үлгілеуге арналған шуды азайту басқаруы; әсері `preserve_original_video` параметріне байланысты. Бұл режим өшірулі болса, тек шуды азайту кестесін қысқартады; қосулы болса, бастапқы пикселдердің түрленуін басқарады: 1.0 барлығын қайта генерациялайды, ал төмен мәндер көбірек бөлігін сақтайды (мысалы, 0.5 шамамен 50%-ын сақтайды).
num_framesміндетті емес
Түріinteger
Әдепкі121
9 – 481
Шығыс кадрларының саны; ол ажыратымдылық пен кадрлар көбейтіндісіне негізделген IC-LoRA тұрақтылық бюджетіне бағынады. 422 жауабы бұл бюджеттен асқанын білдіреді: ажыратымдылықты немесе `num_frames` мәнін азайтыңыз. Бюджет 720p класты өлшемдерде шамамен 150 кадрға, ал кіші өлшемдерде одан да көп кадрға мүмкіндік береді.
resolutionміндетті емес
Түріobject
Әдепкіauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Шығыс бейнесінің өлшемдері тұрақты ұзақтыққа да әсер етеді: кіші өлшемдер көбірек кадрға, үлкен өлшемдер азырақ максималды кадр санына мүмкіндік береді. Кірістірілген басқару бағалауы өлшемді ресми басқару жұмыс процесіне жақын ұстайды; `skip_control_preprocess` және `control_video_url` арқылы тікелей басқару оның орнына 64px тураланған нақты өлшемдерді сақтайды. Тікелей басқару режимінде `auto` LTX шектері аясында бастапқы өлшемдер мен арақатынасты алады.
frames_per_secondміндетті емес
Түріnumber
Әдепкі24
1 – 60
Секундына кадрмен өлшенетін шығыс бейнесінің кадр жиілігі.
num_inference_stepsміндетті емес
Түріinteger
Әдепкі15
8 – 30
30-ға дейін орындалатын inference қадамдарының санын орнатыңыз; өзгеріссіз қалдырылса, 15 қолданылады.
guidance_scaleміндетті емес
Түріnumber
Әдепкі1
1 – 20
Осы шкала арқылы classifier-free бағыттауды реттеңіз; әдепкі баптау жоғары сапа мен жылдам генерацияға бағытталған.
generate_audioміндетті емес
Түріboolean
Әдепкіtrue
Қайтарылатын MP4 үшін аудио жолы ауыстырғышы: өшірулі болса тек бейне файлы жасалады, қосулы болса аудио қосылады.
negative_promptміндетті емес
Түріstring
Әдепкі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
Генерацияда болмауы тиіс нәрселерді көрсететін теріс нұсқау.
seedміндетті емес
Түріinteger | null
Генерацияны қайта өндіруге мүмкіндік беретін seed. None мәнін орнатсаңыз, seed кездейсоқ таңдалады.
enable_prompt_expansionміндетті емес
Түріboolean
Әдепкіtrue
Нұсқауды кеңейту қосылған-қосылмағанын басқарады.
enable_safety_checkerміндетті емес
Түріboolean
Әдепкіtrue
Қауіпсіздікті тексерудің қосылған-қосылмағанын басқарады.
video_qualityміндетті емес
Түріenum
Әдепкіhigh
lowmediumhighmaximum
Шығыс бейнесіне қолданылатын сапа профилі.
video_write_modeміндетті емес
Түріenum
Әдепкіbalanced
fastbalancedsmall
Нәтижелік бейнені жазу режимі.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың file_url мәнін қабылдайды. Файлдар

Шығыс

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"
  }
}
Файлдарыңыз — таңдауыңызӘр outputs[].url — сақтау орнымыздағы көшірме: мәңгі (әр GB-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
video
object {url, content_type, file_name, file_size}Модель жасаған бейне.
seed
integerГенерация кезінде қолданылған нақты seed мәні.
prompt
stringҚолданар алдында кеңейтілген нұсқаны қамтитын генерация нұсқауы.

Қосымша модельдер: Бейнеден бейнеге

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/ltx-2.3-quality/reference-video-to-video.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt