Przejdź do treści

Luma Ray 3.2 Video to Video

Integracja

Identyfikator modelu luma/agent/ray/v3.2/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/luma/agent/ray/v3.2/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"

To żądanie: 0,72 $ 720 kredytów API · ≈ 77,27 ₽ Uruchom na tej stronie

Uzyskaj klucz API
Luma AI Wideo na wideo Synchronizacja ruchu ust5–10 sdo 1080p #stylized#transform#lipsync

Edycja wideo Ray 3.2, która zmienia styl materiału źródłowego za pomocą ustawień siły edycji, elementów sterujących i klatek kluczowych

Luma AI · Wideo

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

•wymagane 88 / 6000

Instrukcje tekstowe dotyczące edycji wideo źródłowego.

•wymagane video_url
Upuść plik lub

URL edytowanego wideo.

duration 5 s

Długość wideo po edycji.

resolution domyślnie 540p

Rozdzielczość wyniku po edycji.

Zaawansowane image · user · edit_strength · auto_controls · enable_safety_checker · keyframes · controls · keyframe_indexes
start_image_url
Upuść plik lub

Nadpisanie pierwszej klatki edytowanego wideo, podane jako opcjonalny URL obrazu; po pominięciu model wyznacza tę klatkę na podstawie wideo źródłowego. Na przykład dostarczenie przestylizowanego obrazu otwierającego ze źródła może wpłynąć na wygląd edycji.

Opcjonalny nieprzezroczysty identyfikator użytkownika końcowego wysyłającego żądanie.

Ustawienie zachowania źródła podczas edycji, dostępne tylko wtedy, gdy auto_controls nie jest używane; pominięcie wybiera wartość domyślną modelu. Od największego odejścia do najściślejszego zachowania opcje to 'reimagine_*', 'flex_*' dla zrównoważonego wyniku oraz 'adhere_*'.

Wskazówki edycji z wieloma klatkami kluczowymi podane jako URL obrazów zamiast start_image_url. Podaj keyframes wraz z tablicą keyframe_indexes o tej samej długości, aby przypisać każdy obraz do pozycji jego klatki w wideo źródłowym; dozwolone jest najwyżej 64 URL-i.

Precyzyjna alternatywa dla edit_strength, konfigurująca warunkowanie osobno dla pozy, głębi, normalnych, trajektorii i twarzy. Użycie tych ustawień wyklucza auto_controls.

Mapowanie klatek źródłowych połączone jeden do jednego z keyframes: element [i] określa pozycję kotwicy dla keyframes[i]. Obie tablice muszą mieć taką samą długość, a pozycje muszą być różne i nieujemne.

POST /run/luma/agent/ray/v3.2/video-to-video?wait=20 wycena → 0,72 $
# 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/luma/agent/ray/v3.2/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"

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

Informacje o Luma Ray 3.2 Video to Video

Edytuje `video_url` zgodnie z `prompt`, opcjonalnie używając `start_image_url` do sterowania pierwszą klatką. `edit_strength` oferuje poziomy adhere, flex i reimagine od 1 do 3, a `auto_controls` lub obiekt `controls` zapewniają alternatywne warunkowanie. Maksymalnie 64 `keyframes` można zakotwiczyć za pomocą `keyframe_indexes`. Wynik ma od 540p do 1080p i długość 5s lub 10s, z opcjonalnymi `hdr` i `exr_export`.

Parametry

Wyślij nazwę kanoniczną albo natywną, nie obie. Nazwy kanoniczne

NazwaTyp DomyślneDozwolone Opis
promptwymagane
Typstring
≤ 6000 znaków
Instrukcje tekstowe dotyczące edycji wideo źródłowego.
video_urlwymagane video
Typurl · video
URL edytowanego wideo.
useropcjonalne
Typstring | null
Opcjonalny nieprzezroczysty identyfikator użytkownika końcowego wysyłającego żądanie.
start_image_urlopcjonalne image
Typurl · image
Nadpisanie pierwszej klatki edytowanego wideo, podane jako opcjonalny URL obrazu; po pominięciu model wyznacza tę klatkę na podstawie wideo źródłowego. Na przykład dostarczenie przestylizowanego obrazu otwierającego ze źródła może wpłynąć na wygląd edycji.
resolutionopcjonalne
Typenum
Domyślne540p
540p720p1080p
Rozdzielczość wyniku po edycji.
durationopcjonalne
Typenum
Domyślne5s
5s10s
Długość wideo po edycji.
edit_strengthopcjonalne
Typenum
adhere_1adhere_2adhere_3flex_1flex_2flex_3reimagine_1reimagine_2reimagine_3
Ustawienie zachowania źródła podczas edycji, dostępne tylko wtedy, gdy auto_controls nie jest używane; pominięcie wybiera wartość domyślną modelu. Od największego odejścia do najściślejszego zachowania opcje to 'reimagine_*', 'flex_*' dla zrównoważonego wyniku oraz 'adhere_*'.
auto_controlsopcjonalne
Typboolean
Domyślnefalse
Automatyczne warunkowanie edycji: model używa wideo źródłowego do określenia harmonogramu zamiast przyjmować edit_strength wraz z tą opcją.
hdropcjonalne
Typboolean
Domyślnefalse
Kodowanie HDR dla wyniku MP4 w 720p lub 1080p, dostępne tylko dla kont z dostępem HDR.
exr_exportopcjonalne
Typboolean
Domyślnefalse
Dodatkowy eksport EXR dołączany do MP4, dostępny tylko przy jednoczesnym dostępie HDR i hdr=true.
controlsopcjonalne
Typobject
Precyzyjna alternatywa dla edit_strength, konfigurująca warunkowanie osobno dla pozy, głębi, normalnych, trajektorii i twarzy. Użycie tych ustawień wyklucza auto_controls.
controls.poseopcjonalne
Typobject
Warunkowanie oparte na pozie lub szkielecie.
controls.pose.enabledopcjonalne
Typboolean
Domyślnetrue
Przełącznik warunkowania pozą lub szkieletem podczas edycji.
controls.pose.strengthopcjonalne
Typenum
precisecoarse
Wybór dokładności warunkowania pozą: pomiń, aby zachować wartość domyślną, wybierz 'coarse' dla większej swobody lub użyj 'precise', aby ściśle śledzić pozę źródłową.
controls.depthopcjonalne
Typobject
Warunkowanie oparte na głębi lub geometrii sceny.
controls.depth.enabledopcjonalne
Typboolean
Domyślnetrue
Przełącznik warunkowania głębią lub geometrią sceny podczas edycji.
controls.depth.bluropcjonalne
Typnumber | null
0 – 1
Ustawienie rozmycia głębi, pozostawiane nieokreślone w celu zachowania wartości domyślnej lub zwiększane, aby zapewnić geometrii większą swobodę.
controls.normalsopcjonalne
Typobject
Warunkowanie oparte na normalnych powierzchni.
controls.normals.enabledopcjonalne
Typboolean
Domyślnetrue
Przełącznik warunkowania normalnymi powierzchni podczas edycji.
controls.normals.augmentationopcjonalne
Typnumber | null
0 – 1
Ustawienie rozszerzania normalnych powierzchni; pomiń, aby zachować wartość domyślną, lub zwiększ, aby umożliwić większą reinterpretację geometrii powierzchni.
controls.trajectoryopcjonalne
Typobject
Warunkowanie oparte na trajektoriach ruchu.
controls.trajectory.enabledopcjonalne
Typboolean
Domyślnetrue
Przełącznik warunkowania trajektorią ruchu podczas edycji.
controls.trajectory.sparsityopcjonalne
Typnumber | null
0 – 1
Ustawienie rzadkości trajektorii ruchu; pomiń, aby zachować wartość domyślną, lub zwiększ, aby zmniejszyć liczbę używanych kotwic ruchu.
controls.faceopcjonalne
Typobject
Warunkowanie oparte na tożsamości twarzy.
controls.face.enabledopcjonalne
Typboolean
Domyślnetrue
Przełącznik warunkowania tożsamością twarzy podczas edycji.
keyframesopcjonalne
Typstring[]
≤ 64 elementy
Wskazówki edycji z wieloma klatkami kluczowymi podane jako URL obrazów zamiast start_image_url. Podaj keyframes wraz z tablicą keyframe_indexes o tej samej długości, aby przypisać każdy obraz do pozycji jego klatki w wideo źródłowym; dozwolone jest najwyżej 64 URL-i.
keyframe_indexesopcjonalne
Typinteger[]
≤ 64 elementy
Mapowanie klatek źródłowych połączone jeden do jednego z keyframes: element [i] określa pozycję kotwicy dla keyframes[i]. Obie tablice muszą mieć taką samą długość, a pozycje muszą być różne i nieujemne.
enable_safety_checkeropcjonalne
Typboolean
Domyślnetrue
Filtrowanie można złagodzić, ustawiając false, jeśli wywołujący ma odpowiednie uprawnienia.
wymagane Nazwa kanoniczna, również akceptowana

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "luma/agent/ray/v3.2/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": 720,
    "usd": "0.72",
    "charged": 720,
    "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
    },
    "exr_file": {
      "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
    }
  },
  "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"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
video
object {url, content_type, file_name, file_size}Wideo utworzone przez model.
exr_file
object {url, content_type, file_name, file_size} | nullPlik dodatkowy EXR w formie eksportowanej przez Luma: pojedynczy plik EXR albo archiwum ZIP. Jest generowany, gdy exr_export ma wartość true.

Więcej modeli: Wideo na wideo

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/luma/agent/ray/v3.2/video-to-video.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt