Kling V3.0 Pro：在 Playground 和 API 上產生進階文字到影片 | Models and API | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/kling/kling-3.0/pro/text-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "Cinematic multi-shot of a young American couple celebrating their anniversary at a candlelit terrace dinner in Tuscany at golden hour. Wide establishing shot sweeps over rolling vineyard hills, cypress trees casting long shadows, then cuts to a slow dolly-in on a stone terrace where a woman in an ivory linen dress laughs softly while the man in a navy rolled-sleeve shirt pours red wine. Cut to a tender close-up: their hands interlace across the table, candlelight catching her diamond ring, his thumb gently brushing hers. Cut to a profile two-shot as he leans in and whispers; she smiles, eyes glistening, golden light rim-lighting her loose blonde hair. Final shot: a graceful crane pull-back revealing the terrace, the warm villa, and the sun melting into the Tuscan horizon. Distant church bells, light cricket ambience, soft acoustic guitar. Photoreal skin, fabric texture, wine ripples — shot on Arri Alexa 35, anamorphic lenses, shallow depth of field, premium cinematic color grade."
  }'

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": "場景、動作、鏡頭風格和氛圍的文字描述。",
      "type": "string",
      "default": "Cinematic multi-shot of a young American couple celebrating their anniversary at a candlelit terrace dinner in Tuscany at golden hour. Wide establishing shot sweeps over rolling vineyard hills, cypress trees casting long shadows, then cuts to a slow dolly-in on a stone terrace where a woman in an ivory linen dress laughs softly while the man in a navy rolled-sleeve shirt pours red wine. Cut to a tender close-up: their hands interlace across the table, candlelight catching her diamond ring, his thumb gently brushing hers. Cut to a profile two-shot as he leans in and whispers; she smiles, eyes glistening, golden light rim-lighting her loose blonde hair. Final shot: a graceful crane pull-back revealing the terrace, the warm villa, and the sun melting into the Tuscan horizon. Distant church bells, light cricket ambience, soft acoustic guitar. Photoreal skin, fabric texture, wine ripples — shot on Arri Alexa 35, anamorphic lenses, shallow depth of field, premium cinematic color grade."
    },
    "negative_prompt": {
      "title": "否定提示",
      "description": "要從影片中排除的元素。",
      "type": "string"
    },
    "duration": {
      "title": "時長",
      "description": "影片長度以秒為單位。",
      "type": "integer",
      "minimum": 3,
      "maximum": 15,
      "default": 5
    },
    "aspect_ratio": {
      "title": "縱橫比",
      "description": "產生視訊的輸出比例。",
      "type": "string",
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "default": "16:9"
    },
    "cfg_scale": {
      "title": "CFG規模",
      "description": "及時引導力量。",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 0.5
    },
    "sound": {
      "title": "聲音",
      "description": "與視訊一起產生同步聲音。",
      "type": "boolean",
      "default": true
    },
    "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
    },
    "shot_type": {
      "title": "鏡頭類型",
      "description": "編輯模式：智慧（默認，自動確定範圍）或自訂。",
      "type": "string",
      "enum": [
        "customize"
      ],
      "default": "customize"
    }
  }
}