Перейти до основного вмісту
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"
  }
}
'
{}
Використовуйте цей endpoint, щоб трансформувати наявний вихідний кліп за допомогою workflow video-to-video від Runway. Він запускає асинхронну задачу замість того, щоб одразу повертати фінальний результат.

Перш ніж викликати його

  • Підготуйте вихідне відео, яке відповідає вимогам провайдера до вхідних даних
  • Додайте обов’язковий заголовок X-Runway-Version для потрібного вам набору функцій
  • Почніть з одного короткого Prompt, який описує зміну, а не повного storyboard

Потік задачі

1

Надішліть вихідний кліп і prompt

Запустіть задачу через цей endpoint і збережіть повернутий id задачі.
2

Опитуйте деталі задачі

Використовуйте Runway to Get Task Details, доки задача не досягне термінального стану.
3

Збережіть трансформований результат

Завантажте або збережіть готовий asset через ваш стандартний медіапайплайн.

Примітка щодо обгортки CometAPI

CometAPI зберігає асинхронну модель задач Runway і версійовану поведінку запитів, але уніфікує автентифікацію та обробку base URL з рештою платформи.

Авторизації

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

The response is of type object.