Zum Inhalt springen

ID-V2V Relight

Integrieren

Modell-ID 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"

Dateien wie das Beispiel: 1,013 $ 1.013 API-Credits Deine Dateien werden vor der Ausführung gemessen Auf dieser Seite ausführen

API-Schlüssel abrufen
Open model Video zu Video bis zu 720p #relighting#editing#cinematic

Video-Neubeleuchtung, die die Beleuchtung eines neu beleuchteten Referenzbilds über den Clip verteilt

Open model · Video

Dein erstes Ergebnis erscheint hier

Erstelle unten eine Anfrage und führe sie mit deinem API-Schlüssel aus. Ausgaben werden in unseren Speicher kopiert und dauerhaft oder 7 Tage kostenlos aufbewahrt.

Anfrage erstellen

Die Steuerelemente werden aus dem Modellschema generiert. Code und Preis werden aktualisiert, während du sie änderst.

•erforderlich

Prompt zur Beschreibung des gewünschten, neu stilisierten Videos.

•erforderlich video_url
Datei ablegen oder

Bewegungs- und Bildausschnittreferenz für die Generierung, angegeben als URL des Quellvideos.

•erforderlich image_url
Datei ablegen oder

Identitäts- und Stilreferenz für die erneute Videogenerierung, angegeben als URL des neu stilisierten ersten Frames.

resolution Standard 720p

Wählen Sie 720p für eine Ausgabe in 1280×720 oder 720×1280 oder 480p für eine Ausgabe in 832×480 oder 480×832. Die Ausrichtung des Quellvideos bestimmt die verwendeten Abmessungen.

Standard 81

Begrenzen Sie die Anzahl der zu erzeugenden Frames; enthält die Quelle weniger Frames, wird deren Frame-Anzahl zur Obergrenze.

Erweitert num_inference_steps · guidance_scale · vace_scale · seed · enable_safety_checker · keyframes
Standard 30

Steuerung von Clip-Qualität und Geschwindigkeit über die Anzahl der Diffusions-Sampling-Schritte pro Clip: Mehr Schritte verbessern die Qualität, benötigen aber mehr Zeit.

Standard 5

Stärke der klassifikatorfreien Steuerung, die das Verhältnis zwischen Prompt-Treue und Kreativität bestimmt.

Standard 1

Strukturelle Treue zum Quellvideo, angepasst über den VACE-Konditionierungsfaktor.

Zufalls-Seed, der bei der Generierung mehrerer Clips für alle Clips gemeinsam verwendet wird und eine reproduzierbare Generierung ermöglicht.

Optionale Identitätsanker für lange Videos: Geben Sie neu stilisierte Keyframes zusammen mit den Ausgabe-Frame-Indizes an, an denen sie erscheinen müssen.

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

Diese Anfrage ausführen

Dein Schlüssel bleibt in diesem Browser: Er wird nur an die Doitong API gesendet und nur gespeichert (localStorage), wenn du „Merken“ aktivierst. API-Schlüssel abrufen

Über ID-V2V Relight

Ändert die Beleuchtung eines Quellvideos (`video_url`) anhand eines neu beleuchteten ersten Einzelbilds (`image_url`) und eines `prompt`, wobei Szene und Darstellung erhalten bleiben. Bis zu 5 `keyframes` können fixiert werden. Die Auflösung ist 480p oder 720p, `num_frames` reicht von 17 bis 241, und `vace_scale` (0-2) bestimmt, wie stark die Quellstruktur die Ausgabe einschränkt. Es gibt keinen `segmentation_prompt`.

Parameter

Sende entweder den kanonischen Namen oder den nativen Namen, nicht beide. Kanonische Namen

NameTyp StandardZulässig Beschreibung
prompterforderlich
Typstring
Prompt zur Beschreibung des gewünschten, neu stilisierten Videos.
video_urlerforderlich video
Typurl · video
Bewegungs- und Bildausschnittreferenz für die Generierung, angegeben als URL des Quellvideos.
image_urlerforderlich image
Typurl · image
Identitäts- und Stilreferenz für die erneute Videogenerierung, angegeben als URL des neu stilisierten ersten Frames.
keyframesoptional
Typobject[]
≤ 5 Elemente
Optionale Identitätsanker für lange Videos: Geben Sie neu stilisierte Keyframes zusammen mit den Ausgabe-Frame-Indizes an, an denen sie erscheinen müssen.
keyframes[].image_urlerforderlich
Typurl · image
URL eines neu stilisierten Bildes als Identitätsanker in einem langen Video; das Seitenverhältnis des Bildes darf höchstens um 0.1 von dem der Ausgabe abweichen. Das Bild erscheint unverändert bei `frame_index`.
keyframes[].frame_indexerforderlich
Typinteger
≥ 1
Platzieren Sie den Keyframe mit 0-basierter Indizierung an einer Ausgabeposition von mindestens 1 und unterhalb der Gesamtzahl der Ausgabe-Frames. Position 0 ist für den neu stilisierten Startframe aus `image_url` reserviert.
resolutionoptional
Typenum
Standard720p
480p720p
Wählen Sie 720p für eine Ausgabe in 1280×720 oder 720×1280 oder 480p für eine Ausgabe in 832×480 oder 480×832. Die Ausrichtung des Quellvideos bestimmt die verwendeten Abmessungen.
num_framesoptional
Typinteger
Standard81
17 – 241
Begrenzen Sie die Anzahl der zu erzeugenden Frames; enthält die Quelle weniger Frames, wird deren Frame-Anzahl zur Obergrenze.
num_inference_stepsoptional
Typinteger
Standard30
2 – 40
Steuerung von Clip-Qualität und Geschwindigkeit über die Anzahl der Diffusions-Sampling-Schritte pro Clip: Mehr Schritte verbessern die Qualität, benötigen aber mehr Zeit.
guidance_scaleoptional
Typnumber
Standard5
1 – 10
Stärke der klassifikatorfreien Steuerung, die das Verhältnis zwischen Prompt-Treue und Kreativität bestimmt.
vace_scaleoptional
Typnumber
Standard1
0 – 2
Strukturelle Treue zum Quellvideo, angepasst über den VACE-Konditionierungsfaktor.
seedoptional
Typinteger | null
Zufalls-Seed, der bei der Generierung mehrerer Clips für alle Clips gemeinsam verwendet wird und eine reproduzierbare Generierung ermöglicht.
enable_safety_checkeroptional
Typboolean
Standardtrue
Aktiviert Sicherheitsprüfungen für Eingaben und Ausgaben.
erforderlich Kanonischer Name, ebenfalls akzeptiert

Dateiparameter akzeptieren eine öffentliche https://-URL, eine data:-URI bis 10 MB oder die file_url eines Uploads. Dateien

Ausgabe

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"
  }
}
Deine Dateien, deine EntscheidungJede outputs[].url ist eine Kopie in unserem Speicher: dauerhaft aufbewahrt (Abrechnung pro GB-Monat) oder 7 Tage kostenlos – je nach Kontoeinstellung oder ?storage=.
Gleiche Struktur bei jedem Modelltype, url, content_type, width, height und duration – für Bilder, Video und Audio gleichermaßen. output ist das Ergebnisobjekt des Modells.
Ausgabefelder
video
object {url, content_type, file_name, file_size}Durch die Generierung erzeugte Videodatei.
seed
integerWährend der Generierung angewendeter Seed-Wert.

Weitere Modelle: Video zu Video

Für KI-Agenten: Diese Seite ist als Markdown verfügbar unter https://doitong.com/de/developers/models/id-v2v/relight.md. Alle Modelle und Anleitungen: https://doitong.com/developers/llms.txt