캐릭터 제어

CometAPI와 Runway Control a character API를 사용해 참조 비디오에서 캐릭터 퍼포먼스 작업을 시작하고, 얼굴 표정과 몸 동작을 구동합니다.

POST /runwayml/v1/character_performance

Create a Runway character-performance task

cURL

curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/character_performance \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "character": {
    "type": "video",
    "uri": "https://filesystem.site/cdn/20250818/wAKbHUoj5EHyqZvEdJbFXn10wXBMUn.mp4"
  },
  "reference": {
    "type": "video",
    "uri": "https://filesystem.site/cdn/20250818/wAKbHUoj5EHyqZvEdJbFXn10wXBMUn.mp4"
  },
  "bodyControl": true,
  "expressionIntensity": 3,
  "seed": 4294967295,
  "model": "act_two",
  "ratio": "1280:720",
  "contentModeration": {
    "publicFigureThreshold": "auto"
  }
}
'

200

{
  "id": "<string>"
}

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

​

호출 전에 확인할 사항

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

​

작업 흐름

1. 캐릭터 퍼포먼스 요청 제출

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

2. 반환된 task id 저장

   나중에 폴링할 때 필요하므로 반환된 id를 보관하세요.

3. 작업 상태 폴링

   래퍼가 최종 상태에 도달하고 provider 메타데이터에 완료된 출력이 포함될 때까지 Get Task Details를 계속 호출하세요.

​

입력 역할

• 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.

Show child attributes

reference · object · 필수

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

Show child attributes

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 · 필수

Aspect ratio of the output video, e.g. 1280:720.

contentModeration · object · 필수

Show child attributes

응답

200 - application/json

Task accepted.

id · string · 필수