소개
인물 사진 한 장을 받아 가장 닮은 연예인의 생성 이미지를 돌려줍니다. 프롬프트도 파라미터도 없으며 사진이 입력의 전부입니다.
요청은 이미지 URL 하나이며 요청 단위로 과금합니다. 엔터테인먼트와 소셜 제품을 위한 한 번 호출로 끝나는 기능이며, 신원 확인 도구가 아닙니다.
핵심 기능 및 하이라이트
사진 한 장을 보내면 한 장이 돌아옵니다. 그 밖에 보낼 것은 없습니다
요청 전체가 이미지 URL 하나입니다. 프롬프트도, seed도, 크기도, 강도도 없으므로 결과를 움직이는 것은 올린 사진뿐입니다. 제출한 뒤 작업을 폴링해 이미지를 받으며, 이 카탈로그의 다른 미디어 호출과 같은 방식입니다. 요청당 가격은 이미지에 누가 나오든 같습니다.
이름도 점수도 아닌 생성 이미지
응답에는 이미지 한 장만 들어 있습니다. 연예인 이름도, 후보 순위도, 닮은 정도의 퍼센트도 없습니다. 이미지 옆에 놓이는 것은 여러분이 쓴 문구이지 모델의 주장이 아니며, 그쪽이 더 안전합니다. 경험은 이미지 자체를 중심으로 만드십시오. 보여 주고, 공유하게 하되, 옆에 숫자를 붙이는 것은 피하십시오.
써도 되는지 판단할 때는 얼굴 인식처럼 다루십시오
입력은 언제나 실존 인물의 얼굴입니다. 그래서 이 엔드포인트는 이 카탈로그의 다른 어떤 것도 해당하지 않는 초상과 생체 정보 규칙의 적용을 받습니다. 생체 정보는 유럽연합과 미국 일부 지역에서 별도로 규제되며, 그곳의 동의 기준은 높을 수 있습니다. 사진 속 본인이 알고 동의한 사진만 보내십시오. 공인의 사진이나 다른 곳에서 가져온 이미지는 절대 쓰지 마시고, 신원 확인, 인증, 감시, 얼굴 데이터베이스 구축에도 절대 쓰지 마십시오. 돌아오는 것은 실존 인물에 대한 사실 진술이 아닙니다. 업로드한 원본 이미지는 하루 뒤, 생성된 결과는 14일 뒤에 삭제됩니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 선명하고 대체로 정면인 인물 사진 한 장으로, 얼굴 하나만 또렷하게 보여야 합니다. 단체 사진, 측면, 선글라스, 흔들림이 일치도를 떨어뜨리거나 호출을 실패시키는 지점입니다. 1자 이상 |
요금
$0.05 / 요청
원하지 않은 결과가 나와도 완료된 요청으로 과금됩니다.
활용 사례
업로드 한 번, 공유할 이미지 한 장
제품 경험이 사진 한 장을 올리고 생성된 이미지 한 장을 공유하는 것이라면 이 엔드포인트를 쓰십시오. 인물 사진을 image_url로 보내고, 작업을 폴링한 뒤, 돌아온 이미지를 보여 주면 됩니다. 옆에 표시할 이름이나 점수는 없습니다.
엔터테인먼트와 소셜 기능
‘나는 어떤 연예인을 닮았을까’라는 상호작용을 사진 업로드 뒤의 API 호출 한 번으로 구현합니다. 제작 도구가 아니라 소비자 앱 안에서 공유되는 순간을 위한 기능입니다.
캠페인 장치
마케팅 흐름에 넣는 가벼운 상호작용 단계입니다. 셀카를 올리면 공유할 이미지가 돌아옵니다. 참여자당 호출 한 번이라 비용도 예측할 수 있습니다.
사진 앱과 뷰티 앱
기존 인물 사진 도구 옆에 두는 재미 기능입니다. 프롬프트 작업도 파라미터도 필요 없으므로 폼 필드 하나로 앱에 넣을 수 있습니다.
프롬프트 가이드 및 실전 팁
판정이 아니라 이미지를 기대하십시오
엔드포인트는 생성된 이미지를 돌려줄 뿐 이름, 순위, 닮은 정도 점수를 주지 않습니다. 제품에 라벨이 필요하다면 이미지 자체를 보여 줘야 합니다. API가 주는 다른 표시거리는 없습니다.
선명한 정면 인물 사진을 보내십시오
조명이 잘 든 얼굴 하나가 대체로 카메라를 향하고 화면에서 적당한 비중을 차지해야 합니다. 단체 사진, 옆모습에 가까운 각도, 선글라스, 흔들림, 아주 작은 얼굴에서는 닮은 정도가 떨어지거나 호출이 아예 실패합니다.
반복하기 전에 결과 확인하기
이미지 한 장에 얼굴 하나, 대체로 정면이고 조명이 분명해야 합니다. 옆모습 각도, 가림(선글라스, 손, 얼굴을 덮은 머리카락), 흔들림, 아주 작은 얼굴은 닮은 정도를 떨어뜨리거나 호출을 실패하게 만듭니다. 프롬프트도 마스크도 강도도 seed도 없으므로, 결과가 틀렸다면 유일한 방법은 다른 사진입니다. 응답은 이미지뿐이며 이름도 순위도 신뢰도 값도 없습니다.
API 빠른 시작
# 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/look-alike-v1/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# 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 레퍼런스에서 확인하세요.