官方格式
從影片產生影片
使用 CometAPI Runway POST /runwayml/v1/video_to_video 啟動影片轉影片生成任務、設定 X-Runway-Version，並轉換來源片段。
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://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4",
"promptText": "string",
"seed": 4294967295,
"model": "gen4_aleph",
"references": [
{
"type": "image",
"uri": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg"
}
],
"ratio": "1280:720",
"contentModeration": {
"publicFigureThreshold": "auto"
}
}
'{}使用此端點可透過 Runway 的影片轉影片工作流程轉換現有的來源片段。它會啟動非同步任務，而不是立即回傳最終輸出。
呼叫前準備
- 準備符合供應商輸入需求的來源影片
- 為你想使用的功能集加入必要的
X-Runway-Versionheader - 先從一段描述變更內容的簡短 Prompt 開始，而不是完整分鏡腳本
任務流程
輪詢任務詳情
使用 Runway 取得任務詳情，直到任務進入終止狀態。
CometAPI 包裝層說明
CometAPI 保留了 Runway 的非同步任務模型與版本化請求行為，但將驗證與 base URL 處理方式與平台其餘部分統一起來。授權
Bearer token authentication. Use your CometAPI key.
標頭
Runway API version header, for example 2024-11-06.
主體
application/json
HTTPS URL of the source video, or a base64 data URI containing the video.
Text prompt describing the desired output. Maximum 1000 characters.
Random seed for reproducible results. Range: 0–4294967295.
Model variant to use.
Optional reference images to guide generation. Each item must include type (e.g. image) and uri (HTTPS URL).
Show child attributes
Show child attributes
Aspect ratio of the output video, e.g. 1280:720.
Show child attributes
Show child attributes
回應
200 - application/json
success
The response is of type object.
⌘I
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://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4",
"promptText": "string",
"seed": 4294967295,
"model": "gen4_aleph",
"references": [
{
"type": "image",
"uri": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg"
}
],
"ratio": "1280:720",
"contentModeration": {
"publicFigureThreshold": "auto"
}
}
'{}