跳轉到主要內容
POST
/
runwayml
/
v1
/
video_to_video
Generate a video from a video
curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/video_to_video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "videoUri": "https://media.w3.org/2010/05/sintel/trailer.mp4",
  "promptText": "Make the motion feel cinematic.",
  "model": "gen4_aleph",
  "references": [
    {
      "type": "image",
      "uri": "https://res.cloudinary.com/demo/image/upload/dog.jpg"
    }
  ],
  "ratio": "1280:720"
}
'
{
  "id": "12a01a5e-ab55-4aa7-b002-7b873546cf76"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

呼叫前須知

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

任務流程

1

提交來源片段與 Prompt

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

輪詢任務詳細資料

使用 Runway to Get Task Details,直到任務進入終止狀態。
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://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.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
必填

Aspect ratio of the output video, e.g. 1280:720.

contentModeration
object
必填

回應

200 - application/json

success

id
string
必填

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