메인 콘텐츠로 건너뛰기
POST
cURL
aleph2을 사용하여 텍스트 프롬프트(Prompt)로 소스 비디오를 편집합니다. 요청은 작업 ID id을 반환합니다. 완료된 출력을 가져오려면 작업 세부 정보를 조회하세요.

요청 준비

  • CometAPI API 키로 인증하세요.
  • model을 aleph2로 설정하고, 최대 30초 길이의 비디오에 대해 videoUri을 제공하세요.
  • 선택 사항: 편집 내용을 설명하는 promptText을 포함하세요. 길이는 1~1,000 자여야 합니다. 키프레임을 사용하는 경우 생략할 수도 있습니다.
  • 예시 미디어 URL을 액세스 가능한 HTTPS URL로 바꾸세요. 미디어 필드는 인코딩된 크기가 최대 5MB인 Base64 데이터 URI도 허용합니다.

시간 지정 가이드 이미지 추가

특정 시점을 안내하려면 keyframes에 객체를 1개에서 5개까지 제공하세요. 각 객체는 이미지 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은 다른 출력 형식에서는 생략하세요. 명시적인 샘플링 시드를 지정하려면 1부터 4294967295까지를 사용하세요. seed은 무작위 시드에 대해 생략하세요. 0은 생략한 것으로 처리됩니다.

결과 가져오기

반환된 id을 저장하고 Runway 작업 가져오기 를 사용하여 작업 상태를 조회하세요. status이 SUCCEEDED인 경우, output에서 결과 URL을 읽으세요. 작업이 실패하면, 제공되는 경우 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.

마지막 수정일 2026년 9월 22일