Video Character Swap API

Video Character Swap은 분석의 작업 ID, 그 미리보기 이미지에서 고른 위치, 위치별 참고 사진 1~3장을 받아 해당 인물이 교체된 클립을 돌려줍니다. 의상과 체형까지 포함한 인물 전체가 바뀌고, 세트와 카메라 워크, 동선, 원본 오디오 트랙은 촬영된 그대로 남습니다. 넣지 않은 인물에는 손이 가지 않습니다.

Video Character Swap은 두 번의 호출로 끝납니다. 첫 번째 호출은 530초 클립에서 인물을 모두 추적해 인물마다 미리보기 스틸을 정해진 순서로 돌려줍니다. 두 번째 호출에 고른 위치와 위치별 참고 사진 13장을 넘기면, 해당 인물만 교체되고 원본 오디오가 그대로 남은 클립을 받습니다.

Character Swap 동영상 분석 → Character Swap 동영상 편집

누구를 바꿀지는 사용자가 정합니다

이런 종류의 엔드포인트는 대개 어느 인물을 가리켰는지 추측할 수밖에 없습니다. 여기서는 첫 번째 호출이 찾아낸 인물을 번호와 함께 보여 주고, 두 번째 호출은 돌려받은 번호에만 손을 댑니다. 네 사람이 나오는 장면에서 한 명만 교체하고 나머지 셋은 촬영된 그대로 둘 수 있습니다.

목 아래 정보를 함께 넘깁니다

Video Character Swap은 하나가 아니라 두 개가 한 쌍인 엔드포인트입니다. 첫 번째 호출인 video-analyze는 530초 클립 안의 인물을 모두 추적해 인물마다 미리보기 스틸을 정해진 순서로 돌려주며, 클립 길이나 검출 수와 무관하게 요청당 정액으로 청구됩니다. 두 번째 호출인 video-edit에는 그 분석의 작업 ID, 고른 위치, 위치별 참고 사진 13장을 넘깁니다. 돌아오는 것은 원본 오디오 트랙이 살아 있는 클립 한 편이며, 480p 또는 720p 해상도에 따라 영상 초 단위로 청구됩니다. 머리만 바꾸는 head swap과 달리 이쪽은 의상과 체형까지 포함한 인물 전체를 교체하고, 세트와 카메라 워크, 동선은 촬영된 그대로 남깁니다. 추적 데이터 자체는 밖으로 나가지 않으며, 다루는 것은 본인의 작업 ID와 0부터 시작하는 위치 번호뿐입니다.

다시 찍지 않고 캐스팅을 바꾸기

세트도 카메라 워크도 동선도 이미 원하는 대로입니다. 샷 전체를 다시 만들어 룩 개발을 처음부터 하는 대신, 그것을 연기하는 인물만 교체합니다.

동의한 연기자라면 어떤 소재든

영상에 무엇이 담겼든 요청의 형태는 달라지지 않습니다. 동시에 아래 제한에 적힌 권한 요건도 달라지지 않습니다. 형식적인 문구가 아니라 반드시 충족해야 하는 조건입니다.

생성한 시리즈 전체에 같은 캐릭터

어떤 영상 모델로든 클립을 여러 편 생성한 뒤 각각을 분석하고, 같은 캐릭터를 전편에 통과시킵니다. 시리즈 전체가 한 명의 연기자로 읽히게 됩니다.

군중 속에서 한 사람만 교체

여러 사람이 나오는 장면을 분석하고 미리보기를 확인한 뒤 의도한 위치만 돌려보냅니다. 나머지 인물에게는 전혀 손이 가지 않습니다.

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "spicyapi/character-swap-v1/video-edit",
  "input": {
    "analysis_task_id": "example",
    "resolution": "720p",
    "swap_targets": [
      {
        "image_urls": [
          "example"
        ],
        "object_index": 0
      }
    ]
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.