단비에서 제공하는 얼굴컬렉션에 얼굴사진 추가하기 API 입니다.
API 설명
단비에서 제공하는 얼굴컬렉션에 얼굴사진 추가하기 API 입니다.
요금제는 Starter 이상부터 사용가능합니다. (무료)
해당 API 는 Amazon Rekognition의 indexFaces 에서 제공하는 api를 활용하였습니다.
API 주소
POST https://openapi.danbee.ai/openapis/knowledge/awsRekog/face/create/:knowledgeId
API 입력값 유형
form_data
API 입력값
| KEY | TYPE | Required | VALUE | Default |
|---|---|---|---|---|
| file | File | No | 얼굴사진 파일 | |
| faceBinary | String | No | 캡처한 얼굴사진. Base64로 인코딩한 값 | |
| faceName | String | Yes | 얼굴사진 이름 | |
| accessKey | String | Yes | 얼굴사진 콜렉션만든 후 자동발급된 키 | |
| description | String | No | 사진설명 |
예시 1) 얼굴 이미지파일 업로드 하는 경우
"file" : 영희.jpg,
"faceName" : "영희",
"accessKey" : "cWuDsBp3kULamzR4HMdddd"
예시 2) 얼굴 캡쳐한 사진 업로드 하는 경우
"faceBinary" : data:image/gif;base64,R0lGODlhDwAOAPYBAAAAAP///+Pj5MzS6qy33bfA4sDI5dne8I6e0JGg0Zim1Jqo1aGu2H6SyZOj0HWMxYWYytbY3V98vLG801p9ulN6u2SHw0JvtYiix8vU4TBmsDBmrx9fqyJgrEB1uGCOxRpeqoGjygdXpwlYpw5aqBVhrGOUx6C+3N/p8+/0+dzd3gBVpQNWpgtdphBgqxpmqxpnqyBqsDB1tmqbx3CfzJe62Z+/3a/K46/J4r/V6c/f7t/q9AJaoQhcpAlcpVuSwh9sqC10rF+Xv5G20cXY5cba5wxnnZu7zXKfthhxmS6EloezvVqcqFeeqJq+w1SjqYC0sajNysrh3drp4trn4fD49O/18vb6+Pf5+OXs6Pz9/Pv8+////wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH5BAAAAAAALAAAAAAPAA4AAAeYgAEBThYVFxocJCwrL4KCW0gIDxIUGyAiKys6jlMhCg0TKhgdI5kzjksGDA4RKgInLpkwglhHAwQJEBmCOrErOAFUNQcFCx4uN4IpMis/AUwrJh8lKy45gjvMLQFPmZkymwG9mT4oVU2ZMSmCNt5ARYJaUDwrNgE03kHrjgFRRisxvAnhx09KEm9DCBLMoqQHEYUKrVyBGAgAOw==,
"faceName" : "영희",
"accessKey" : "cWuDsBp3kULamzR4HMdddd"
API 결과값
| KEY | TYPE | VALUE |
|---|---|---|
| result_status | String | 결과코드 ( success / error ) |
| result_message | String | 결과 메시지 내용 |
| result | Object | 결과값 |
| result.id | String | 생성Id |
| result.ksId | String | 얼굴사진 컬렉션 ID |
| result.faceId | String | 얼굴사진 Id |
| result.faceName | String | 얼굴사진 이름 |
| result.faceUrl | String | 얼굴사진 업로드 주소 |
| result.areaWidth | Number(Double) | 얼굴의 가로 비율(전체이미지 가로기준) |
| result.areaHeight | Number(Double) | 얼굴의 높이 비율(전체이미지 높이기준) |
| result.areaLeft | Number(Double) | 얼굴의 왼쪽 좌표(전체이미지 가로기준) |
| result.areaTop | Number(Double) | 얼굴의 높이 좌표(전체이미지 높이기준) |
| result.description | String | 얼굴사진 설명 |
| result.createDate | Date | 생성일시 |
| result.updateDate | Date | 수정일시 |
예시)
{
"result_status": "success",
"result_code": "OK",
"result_message": "데이터가 생성되었습니다.",
"result": {
"faces": [
{
"id": 9,
"ksId": "ce9e9dc9-590d-4e2f-a5a3-d4",
"faceId": "cf9d9851-9b75-4671-87d1-86e",
"faceName": "영희",
"faceUrl": "https://facerecognition.danbee.ai/prod/7f109179-84d2-4b/ce9e9dc9-590d-4e2f-a5a3-d4/ce9e9dc9-590d-4e2f-a5a3-d47.word",
"areaWidth": 0.78034204,
"areaHeight": 1.0008249,
"areaLeft": 0.14961596,
"areaTop": -0.033830762,
"description": "",
"orderFace": null,
"deleteYn": "N",
"creator": null,
"createDate": "2021-09-16T03:26:26.000+0000",
"updator": null,
"updateDate": "2021-09-16T03:26:26.000+0000"
}
]
}
}
함께해요! 챗봇시대 :)
모든 사물, 디지털 매체와 말이 통하는 시대! 단비Ai와 함께 반드시 오게될 챗봇시대를 열어갔으면 좋겠습니다.
혹시 서비스 소개서를 찾고 있나요?
단비Ai 서비스 소개서는 아래 링크를 클릭해 다운로드 하실 수 있습니다.
서비스 소개서 다운로드
챗봇을 교육용도로 활용하고 싶으신가요?
단비Ai를 기반으로 만들어진 Ai교육, 에이아이런을 만나보세요 :)
