개발자 API

사진 기반 식물 식별 API

식물 사진 인식을 앱, 내부 워크플로, 고객 포털에 추가하세요. API는 이미지를 받아 일반명, 학명, 과, 관리 정보, 유사 식물, 다음 촬영 안내를 JSON으로 반환합니다.

사진 입력
JSON 출력
API 키
POST /api/plant/identify
curl -X POST https://api.plantidentify.org/api/plant/identify \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "[email protected]" \
  -F "lang=ko"

Plant Identifier API 작동 방식

웹 식별기와 같은 흐름으로 선명한 식물 사진을 보내고, 요청을 인증한 뒤 구조화된 결과를 제품에서 사용합니다.

1

API 키 생성

로그인 후 API Keys 페이지에서 통합용 키를 만듭니다. 키는 서버에 보관하고 접근 권한이 바뀌면 교체하세요.

2

식물 사진 전송

앱에서 JPG, PNG, WEBP 이미지를 보냅니다. 잎, 꽃, 줄기, 전체 식물이 밝고 선명하면 결과가 더 유용합니다.

3

JSON 결과 해석

일반명, 학명, 과, 관리 정보, 신뢰도, 유사 식물, 다음 촬영 안내를 응답에서 읽습니다.

4

다음 단계 표시

불확실할 때 확인, 관리, 안전 검토, 추가 사진 촬영으로 사용자를 안내합니다.

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 응답만 사용하지 마세요.

앱이 받을 수 있는 결과

API는 단순 시각 추정이 아니라 검색, 학습, 관리 플로우, 후속 안내에 쓸 수 있는 필드를 제공합니다.

식물 이름

이미지에 충분한 단서가 있으면 일반명과 학명을 반환합니다.

과와 유사 식물

과 정보와 비슷한 식물을 보여 주어 후보를 비교하게 합니다.

관리 정보

가능한 경우 빛, 물주기, 실용적인 관리 맥락을 제공합니다.

안전 메모

반려동물, 어린이, 취급, 민감한 사용 사례에 대한 신중한 정보를 제공합니다.

다음 사진 안내

잎, 꽃, 줄기, 수피, 전체 식물 중 확인에 도움이 되는 사진을 제안합니다.

구조화 JSON

모바일 앱, 정원 도구, 내부 워크플로에서 예측 가능한 필드를 사용할 수 있습니다.

적합한 API 사용 사례

사진 기반 후보 목록과 실용적인 안내가 필요한 제품에 가장 잘 맞습니다.

원예 및 식물 관리 앱

실내 식물, 꽃, 나무, 잡초, 다육식물을 식별한 뒤 알림, 관리 계획, 식물 프로필을 보여 줍니다.

화원 및 전자상거래 문의

고객 질문을 분류하고 사진에 라벨을 달며 지원 응답 전 맥락을 수집합니다.

교육 및 시민 과학

현장 사진을 후보 이름, 관찰 체크리스트, 다음 기록으로 연결합니다.

내부 이미지 분류

검토 큐, 지식 베이스, 대시보드에 식물 이름과 카테고리를 미리 채웁니다.

정확도, 개인정보, 한계

사진 인식은 유용하지만 제품은 불확실성과 민감한 결정을 조심스럽게 처리해야 합니다.

상황 권장 처리
흐리거나 먼 사진 더 가깝고 밝은 사진을 다시 요청합니다.
한 이미지에 여러 식물 한 대상만 남기도록 자르거나 다시 촬영하게 합니다.
식용 또는 독성 가능성 경고를 표시하고 자격 있는 현지 확인을 요구합니다.
낮은 신뢰도 후보, 유사 식물, 다음 추천 사진을 표시합니다.

식물 식별 API FAQ

네. 식물 사진을 보내면 후보 이름, 과, 관리 정보, 유사 식물, 다음 단계를 JSON으로 반환합니다.

JPG, PNG, WEBP를 사용하세요. 잎, 꽃, 줄기, 전체 식물이 선명한 사진일수록 좋습니다.

네. API 키는 서버에 보관하고 이미지는 백엔드를 통해 보내며 앱에는 필요한 필드만 반환하세요.

가능한 경우 빛, 물주기, 관리, 안전 메모, 유사 식물, 다음 사진 안내를 포함할 수 있습니다.

아닙니다. 이미지 품질, 보이는 특징, 생장 단계, 유사 종에 따라 달라집니다. 신뢰도와 후보를 보여 주세요.

단독으로 사용하지 마세요. 식용, 독성, 알레르기, 반려동물, 치료와 관련된 결정은 전문 확인이 필요합니다.

로그인 후 API Keys 페이지에서 계정의 키를 만들고 관리할 수 있습니다.

제품에 식물 사진 식별을 추가하세요

API 키를 만들고 사진 워크플로를 테스트한 뒤 앱에서 실용적인 식물 ID 결과를 제공하세요.