사진 기반 식물 식별 API
식물 사진 인식을 앱, 내부 워크플로, 고객 포털에 추가하세요. API는 이미지를 받아 일반명, 학명, 과, 관리 정보, 유사 식물, 다음 촬영 안내를 JSON으로 반환합니다.
curl -X POST https://api.plantidentify.org/api/plant/identify \
-H "Authorization: Bearer YOUR_TOKEN" \
-F "[email protected]" \
-F "lang=ko"
Plant Identifier API 작동 방식
웹 식별기와 같은 흐름으로 선명한 식물 사진을 보내고, 요청을 인증한 뒤 구조화된 결과를 제품에서 사용합니다.
API 키 생성
로그인 후 API Keys 페이지에서 통합용 키를 만듭니다. 키는 서버에 보관하고 접근 권한이 바뀌면 교체하세요.
식물 사진 전송
앱에서 JPG, PNG, WEBP 이미지를 보냅니다. 잎, 꽃, 줄기, 전체 식물이 밝고 선명하면 결과가 더 유용합니다.
JSON 결과 해석
일반명, 학명, 과, 관리 정보, 신뢰도, 유사 식물, 다음 촬영 안내를 응답에서 읽습니다.
다음 단계 표시
불확실할 때 확인, 관리, 안전 검토, 추가 사진 촬영으로 사용자를 안내합니다.
API 요청 및 응답 예시
실제 트래픽을 연결하기 전에 요청 처리, 결과 카드, 로그, 예외 상태를 설계하는 데 사용할 수 있는 예시입니다.
POST https://api.plantidentify.org/api/plant/identify
Authorization: Bearer YOUR_TOKEN
Content-Type: multipart/form-data
image: monstera.jpg
lang: ko
context: plant
{
"success": true,
"data": {
"common_name": "몬스테라",
"scientific_name": "Monstera deliciosa",
"family": "Araceae",
"confidence": 0.86,
"care": {"light": "밝은 간접광", "watering": "겉흙이 마르면 물주기"},
"lookalikes": ["필로덴드론", "Rhaphidophora"],
"next_step": "더 확실히 확인하려면 잎 전체와 줄기 사진을 업로드하세요."
}
}
앱이 받을 수 있는 결과
API는 단순 시각 추정이 아니라 검색, 학습, 관리 플로우, 후속 안내에 쓸 수 있는 필드를 제공합니다.
식물 이름
이미지에 충분한 단서가 있으면 일반명과 학명을 반환합니다.
과와 유사 식물
과 정보와 비슷한 식물을 보여 주어 후보를 비교하게 합니다.
관리 정보
가능한 경우 빛, 물주기, 실용적인 관리 맥락을 제공합니다.
안전 메모
반려동물, 어린이, 취급, 민감한 사용 사례에 대한 신중한 정보를 제공합니다.
다음 사진 안내
잎, 꽃, 줄기, 수피, 전체 식물 중 확인에 도움이 되는 사진을 제안합니다.
구조화 JSON
모바일 앱, 정원 도구, 내부 워크플로에서 예측 가능한 필드를 사용할 수 있습니다.
적합한 API 사용 사례
사진 기반 후보 목록과 실용적인 안내가 필요한 제품에 가장 잘 맞습니다.
원예 및 식물 관리 앱
실내 식물, 꽃, 나무, 잡초, 다육식물을 식별한 뒤 알림, 관리 계획, 식물 프로필을 보여 줍니다.
화원 및 전자상거래 문의
고객 질문을 분류하고 사진에 라벨을 달며 지원 응답 전 맥락을 수집합니다.
교육 및 시민 과학
현장 사진을 후보 이름, 관찰 체크리스트, 다음 기록으로 연결합니다.
내부 이미지 분류
검토 큐, 지식 베이스, 대시보드에 식물 이름과 카테고리를 미리 채웁니다.
정확도, 개인정보, 한계
사진 인식은 유용하지만 제품은 불확실성과 민감한 결정을 조심스럽게 처리해야 합니다.
| 상황 | 권장 처리 |
|---|---|
| 흐리거나 먼 사진 | 더 가깝고 밝은 사진을 다시 요청합니다. |
| 한 이미지에 여러 식물 | 한 대상만 남기도록 자르거나 다시 촬영하게 합니다. |
| 식용 또는 독성 가능성 | 경고를 표시하고 자격 있는 현지 확인을 요구합니다. |
| 낮은 신뢰도 | 후보, 유사 식물, 다음 추천 사진을 표시합니다. |
관련 식물 식별 도구
같은 플로우를 앱에 연결하기 전에 사용자 경험을 먼저 테스트하세요.