官方格式
圖片轉影片
使用 CometAPI 呼叫 Runway 的 image_to_video，將靜態圖片 URL 轉換為原始影片輸出，並支援 X-Runway-Version 以維持相容性。
POST
/
runwayml
/
v1
/
image_to_video
Create a Runway image-to-video task
curl --request POST \
--url https://api.cometapi.com/runwayml/v1/image_to_video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Runway-Version: <x-runway-version>' \
--data '
{
"promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
"model": "gen3a_turbo"
}
'{
"id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}使用此端點可將單一來源圖片製作成 Runway 影片動畫。
呼叫前準備
- 傳送必要的
X-Runway-Version標頭，例如2024-11-06 - 使用
model: gen3a_turbo - 提供穩定的 HTTPS
promptImage - 建議從
duration: 5和常見比例（例如1280:720）開始
任務流程
輪詢任務狀態
使用 取得任務詳細資訊。如果第一次輪詢回傳
task_not_exist，請等待幾秒後重試。於 2026-03-13 的即時驗證確認，最小化的
gen3a_turbo 請求已被接受並回傳 id。在短暫延遲後，官方 task-details 與反向 feed 都為該任務回傳了相同的包裝 queued 狀態。授權
Bearer token authentication. Use your CometAPI key.
標頭
Runway version header, for example 2024-11-06.
主體
application/json
promptImage
string
預設值:https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg
必填
Source image URL.
Runway image-to-video model ID. Choose a current model from the Models page.
Random seed for reproducible results. Range: 0–999999999.
Text prompt describing the desired motion or scene. Maximum 512 characters.
Whether to add a watermark to the output video.
Video duration in seconds. Accepted values: 5 or 10.
Aspect ratio of the output video.
可用選項:
1280:720, 720:1280, 1104:832, 832:1104, 960:960, 1584:672, 1280:768, 768:1280 回應
200 - application/json
Task accepted.
⌘I
Create a Runway image-to-video task
curl --request POST \
--url https://api.cometapi.com/runwayml/v1/image_to_video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Runway-Version: <x-runway-version>' \
--data '
{
"promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
"model": "gen3a_turbo"
}
'{
"id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}