Kling Video O3 4k Text To Video：透過模型頁面與 API 生成電影感 4K 文字轉影片 | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-video-o3/4K/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Aerial drone shot gliding over a misty mountain valley at sunrise, golden light catching pine forests and a winding river, slow forward push, photoreal 4K detail, soft volumetric haze."
  }'

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": "Aerial drone shot gliding over a misty mountain valley at sunrise, golden light catching pine forests and a winding river, slow forward push, photoreal 4K detail, soft volumetric haze."
    },
    "aspect_ratio": {
      "title": "長寬比（寬:高）",
      "description": "輸出畫面比例。16:9 適合橫式影片，9:16 適合直式社群內容，1:1 適合方形畫面。",
      "type": "string",
      "default": "16:9",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ]
    },
    "duration": {
      "title": "長度（秒）",
      "description": "生成 4K 影片的長度，費用會隨所選長度線性增加。",
      "type": "integer",
      "default": 5,
      "enum": [
        3,
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15
      ]
    },
    "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
    }
  }
}