Przejdź do treści

ID-V2V Relight

Integracja

Identyfikator modelu id-v2v/relight
# 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/relight?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"

Pliki takie jak przykład: 1,013 $ 1013 kredytów API Twoje pliki są mierzone przed uruchomieniem Uruchom na tej stronie

Uzyskaj klucz API
Open model Wideo na wideo do 720p #relighting#editing#cinematic

Zmiana oświetlenia wideo, która rozprowadza oświetlenie zmienionej klatki referencyjnej po całym klipie

Open model · 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

Prompt określający żądane przestylizowane wideo.

•wymagane video_url
Upuść plik lub

Referencja ruchu i kadrowania do generowania, podawana jako adres URL wideo źródłowego.

•wymagane image_url
Upuść plik lub

Referencja tożsamości i stylu do ponownego generowania wideo, podawana jako adres URL wskazujący pierwszy przestylizowany kadr.

resolution domyślnie 720p

Wybierz 720p dla wyniku 1280×720 lub 720×1280 albo 480p dla wyniku 832×480 lub 480×832. Orientacja wideo źródłowego określa, które wymiary mają zastosowanie.

domyślnie 81

Ogranicz liczbę generowanych klatek; jeśli źródło zawiera ich mniej, jego liczba klatek staje się górnym limitem.

Zaawansowane num_inference_steps · guidance_scale · vace_scale · seed · enable_safety_checker · keyframes
domyślnie 30

Kontrola jakości i szybkości klipu wyrażona liczbą kroków próbkowania dyfuzyjnego dla każdego klipu: większa liczba kroków poprawia jakość, ale wydłuża działanie.

domyślnie 5

Siła classifier-free guidance, równoważąca zgodność z promptem i kreatywność.

domyślnie 1

Zgodność strukturalna z wideo źródłowym, regulowana za pomocą skali uwarunkowania VACE.

Losowe ziarno współdzielone przez wszystkie klipy podczas generowania wielu klipów, umożliwiające powtarzalne generowanie.

Opcjonalne kotwice tożsamości dla długich wideo: podaj przestylizowane klatki kluczowe wraz z indeksami klatek wyniku, w których mają się pojawić.

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

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 ID-V2V Relight

Zmienia oświetlenie źródłowego wideo (`video_url`) za pomocą ponownie oświetlonej pierwszej klatki (`image_url`) i `prompt`, zachowując scenę oraz wydajność. Można przypiąć maksymalnie 5 `keyframes`. Rozdzielczość wynosi 480p lub 720p, `num_frames` mieści się w zakresie 17–241, a `vace_scale` (0–2) określa, jak ściśle struktura źródłowa ogranicza wynik. Nie udostępnia promptu segmentacji.

Parametry

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

NazwaTyp DomyślneDozwolone Opis
promptwymagane
Typstring
Prompt określający żądane przestylizowane wideo.
video_urlwymagane video
Typurl · video
Referencja ruchu i kadrowania do generowania, podawana jako adres URL wideo źródłowego.
image_urlwymagane image
Typurl · image
Referencja tożsamości i stylu do ponownego generowania wideo, podawana jako adres URL wskazujący pierwszy przestylizowany kadr.
keyframesopcjonalne
Typobject[]
≤ 5 elementów
Opcjonalne kotwice tożsamości dla długich wideo: podaj przestylizowane klatki kluczowe wraz z indeksami klatek wyniku, w których mają się pojawić.
keyframes[].image_urlwymagane
Typurl · image
Adres URL przestylizowanego obrazu dla kotwicy tożsamości w długim wideo; proporcje obrazu mogą różnić się od wyniku najwyżej o 0.1. Obraz pojawia się bez zmian przy `frame_index`.
keyframes[].frame_indexwymagane
Typinteger
≥ 1
Umieść klatkę kluczową na pozycji wyniku co najmniej 1 i mniejszej niż całkowita liczba klatek wyniku, używając indeksowania od 0. Pozycja 0 jest zarezerwowana dla przestylizowanej klatki początkowej z `image_url`.
resolutionopcjonalne
Typenum
Domyślne720p
480p720p
Wybierz 720p dla wyniku 1280×720 lub 720×1280 albo 480p dla wyniku 832×480 lub 480×832. Orientacja wideo źródłowego określa, które wymiary mają zastosowanie.
num_framesopcjonalne
Typinteger
Domyślne81
17 – 241
Ogranicz liczbę generowanych klatek; jeśli źródło zawiera ich mniej, jego liczba klatek staje się górnym limitem.
num_inference_stepsopcjonalne
Typinteger
Domyślne30
2 – 40
Kontrola jakości i szybkości klipu wyrażona liczbą kroków próbkowania dyfuzyjnego dla każdego klipu: większa liczba kroków poprawia jakość, ale wydłuża działanie.
guidance_scaleopcjonalne
Typnumber
Domyślne5
1 – 10
Siła classifier-free guidance, równoważąca zgodność z promptem i kreatywność.
vace_scaleopcjonalne
Typnumber
Domyślne1
0 – 2
Zgodność strukturalna z wideo źródłowym, regulowana za pomocą skali uwarunkowania VACE.
seedopcjonalne
Typinteger | null
Losowe ziarno współdzielone przez wszystkie klipy podczas generowania wielu klipów, umożliwiające powtarzalne generowanie.
enable_safety_checkeropcjonalne
Typboolean
Domyślnetrue
Włącza kontrole bezpieczeństwa zarówno dla danych wejściowych, jak i wyników.
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": "id-v2v/relight",
  "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"
  }
}
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}Plik wideo utworzony podczas generowania.
seed
integerWartość ziarna stosowana podczas generowania.

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/id-v2v/relight.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt