Runway Aleph 2：上下文影片到影片編輯 | Models and API | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/runwayml/runway-aleph-2/video-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "video_url": "https://playgrounds-storage-public.runcomfy.net/tools/7460/media-files/input.mp4",
    "prompt": "Restyle as 2D anime with clean cel-shaded linework and warm evening colors; keep the musician, saxophone, and camera framing."
  }'

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": [
    "video_url",
    "prompt"
  ],
  "properties": {
    "video_url": {
      "title": "影片 URL",
      "description": "待編輯的來源影片。須為 2-30 秒且不超過 16 MB。輸出時長跟隨該片段。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7460/media-files/input.mp4",
      "validations": [
        {
          "validation_rule": "file_size_mb<",
          "validation_value": 16,
          "validation_error": "File size must be less than 16 MB."
        }
      ]
    },
    "prompt": {
      "title": "提示詞",
      "description": "描述編輯內容的自然語言指令。請控制在 1000 個字元以內。",
      "type": "string",
      "default": "Restyle as 2D anime with clean cel-shaded linework and warm evening colors; keep the musician, saxophone, and camera framing."
    },
    "keyframes": {
      "title": "關鍵幀",
      "description": "可選引導圖，最多 5 張。每項需要圖片 URL 以及相對來源片段起始的秒級時間戳。",
      "type": "array",
      "maxItems": 5,
      "minItems": 0,
      "items": {
        "image_url": {
          "title": "圖片 URL",
          "description": "該時間戳的引導圖（HTTPS URL）。",
          "type": "string",
          "format": "image_uri",
          "default": ""
        },
        "seconds": {
          "title": "時間戳（秒）",
          "description": "相對來源影片起始的絕對時間戳，單位為秒（0-30）。",
          "type": "number",
          "format": "float_slider_with_range",
          "minimum": 0,
          "maximum": 30,
          "default": 0
        }
      }
    },
    "target_aspect_ratio": {
      "title": "目標寬高比",
      "description": "可選的擴展／外擴比例。不設定則保持來源畫面比例。",
      "type": "string",
      "enum": [
        "16:9",
        "4:3",
        "3:2",
        "1:1",
        "2:3",
        "3:4",
        "9:16",
        "21:9"
      ]
    },
    "seed": {
      "title": "Seed",
      "description": "可選 Seed，便於更可重現的重試。不設定則隨機抽取。",
      "type": "integer",
      "minimum": 0,
      "maximum": 4294967295
    }
  }
}