Skip to main content
POST
cURL
Використовуйте aleph2 для редагування вихідного відео за допомогою текстового Prompt. Запит повертає завдання id; отримайте відомості про завдання, щоб отримати готовий результат.

Підготуйте запит

  • Автентифікуйтеся за допомогою ключа API CometAPI.
  • Установіть для model значення aleph2 і вкажіть videoUri для відео тривалістю до 30 секунд.
  • Необов’язково: додайте promptText для опису редагування довжиною від 1 до 1 000 символів. Його також можна не вказувати під час використання ключових кадрів.
  • Замініть приклад URL-адреси медіафайлу доступною HTTPS URL-адресою. Поля медіафайлів також приймають URI даних Base64 із закодованим розміром до 5 МБ.

Додайте зображення-підказки з часовими мітками

Щоб керувати певними моментами, надайте від одного до п’яти об’єктів у keyframes. Кожен об’єкт містить зображення uri і рівно одну позицію: Часова мітка ключового кадру має потрапляти в межі його вікна редагування. Якщо ви використовуєте range, установіть його для кожного ключового кадру. Інакше не вказуйте range для жодного ключового кадру. Не вказуйте keyframes, якщо зображення-підказки не потрібні. Порожній масив або null вважається пропуском.

Виберіть форму та формат кадру

Використовуйте targetAspectRatio, щоб запитати розширення до 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, або 21:9. Вхідне відео та зображення-підказки додаються з полями до цієї форми перед генерацією. Застаріле поле ratio є необов’язковим; для керування співвідношенням сторін використовуйте targetAspectRatio. Якщо outputFormat має значення prores, ви можете встановити для proresProfile значення 422, 4444, 422 Proxy, 422 LT, 422 HQ, або 4444 XQ. Профіль за замовчуванням — 4444. Альфа-канал у 4444 і 4444 XQ є непрозорим. Не вказуйте proresProfile для інших форматів виводу. Для явного seed семплування використовуйте 1 до 4294967295. Не вказуйте seed для випадкового seed; 0 вважається пропуском.

Отримайте результат

Збережіть повернуте id і скористайтеся Отримати завдання Runway щоб отримати статус завдання. Коли status має значення SUCCEEDED, прочитайте URL-адреси результатів із output. Якщо завдання завершується помилкою, перевірте failure і failureCode, якщо вони наявні.

Авторизації

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

Your CometAPI API key.

Тіло

application/json

Aleph 2 video-editing request.

model
enum<string>
обов'язково

Model ID for this request.

Доступні опції:
aleph2
videoUri
обов'язково

Input video to edit, with a maximum duration of 30 seconds. Use an accessible HTTPS URL or a Base64 data URI with an encoded size of up to 5 MB.

Required string length: 13 - 2048
Pattern: ^https://
promptText
string

Optional instruction describing the edit, from 1 to 1,000 characters. Can be omitted when using keyframes.

Required string length: 1 - 1000
keyframes
object[] | null

One to five timed guidance images. Each image uses exactly one of seconds or at. Omit when no guidance images are needed; an empty array or null is treated as omission.

Maximum array length: 5

Guidance image positioned using seconds.

targetAspectRatio
enum<string>

Target aspect ratio for expansion. The input video and keyframes are letterboxed to this shape before generation.

Доступні опції:
16:9,
4:3,
3:2,
1:1,
2:3,
3:4,
9:16,
21:9
ratio
string
застаріло

Deprecated aspect-ratio field. Use targetAspectRatio instead.

seed
integer

Sampling seed. Omit for a random seed; 0 is treated as omission.

Необхідний діапазон: 0 <= x <= 4294967295
outputFormat
enum<string>

Output format: mp4 for H.264 MP4, prores for ProRes MOV, png_sequence for a ZIP of PNG frames, or sdr_rec709_10bit for 10-bit Rec.709 HEVC MP4. Omit for mp4.

Доступні опції:
mp4,
prores,
png_sequence,
sdr_rec709_10bit
proresProfile
enum<string>

ProRes profile. Include only with outputFormat set to prores; omit for 4444. The 4444 and 4444 XQ profiles have an opaque alpha channel.

Доступні опції:
422,
4444,
422 Proxy,
422 LT,
422 HQ,
4444 XQ
contentModeration
object

Content moderation settings. Omit to use the standard settings.

Відповідь

The task was created. Save its id for task retrieval.

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

Task ID for GET /runwayml/v1/tasks/{id}.

status
string

Task state, when returned.

createdAt
string<date-time>

Task submission timestamp, when returned.

output
string<uri>[]

Result URLs, when returned.

failure
string

Failure explanation, when returned.

failureCode
string

Machine-readable failure code, when returned.

estimatedCost
object

Task estimate metadata, when returned.

cost
object

Task cost metadata, when returned.

Останнє оновлення 18 вересня 2026 р.