메인 콘텐츠로 건너뛰기
POST
cURL
gen4.5을 사용하여 텍스트 프롬프트로 동영상을 생성합니다. CometAPI API 키를 Bearer 인증 및 JSON 요청 본문과 함께 전송합니다.

요청 준비

  • model를 gen4.5로 설정합니다.
  • UTF-16 코드 단위 1~1,000개를 사용하여 promptText에 장면과 움직임을 설명합니다.
  • 가로 방향에는 ratio를 1280:720로, 세로 방향에는 720:1280로 설정합니다.
  • duration을 2초부터 10초까지의 정수로 설정합니다.
네 필드는 모두 필수입니다. 이미지에서 시작하려면 Runway 이미지-동영상 작업 생성. 이 텍스트-동영상 요청에는 promptImage 또는 audio 토글을 포함하지 마세요.

선택적 제어 설정

명시적으로 샘플링 시드를 지정하려면 1부터 4294967295까지 사용합니다. 이를 생략하거나 0로 설정하면 무작위 시드가 선택됩니다. contentModeration을 포함하는 경우 해당 publicFigureThreshold 를 auto 또는 low로 설정하고, 그렇지 않으면 객체를 생략합니다. outputFormat을 사용하여 MP4, ProRes, PNG 시퀀스 또는 HDR 형식 중 하나를 선택합니다. H.264 MP4의 경우 생략합니다. 다음을 설정할 수 있는 경우는 proresProfile 은 outputFormat가 prores 또는 hdr_prores일 때뿐입니다. HDR ProRes 형식은 422, 422 HQ 또는 4444을 지원합니다.

결과 가져오기

반환된 id을 저장한 다음 Runway 작업 가져오기. status가 SUCCEEDED이면 output의 동영상 URL을 읽습니다.

인증

Authorization
string
header
필수

Use your CometAPI API key.

본문

application/json

Request parameters for gen4.5.

model
enum<string>
필수

Model ID for this request variant.

사용 가능한 옵션:
gen4.5
Allowed value: "gen4.5"
promptText
string
필수

Describe the requested scene or motion in 1 to 1,000 UTF-16 code units.

Required string length: 1 - 1000
ratio
enum<string>
필수

Requested output dimensions, expressed as width:height. Choose a value listed for this model and endpoint.

사용 가능한 옵션:
1280:720,
720:1280
duration
integer
필수

Requested video duration in whole seconds, from 2 through 10.

필수 범위: 2 <= x <= 10
seed
integer

Optional sampling seed. Use a positive integer for an explicit seed. Omission or 0 selects a random seed.

필수 범위: 0 <= x <= 4294967295
contentModeration
object

Optional content moderation settings. Omit the object to use standard moderation.

outputFormat
enum<string>

Output encoding. Omit for mp4 (H.264). prores returns MOV; png_sequence returns a PNG ZIP; sdr_rec709_10bit returns 10-bit Rec.709 HEVC. hdr10 and hlg return 10-bit HDR MP4; hdr_pq_12bit_master returns 12-bit HEVC MOV; hdr_prores returns HDR ProRes MOV. The HDR PNG/EXR sequence formats return ZIP archives; the ACEScg variants target the named ACES version.

사용 가능한 옵션:
mp4,
prores,
png_sequence,
hdr10,
hlg,
sdr_rec709_10bit,
hdr_pq_12bit_master,
hdr_prores,
hdr_png_sequence,
hdr_exr_sequence,
hdr_exr_acescg_sequence_1_3,
hdr_exr_acescg_sequence_2_0
proresProfile
enum<string>

Profile for outputFormat prores or hdr_prores. Omit for 4444 with prores, or 422 HQ with hdr_prores. hdr_prores accepts only 422, 422 HQ, or 4444. Omit this field for other formats.

사용 가능한 옵션:
422,
4444,
422 Proxy,
422 LT,
422 HQ,
4444 XQ

응답

Task submitted. Save its id to retrieve task status.

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월 21일