Runway 이미지-비디오 작업 생성
Gen-4.5 또는 Gen-4 Turbo로 소스 이미지에 애니메이션을 적용하고 결과를 Runway 작업으로 가져옵니다.
{
"id": "00000000-0000-4000-8000-000000000001"
}{
"code": "<string>",
"message": "<string>",
"data": "<unknown>"
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}모델 선택
| 모델 | 필수 필드 | 동작 프롬프트(Prompt) |
|---|---|---|
gen4.5 | model, promptImage, promptText, ratio, duration | 동작을 다음에서 설명하세요 promptText. |
gen4_turbo | model, promptImage, ratio | promptText에서 동작을 선택적으로 설명하며, 1~1,000개의 UTF-16 코드 단위를 사용하세요. |
첫 번째 프레임 제공
promptImage을(를) 액세스 가능한 HTTPS 이미지 URL 또는 Base64 이미지 데이터 URI로 설정하세요.
uri 및 position: "first"을(를) 포함하는 항목 하나짜리 배열을 제공할 수도 있습니다.
이 인터페이스는 시작 프레임 하나를 허용하므로 마지막 프레임 항목을 추가하지 마세요.
HTTPS 이미지는 리디렉션 없이 직접 액세스할 수 있어야 하며 유효한
이미지 콘텐츠 헤더를 가져야 합니다. 인코딩된 이미지 데이터 URI는 최대 5MB까지 사용할 수 있습니다. 이미지 형식 및 크기는 다음을 참조하세요
Runway 미디어 입력 요구 사항
을(를) 참조하세요.
길이 및 크기 설정
duration에는 2초부터 10초 사이의 정수를 사용하세요. 이는 필수
gen4.5에서는 필수이고 gen4_turbo에서는 선택 사항입니다.
ratio을(를) 1280:720, 720:1280, 1104:832, 960:960, 832:1104 또는
1584:672으로 설정하세요. 이 값들은 콜론으로 구분된 너비와 높이 값입니다.
명시적 샘플링 시드에는 1부터 4294967295까지를 사용하세요. 생략하거나 0을(를) 지정하면
무작위 시드가 선택됩니다. contentModeration을(를) 포함하는 경우 해당
publicFigureThreshold 값을 auto 또는 low로 설정하고, 그렇지 않으면 객체를 생략하세요.
출력 형식 선택
gen4.5 은(는) MP4, ProRes, PNG 시퀀스 및 HDR에 대해 outputFormat을(를) 허용하며
요청 스키마에 나열된 형식을 지원합니다. H.264 MP4의 경우 필드를 생략하세요.
proresProfile 은(는) prores 및 hdr_prores에만 적용되며, 허용되는 값은
선택한 형식에 따라 달라집니다. gen4_turbo에서는 두 필드를 모두 생략하세요.
결과 가져오기
반환된id을(를) 저장하고 다음을 사용하세요 Runway 작업 가져오기.
status이(가) SUCCEEDED이면 output에서 결과 URL을 읽으세요.인증
Use your CometAPI API key.
본문
- gen4.5
- gen4_turbo
Request parameters for gen4.5.
Model ID for this request variant.
gen4.5 "gen4.5"Describe the requested scene or motion in 1 to 1,000 UTF-16 code units.
1 - 1000Image to use as the first frame. Supply a media URI or a one-item array with position set to first.
2048^https://Requested output dimensions, expressed as width:height. Choose a value listed for this model and endpoint.
1280:720, 720:1280, 1104:832, 960:960, 832:1104, 1584:672 Requested video duration in whole seconds, from 2 through 10.
2 <= x <= 10Optional sampling seed. Use a positive integer for an explicit seed. Omission or 0 selects a random seed.
0 <= x <= 4294967295Optional content moderation settings. Omit the object to use standard moderation.
Show child attributes
Show child attributes
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 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.
Task ID for GET /runwayml/v1/tasks/{id}.
Task state, when returned.
Task submission timestamp, when returned.
Result URLs, when returned.
Failure explanation, when returned.
Machine-readable failure code, when returned.
Task estimate metadata, when returned.
Show child attributes
Show child attributes
Task cost metadata, when returned.
Show child attributes
Show child attributes
{
"id": "00000000-0000-4000-8000-000000000001"
}{
"code": "<string>",
"message": "<string>",
"data": "<unknown>"
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}