Image sang Video

Sử dụng CometAPI để gọi image_to_video của Runway và chuyển đổi URL hình ảnh tĩnh thành đầu ra video thô, với hỗ trợ X-Runway-Version để tương thích.

POST /runwayml/v1/image_to_video

Create a Runway image-to-video task

cURL

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"
}
'

200

{
  "id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}

Sử dụng endpoint này để tạo chuyển động cho một ảnh nguồn thành video Runway.

​

Trước khi gọi

• Gửi header X-Runway-Version bắt buộc, ví dụ 2024-11-06
• Sử dụng model: gen3a_turbo
• Cung cấp promptImage HTTPS ổn định
• Bắt đầu với duration: 5 và tỷ lệ phổ biến như 1280:720

​

Luồng tác vụ

1. Gửi yêu cầu image-to-video

   Tạo tác vụ với một ảnh nguồn và prompt chuyển động ngắn tùy chọn.

2. Lưu id được trả về

   Lưu id của tác vụ để polling sau.

3. Polling trạng thái tác vụ

   Sử dụng Get Task Details. Nếu lần polling đầu tiên trả về task_not_exist, hãy đợi vài giây rồi thử lại.

Việc xác thực trực tiếp vào ngày 2026-03-13 đã xác nhận rằng một yêu cầu gen3a_turbo tối thiểu đã được chấp nhận và trả về một id. Sau một khoảng trễ ngắn, cả task-details chính thức và feed đảo ngược đều trả về cùng một trạng thái queued được bao bọc cho tác vụ đó.

Ủy quyền

Authorization · string · header · bắt buộc

Bearer token authentication. Use your CometAPI key.

Tiêu đề

X-Runway-Version · string · bắt buộc

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

Nội dung

application/json

promptImage · string · mặc định: https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg · bắt buộc

Source image URL.

model · string · mặc định: gen3a_turbo · bắt buộc

Runway image-to-video model ID. Choose a current model from the Models page.

seed · integer

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

promptText · string

Text prompt describing the desired motion or scene. Maximum 512 characters.

watermark · boolean · mặc định: false

Whether to add a watermark to the output video.

duration · integer · mặc định: 5

Video duration in seconds. Accepted values: 5 or 10.

ratio · enum<string> · mặc định: 1280:720

Aspect ratio of the output video.

Tùy chọn có sẵn: 1280:720, 720:1280, 1104:832, 832:1104, 960:960, 1584:672, 1280:768, 768:1280

Phản hồi

200 - application/json

Task accepted.

id · string · bắt buộc