Kling Video O3 Pro Reference To Video: cineastische Videos mit konsistenter Identität | Modelle und API | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-video-o3/pro/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "The woman in Figure 1 and the man in Figure 2 walk together along a rain-slick Tokyo street at night, slow cinematic tracking shot, neon reflections, shallow depth of field, photoreal detail."
  }'

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

{
  "type": "object",
  "title": "Eingabeschema",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "Beschreiben Sie Szene, Handlung und Kamera. Verweisen Sie über die Position auf einzelne Vorlagen, zum Beispiel: „Die Frau in Abbildung 1 geht mit dem Mann aus Abbildung 2 durch eine neonbeleuchtete Gasse.“",
      "type": "string",
      "default": "The woman in Figure 1 and the man in Figure 2 walk together along a rain-slick Tokyo street at night, slow cinematic tracking shot, neon reflections, shallow depth of field, photoreal detail."
    },
    "video": {
      "title": "URL des Referenzvideos",
      "description": "Optionales Referenzvideo zur Steuerung von Bewegung, Stilübertragung oder Szenenkontinuität. Bei Verwendung gilt der Preis für Generierungen mit Referenzvideo; der Tonaufschlag wird dadurch ersetzt.",
      "type": "string"
    },
    "images": {
      "title": "Referenzbilder",
      "description": "Referenzbilder für Figuren, Requisiten oder Stile. Ohne Referenzvideo sind bis zu 7 Bilder möglich, zusammen mit einem Referenzvideo bis zu 4.",
      "type": "array",
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7365/media-files/input-figure1.webp",
        "https://playgrounds-storage-public.runcomfy.net/tools/7365/media-files/input-figure2.webp"
      ],
      "maxItems": 7,
      "minItems": 0
    },
    "keep_original_sound": {
      "title": "Originalton beibehalten",
      "description": "Wenn ein Referenzvideo verwendet wird, bleibt dessen ursprüngliche Audiospur in der Ausgabe erhalten. Standardmäßig aktiviert.",
      "type": "boolean",
      "default": true
    },
    "sound": {
      "title": "Ton erzeugen",
      "description": "Wenn kein Referenzvideo verwendet wird, kann das Modell passende Umgebungsgeräusche und Effekte erzeugen. Dadurch steigt der Sekundenpreis um etwa 20 %. Standardmäßig deaktiviert.",
      "type": "boolean",
      "default": false
    },
    "aspect_ratio": {
      "title": "Seitenverhältnis (B:H)",
      "description": "Seitenverhältnis der Ausgabe: 16:9 im Querformat, 9:16 für vertikale Social-Media-Inhalte oder 1:1 im Quadrat. Standard: 16:9.",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "16:9"
    },
    "duration": {
      "title": "Dauer (Sekunden)",
      "description": "Länge des generierten Clips in Sekunden (3–15). Standard: 5.",
      "type": "integer",
      "minimum": 3,
      "maximum": 15,
      "default": 5
    },
    "shot_type": {
      "title": "Aufnahmetyp",
      "description": "Bearbeitungsumfang: intelligent bestimmt Tempo und Schnitte automatisch; customize folgt dem Prompt für eine gezielte manuelle Steuerung. Standard: intelligent.",
      "type": "string",
      "enum": [
        "intelligent",
        "customize"
      ],
      "default": "customize"
    },
    "multi_prompt": {
      "title": "Mehrteiliger Prompt",
      "description": "Zusätzliche Prompt-Abschnitte steuern Szenenübergänge und den Verlauf. Die Summe ihrer Dauern muss der gesamten Videodauer entsprechen.",
      "type": "array",
      "items": {
        "prompt": {
          "title": "Prompt",
          "description": "Zusätzlicher Prompt-Abschnitt zur Steuerung eines Szenenübergangs oder des weiteren Verlaufs.",
          "type": "string",
          "format": "str"
        },
        "duration": {
          "title": "Dauer",
          "description": "Dauer dieses Prompt-Abschnitts in Sekunden.",
          "type": "integer",
          "format": "int_slider_with_range",
          "minimum": 3,
          "maximum": 15,
          "default": 5
        }
      },
      "maxItems": 20,
      "minItems": 0
    }
  }
}