메인 콘텐츠로 건너뛰기
POST
cURL
소스 비디오를 업스케일하려면 magnific_video_upscaler_creative를 사용합니다. 요청은 완료된 출력을 검색하는 데 사용할 작업 id를 반환합니다.

요청 준비

  • CometAPI API 키로 인증합니다.
  • model를 magnific_video_upscaler_creative로 설정하고 videoUri를 제공하여 최대 30초 길이의 비디오를 지정합니다.
  • 예시 비디오 URL을 액세스 가능한 HTTPS URL로 바꿉니다. videoUri는 인코딩 크기가 최대 5MB인 Base64 비디오 데이터 URI도 허용합니다.
  • resolution로 720p, 1k, 2k 또는 4k 중 하나를 선택합니다. 2k의 경우 필드를 생략합니다.

향상 설정 조정

모델 기본값을 사용하려면 숫자 제어 값을 생략합니다. 0 값은 생략으로 처리되므로 강도 0을 명시적으로 선택하지 않습니다. 마찬가지로, fpsBoost: false 생략으로 처리되며 프레임 속도 향상을 명시적으로 비활성화하지 않습니다. 선택적 필드를 생략하고 null를 전송하지 마세요.

결과 검색

반환된 id를 저장하고 Runway 작업 가져오기 를 사용하여 작업 상태를 검색합니다. status가 SUCCEEDED이면 output에서 결과 URL을 읽습니다. 작업이 실패하면 failure 및 failureCode가 있는지 확인합니다.

인증

Authorization
string
header
필수

Your CometAPI API key.

본문

application/json

Magnific video-upscaling request.

model
enum<string>
필수

Model ID for this request.

사용 가능한 옵션:
magnific_video_upscaler_creative
videoUri
필수

Video to upscale, 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://
resolution
enum<string>

Target output resolution. Omit for 2k.

사용 가능한 옵션:
720p,
1k,
2k,
4k
creativity
integer

Amount of generated detail to add. Use 1 through 100 for an explicit setting. Omit to use the model default; 0 is treated as omission.

필수 범위: 0 <= x <= 100
sharpen
integer

Sharpness intensity. Use 1 through 100 for an explicit setting. Omit to use the model default; 0 is treated as omission.

필수 범위: 0 <= x <= 100
smartGrain
integer

Grain and texture enhancement intensity. Use 1 through 100 for an explicit setting. Omit to use the model default; 0 is treated as omission.

필수 범위: 0 <= x <= 100
flavor
enum<string>

Processing style: vivid emphasizes color and detail; natural favors faithful reproduction.

사용 가능한 옵션:
vivid,
natural
fpsBoost
boolean

Set true to request an increased output frame rate. Omit to leave this option unspecified; false is treated as omission.

응답

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