跳轉到主要內容
POST
/
runwayml
/
v1
/
video_upscale
Create a Runway video-upscale task
curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/video_upscale \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "videoUri": "https://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4",
  "model": "upscale_v1"
}
'
{
  "id": "<string>"
}
使用此端點可為既有的影片資產啟動 Runway 放大任務。

呼叫前須知

  • 傳送必要的 X-Runway-Version header,例如 2024-11-06
  • 使用 model: upscale_v1
  • 提供穩定的 HTTPS videoUri
  • 預期會進行 4 倍放大,且最長邊尺寸上限為 4096 像素

任務流程

1

提交來源影片

使用來源片段的 URL 建立放大任務。
2

儲存任務 id

保存回傳的 id,以便稍後檢查狀態。
3

輪詢直到完成

使用 取得任務詳情,直到任務完成,且提供者中繼資料顯示最終輸出。

適用情境

  • 在最終剪輯輸出獲得核准之後
  • 當你需要較高解析度的交付資產,而不是較快速的預覽時

授權

Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

標頭

X-Runway-Version
string
必填

Runway version header, for example 2024-11-06.

主體

application/json
videoUri
string
預設值:https://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4
必填

A HTTPS URL pointing to a video or a data URI containing a video.

model
string
預設值:upscale_v1
必填

The model variant to use. Must be upscale_v1.

回應

200 - application/json

Task accepted.

id
string
必填