Skip to main content
POST
cURL
이 엔드포인트를 사용하면 참조 클립의 퍼포먼스를 캐릭터 이미지 또는 캐릭터 비디오에 전이할 수 있습니다.

호출 전에 확인할 사항

  • 필수 X-Runway-Version 헤더를 전송하세요. 예: 2024-11-06
  • model: act_two를 사용하세요
  • 접근 가능한 HTTPS URL로 character asset 1개와 reference asset 1개를 제공하세요
  • 스타일을 조정하기 전에 bodyControl: true와 중간 정도의 expressionIntensity로 시작하세요

출력 비율

작업 흐름

1

캐릭터 퍼포먼스 요청 제출

캐릭터 asset, 참조 asset, 모션 설정으로 작업을 생성합니다.
2

반환된 task id 저장

이후 폴링에 필요하므로 반환된 id를 보관하세요.
3

작업 상태 폴링

작업이 최종 상태에 도달하고 provider 메타데이터에 완료된 출력이 포함될 때까지 Runway 작업 가져오기를 계속 진행하세요.

입력 역할

  • character는 애니메이션을 적용할 대상입니다
  • reference는 표정 퍼포먼스 또는 신체 움직임을 제공하는 소스 클립입니다
  • bodyControl은 모션 전이가 표정 전이와 함께 신체 움직임까지 포함할지 결정합니다
  • contentModeration은 요청에 provider의 moderation 임계값을 적용합니다

인증

Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

헤더

X-Runway-Version
string
필수

Runway version header, for example 2024-11-06.

본문

application/json
character
object
필수

The character to control. You can either provide a video or an image.

reference
object
필수

Reference performance clip. Provide type (video) and uri (HTTPS URL).

bodyControl
boolean
기본값:true
필수

Enable body control.

expressionIntensity
integer
기본값:1
필수

Intensity of the expression transfer. Higher values produce more exaggerated expressions.

seed
integer
기본값:1
필수

Random seed for reproducible results.

model
string
기본값:act_two
필수

The model variant to use. Must be act_two.

ratio
string
기본값:1280:720
필수

Requested output frame shape, for example 1280:720 or 720:1280. Keep the character and reference assets close to the requested frame shape.

contentModeration
object
필수

응답

200 - application/json

Task accepted.

id
string
필수