Kling Video O3 Standard Reference to Video：モデルページと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": "入力スキーマ",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "title": "プロンプト",
      "description": "シーンと動作を説明し、参照素材を位置で示してください。例：'Figure 2の男性がFigure 1の女性と日差しのある公園を歩く。'",
      "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": "参照画像",
      "description": "キャラクター、小道具、スタイルの参照画像です。参照動画がない場合は最大7枚、参照動画がある場合は最大4枚まで使えます。",
      "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": "参照動画のURL",
      "description": "動き、スタイル転写、シーンの連続性に使う任意の参照動画です。指定すると参照動画ありの料金に切り替わります。",
      "type": "string"
    },
    "aspect_ratio": {
      "title": "アスペクト比（幅：高さ）",
      "description": "出力のアスペクト比です。横長は16:9、縦型SNSは9:16、正方形は1:1です。",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "16:9"
    },
    "duration": {
      "title": "長さ（秒）",
      "description": "生成する動画の長さ（3～15秒）です。",
      "type": "integer",
      "minimum": 3,
      "maximum": 15,
      "default": 5
    },
    "sound": {
      "title": "音声を生成",
      "description": "有効にすると同期音声を合成します。1秒あたりの料金が約33%加算されます（参照動画を指定した場合は影響しません）。",
      "type": "boolean",
      "default": false
    },
    "keep_original_sound": {
      "title": "元の音声を保持",
      "description": "参照動画を指定した場合、その元音声を生成結果に残します。",
      "type": "boolean",
      "default": true
    },
    "shot_type": {
      "title": "ショットタイプ",
      "description": "編集範囲。テンポとカットを自動判断させる場合はintelligent、プロンプトで手動制御する場合はcustomizeを使用します。",
      "type": "string",
      "enum": [
        "customize",
        "intelligent"
      ],
      "default": "customize"
    }
  }
}