Kling Video O3 4k Reference To Video：モデルページとAPIで使える参照素材からの4K動画生成 | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-video-o3/4K/reference-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "A young woman in a deep emerald silk gown walks slowly through a sunlit marble corridor, soft golden rim light glancing off her hair, slow tracking shot beside her, shallow depth of field, photoreal 4K 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": "4Kで生成したいシーン、登場人物、動作、カメラワーク、雰囲気を説明してください。",
      "type": "string",
      "default": "A young woman in a deep emerald silk gown walks slowly through a sunlit marble corridor, soft golden rim light glancing off her hair, slow tracking shot beside her, shallow depth of field, photoreal 4K detail."
    },
    "images": {
      "title": "参照画像",
      "description": "被写体、小道具、スタイルを固定する公開画像URLです。参照動画がない場合は最大7枚、参照動画も使う場合は最大4枚まで指定できます。",
      "type": "array",
      "default": [
        "https://playgrounds-storage-public.runcomfy.net/tools/7368/media-files/input-figure1.webp"
      ]
    },
    "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": "生成する4K動画の長さです。料金は選択した長さに比例します。",
      "type": "integer",
      "enum": [
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15
      ],
      "default": 5
    },
    "sound": {
      "title": "音声を生成",
      "description": "有効にすると、4K動画と同時に内容に合う環境音を生成します。参照動画がない場合に限り利用でき、料金は変わりません。",
      "type": "boolean",
      "default": false
    },
    "shot_type": {
      "title": "ショットタイプ",
      "description": "編集モード。範囲を自動判断させる場合はintelligent、プロンプトで手動制御する場合はcustomizeを使用します。",
      "type": "string",
      "enum": [
        "customize",
        "intelligent"
      ],
      "default": "customize"
    },
    "multi_prompt": {
      "title": "マルチプロンプト",
      "description": "シーン転換や展開を導く追加のプロンプト区間です。multi_prompt内の各区間の長さの合計は、動画全体の長さと一致させる必要があります。",
      "type": "array",
      "items": {
        "prompt": {
          "title": "区間プロンプト",
          "description": "シーン転換や展開を導く追加のプロンプト区間です。",
          "type": "string",
          "format": "str"
        },
        "duration": {
          "title": "区間の長さ（秒）",
          "description": "このプロンプト区間の長さ（秒）です。",
          "type": "integer",
          "format": "int_slider_with_range",
          "minimum": 3,
          "maximum": 15,
          "default": 5
        }
      },
      "maxItems": 20,
      "minItems": 0
    }
  }
}