Thuong Nguyen
Initial deployment: FastAPI backend with data and Dockerfile
f3cb94f

🌿 Plant Classification API - Quick Guide

API URL: https://thuonguyenvan-plantsclassify.hf.space


Endpoints

1️⃣ Upload Image File

POST /predict/upload

Example (Python):

import requests

url = "https://thuonguyenvan-plantsclassify.hf.space/predict/upload"
files = {"file": open("plant.jpg", "rb")}
response = requests.post(url, files=files)
print(response.json())

Example (cURL):

curl -X POST https://thuonguyenvan-plantsclassify.hf.space/predict/upload \
  -F "[email protected]"

2️⃣ Image URL

POST /predict/url
Content-Type: application/json

Request:

{
  "url": "https://example.com/plant.jpg"
}

Example (Python):

import requests

url = "https://thuonguyenvan-plantsclassify.hf.space/predict/url"
data = {"url": "https://example.com/plant.jpg"}
response = requests.post(url, json=data)
print(response.json())

Example (cURL):

curl -X POST https://thuonguyenvan-plantsclassify.hf.space/predict/url \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/plant.jpg"}'

Response Format

{
  "predictions": [
    {
      "class_name": "Oryza_sativa",
      "confidence": 0.8543
    },
    {
      "class_name": "Triticum_aestivum",
      "confidence": 0.0821
    },
    {
      "class_name": "Zea_mays",
      "confidence": 0.0412
    },
    {
      "class_name": "Hordeum_vulgare",
      "confidence": 0.0156
    },
    {
      "class_name": "Setaria_italica",
      "confidence": 0.0068
    }
  ]
}

Quick Test

Health Check:

curl https://thuonguyenvan-plantsclassify.hf.space/health

Interactive Docs:

https://thuonguyenvan-plantsclassify.hf.space/docs

Notes

  • ⏰ Free tier auto-sleeps → first request may take 10-30s
  • 📸 Supports: JPEG, PNG
  • 🎯 Returns: Top 5 predictions
  • 🌱 Classes: 1139 plant species