Video Head Swap API

Video Head Swap은 분석의 작업 ID, 그 미리보기 이미지에서 고른 위치, 위치별 참고 사진 1~3장을 받아 해당 머리가 교체된 클립을 돌려줍니다. 머리카락과 두상, 인물 자체는 바뀌지만 몸과 의상, 움직임, 화각, 원본 오디오 트랙은 촬영된 그대로 남습니다. 넣지 않은 머리에는 손이 가지 않습니다.

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

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

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

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

영상과 해상도를 두 번 모두 같게 유지합니다

Video Head Swap은 하나가 아니라 두 개가 한 쌍인 엔드포인트입니다. 첫 번째 호출인 video-analyze는 530초 클립 안의 머리를 모두 추적해 머리마다 미리보기 스틸을 정해진 순서로 돌려주며, 클립 길이나 검출 수와 무관하게 요청당 정액으로 청구됩니다. 두 번째 호출인 video-edit에는 그 분석의 작업 ID, 고른 위치, 위치별 참고 사진 13장을 넘깁니다. 돌아오는 것은 원본 오디오 트랙이 살아 있는 클립 한 편이며, 480p 또는 720p 해상도에 따라 영상 초 단위로 청구됩니다. 추적 데이터 자체는 밖으로 나가지 않습니다. 다루는 것은 본인의 작업 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/head-swap-video-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 레퍼런스에서 확인하세요.