Skip to main content
POST
cURL
使用此端點可透過 Runway 的影片轉影片工作流程轉換既有的來源片段。它會啟動非同步任務,而不是立即回傳最終輸出。

呼叫之前

  • 準備符合供應商輸入需求的來源影片
  • 加入所需的 X-Runway-Version 標頭,以使用你想要的功能集
  • 先從一個描述變更的簡短 Prompt 開始,而不是完整分鏡腳本

輸出比例

此端點預期使用以冒號分隔的 ratio 值。對於 1280x720 輸出,請使用 1280:720;對於 720x1280,請使用 720:1280;並非所有 Runway 影片轉影片路由都接受 1280x720

任務流程

1

提交來源片段與 Prompt

從此端點啟動任務,並儲存回傳的 task id。
2

輪詢任務詳細資訊

使用 取得 Runway 任務,直到任務進入終止狀態。
3

儲存轉換結果

透過你的一般媒體處理流程下載或保存完成的資產。

授權

Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

標頭

X-Runway-Version
string
必填

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

主體

application/json
videoUri
string
預設值:https://your-video-host/source.mp4
必填

HTTPS URL of the source video, or a base64 data URI containing the video.

promptText
string
預設值:A cat yawning in slow motion.
必填

Text prompt describing the desired output. Maximum 1000 characters.

seed
integer
預設值:1
必填

Random seed for reproducible results. Range: 0–4294967295.

model
string
預設值:gen4_aleph
必填

Model variant to use.

references
object[]
必填

Optional reference images to guide generation. Each item must include type (e.g. image) and uri (HTTPS URL).

ratio
string
預設值:1280:720
必填

Requested output frame shape. Use colon-separated values such as 1280:720 or 720:1280; read them as 1280x720 and 720x1280 targets. Do not assume every Runway video-to-video route accepts 1280x720 with an x separator.

contentModeration
object
必填

回應

200 - application/json

success

id
string
必填

The ID of the task that was created. Use this to retrieve the task later.