Przejdź do treści

Lightx · Relight

Integracja

Identyfikator modelu lightx/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/lightx/relight?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

Uzyskaj klucz API
Open model Wideo na wideo Dane referencyjne #video-to-video

Ponowne oświetlanie filmu sterowane promptem, klatką referencyjną, obrazem HDR lub obrazem tła

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.

Opcjonalny prompt tekstowy; Light-X automatycznie opisuje wideo, gdy prompt nie zostanie podany.

•wymagane video_url
Upuść plik lub

URL wejściowego wideo.

Zaawansowane relit_cond_type · relit_cond_img_url · ref_id · seed · enable_safety_checker · relight_parameters
relit_cond_type domyślnie ic

Typ warunku używanego do zmiany oświetlenia.

URL obrazu warunkującego wymagany przez ustawienia 'ref', 'hdr' i 'bg' parametru relight_condition_type; w trybie 'bg' dostarcza tło.

domyślnie 0

Referencja zmiany oświetlenia wybrana według indeksu klatki, przy czym liczba wygenerowanych klatek stanowi wyłączną górną granicę. Domyślnie ta liczba wynosi 49.

Ziarno zapewniające powtarzalność generowania. Ustawienie None wybiera ziarno losowo.

Ustawienia zmiany oświetlenia, których użycie zależy od relight_condition_type: 'ic' ich wymaga, natomiast 'bg' je ignoruje i wymaga URL obrazu tła.

POST /run/lightx/relight?wait=20 wycena → 0,49 $
# 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/lightx/relight?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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.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 Lightx · Relight

Zmienia oświetlenie wejściowego filmu. `relit_cond_type` wybiera warunek: ic (używa `relight_parameters`), ref, hdr lub bg, przy czym trzy ostatnie wymagają obrazu warunkującego w `relit_cond_img_url`. `ref_id` (od 0 do 48) wybiera klatkę referencyjną dla trybu ref. Tekstowy `prompt` jest opcjonalny, a gdy go brakuje, film otrzymuje automatyczny opis.

Parametry

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

NazwaTyp DomyślneDozwolone Opis
video_urlwymagane video
Typurl · video
URL wejściowego wideo.
promptopcjonalne
Typstring | null
Opcjonalny prompt tekstowy; Light-X automatycznie opisuje wideo, gdy prompt nie zostanie podany.
seedopcjonalne
Typinteger | null
Ziarno zapewniające powtarzalność generowania. Ustawienie None wybiera ziarno losowo.
relit_cond_typeopcjonalne
Typenum
Domyślneic
icrefhdrbg
Typ warunku używanego do zmiany oświetlenia.
relight_parametersopcjonalne
Typobject
Ustawienia zmiany oświetlenia, których użycie zależy od relight_condition_type: 'ic' ich wymaga, natomiast 'bg' je ignoruje i wymaga URL obrazu tła.
relight_parameters.relight_promptwymagane
Typstring
Prompt tekstowy określający warunki oświetlenia do uzyskania.
relight_parameters.bg_sourceopcjonalne
Typenum
DomyślneLeft
LeftRightTopBottom
Kierunek źródła światła dla IC-light.
relight_parameters.cfgopcjonalne
Typnumber
Domyślne2
1 – 10
Skala classifier-free guidance stosowana podczas zmiany oświetlenia.
relight_parameters.use_sky_maskopcjonalne
Typboolean
Domyślnefalse
Przełącznik maskowania nieba dla scen plenerowych.
relit_cond_img_urlopcjonalne
Typstring | null
URL obrazu warunkującego wymagany przez ustawienia 'ref', 'hdr' i 'bg' parametru relight_condition_type; w trybie 'bg' dostarcza tło.
ref_idopcjonalne
Typinteger
Domyślne0
0 – 48
Referencja zmiany oświetlenia wybrana według indeksu klatki, przy czym liczba wygenerowanych klatek stanowi wyłączną górną granicę. Domyślnie ta liczba wynosi 49.
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": "lightx/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": 490,
    "usd": "0.49",
    "charged": 490,
    "refunded": 0
  },
  "input": {
    "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,
    "input_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
    },
    "viz_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
    }
  },
  "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.
input_video
object {url, content_type, file_name, file_size} | nullZnormalizowane lub przetworzone wideo wejściowe, opcjonalnie zwracane, gdy potok je wygeneruje.
viz_video
object {url, content_type, file_name, file_size} | nullWideo wizualizacyjne lub debugowania, opcjonalnie zwracane, gdy potok je wygeneruje.

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