메인 콘텐츠로 건너뛰기
POST
cURL
act_two을 사용하여 참조 동영상의 퍼포먼스를 캐릭터 이미지나 동영상에 적용합니다. 요청은 완성된 출력을 가져오기 위한 작업 id을 반환합니다.

에셋 준비

  • CometAPI API 키로 인증합니다.
  • model를 act_two로 설정합니다.
  • character.type를 image 또는 video로 제공하고 에셋은 character.uri에 포함합니다. 식별 가능한 얼굴이 보이도록 하고 프레임 안에 유지하세요.
  • reference.type은 video로 제공하고, 3~30초 길이의 퍼포먼스 클립을 reference.uri에 지정합니다.
  • 예시 미디어 URL을 액세스 가능한 HTTPS URL로 바꾸세요. 미디어 필드는 인코딩된 크기가 최대 5MB인 Base64 데이터 URI도 허용합니다.

퍼포먼스 구성

model, character 및 reference만 필수입니다. bodyControl: false 는 생략으로 처리되므로 신체 제어를 명시적으로 비활성화하지 않습니다. seed 또는 expressionIntensity의 값이 0인 경우도 생략으로 처리됩니다. 선택적 필드는 null을 전송하지 말고 생략하세요. 선택 사항인 ratio 값은 1280:720, 720:1280, 960:960, 1104:832, 832:1104, 또는 1584:672입니다.

결과 가져오기

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

인증

Authorization
string
header
필수

Your CometAPI API key.

본문

application/json

Act-Two character-performance request.

model
enum<string>
필수

Model ID for this request.

사용 가능한 옵션:
act_two
character
object
필수

Character image or video to animate. Keep a recognizable face visible and inside the frame.

reference
object
필수

Reference video containing the performance to apply. The video must be 3 to 30 seconds long.

bodyControl
boolean

Set true to request body movements and gestures in addition to facial expressions. Omit to leave this option unspecified; false is treated as omission.

expressionIntensity
integer

Expression intensity from 1 through 5. Higher values request stronger expressions. Omit for 3; 0 is treated as omission.

필수 범위: 0 <= x <= 5
seed
integer

Sampling seed. Omit for a random seed; 0 is treated as omission.

필수 범위: 0 <= x <= 4294967295
ratio
enum<string>

Optional requested frame dimensions.

사용 가능한 옵션:
1280:720,
720:1280,
960:960,
1104:832,
832:1104,
1584:672
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월 21일