Skip to main content
POST
cURL
Використовуйте цей endpoint, щоб анімувати одне вихідне зображення у відео Runway.

Перед викликом

  • Надішліть обов’язковий заголовок X-Runway-Version, наприклад 2024-11-06
  • Використовуйте model: gen3a_turbo
  • Надайте стабільний HTTPS promptImage
  • Почніть із duration: 5 і підтримуваного значення ratio для вибраної моделі/версії Runway

Duration і ratio

Запити Runway в official-format використовують ratio, а не size. Інтерпретуйте значення ratio у форматі роздільної здатності як їхній еквівалент WxH: 1280:720 відповідає 1280x720, 720:1280720x1280, а 1280:768 усе ще може рендеритися як 1280x720 залежно від вибраної моделі/версії.

Потік завдання

1

Надішліть запит image-to-video

Створіть завдання з вихідним зображенням і необов’язковим коротким Prompt для руху.
2

Збережіть повернений id

Збережіть id завдання для подальшого опитування.
3

Опитуйте статус завдання

Використовуйте Отримати завдання Runway. Якщо перше опитування повертає task_not_exist, зачекайте кілька секунд і повторіть спробу.

Авторизації

Authorization
string
header
обов'язково

Bearer token authentication. Use your CometAPI key.

Заголовки

X-Runway-Version
string
обов'язково

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.

model
string
за замовчуванням:gen3a_turbo
обов'язково

Runway image-to-video model ID. Choose an available 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
за замовчуванням:false

Whether to add a watermark to the output video.

duration
integer
за замовчуванням:5

Video duration in seconds. Runway support is model/version dependent; use 5 or 10 for the broadest compatibility. CometAPI forwards this value to Runway.

ratio
string
за замовчуванням:1280:768

Requested output ratio. Accepted values are Runway model/version dependent. With X-Runway-Version 2024-11-06, use a resolution-style value accepted by the selected model, such as 1280:768, 768:1280, 1280:720, or 720:1280. Read these as WxH targets, but completed media may normalize, so inspect the returned file before relying on exact pixels.

Відповідь

200 - application/json

Task accepted.

id
string
обов'язково