Kling Video O3 Standard Reference to Video: Character-Consistent Video Generation on Models and API | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-video-o3/standard/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 stroll along a Parisian boulevard at night, glowing classic street lamps and softly lit Haussmann-style facades behind them, slow tracking shot, cinematic warm lighting, 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": "modelApiDoc_navInputSchema",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "Describe the scene and action. Refer to references by position, e.g. 'The man in Figure 2 walks with the woman in Figure 1 through a sunlit park.'",
      "type": "string",
      "default": "The woman in Figure 1 and the man in Figure 2 stroll along a Parisian boulevard at night, glowing classic street lamps and softly lit Haussmann-style facades behind them, slow tracking shot, cinematic warm lighting, photoreal detail."
    },
    "images": {
      "title": "Reference Images",
      "description": "Reference images of characters, props, or styles. Up to 7 without a reference video, or up to 4 when a reference video is provided.",
      "type": "array",
      "maxItems": 7,
      "minItems": 0,
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7361/media-files/refs/ref_woman_euro.png",
        "https://playgrounds-storage-public.runcomfy.net/tools/7361/media-files/refs/ref_man_euro.png"
      ]
    },
    "video": {
      "title": "Reference Video URL",
      "description": "Optional reference video for motion guidance, style transfer, or scene continuity. When provided, billing switches to the with-reference-video tier.",
      "type": "string"
    },
    "aspect_ratio": {
      "title": "Aspect Ratio (W:H)",
      "description": "Output frame ratio. 16:9 for landscape, 9:16 for vertical social, 1:1 for square.",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "16:9"
    },
    "duration": {
      "title": "Duration (seconds)",
      "description": "Length of the generated clip in seconds (3-15).",
      "type": "integer",
      "minimum": 3,
      "maximum": 15,
      "default": 5
    },
    "sound": {
      "title": "Generate Sound",
      "description": "When enabled, synthesize synchronized audio with the video. Adds ~33% to the per-second cost (no effect when a reference video is provided).",
      "type": "boolean",
      "default": false
    },
    "keep_original_sound": {
      "title": "Keep Original Sound",
      "description": "When a reference video is provided, retain its original audio track in the generated output.",
      "type": "boolean",
      "default": true
    },
    "shot_type": {
      "title": "Shot Type",
      "description": "Editing scope. Use intelligent for auto-decided pacing and cuts, or customize for prompt-driven manual control.",
      "type": "string",
      "enum": [
        "customize",
        "intelligent"
      ],
      "default": "customize"
    }
  }
}