Update README.md

README.md

@@ -1,21 +1,46 @@
+---
+title: Gender Classification API
+colorFrom: indigo
+colorTo: blue
+sdk: docker
+pinned: false
+---
+
 # Gender Classification API (Docker)
 
-This is a Hugging Face Space API using FastAPI + Docker to classify gender from an image using `prithivMLmods/Gender-Classifier-Mini`.
+This is a Hugging Face Space API using FastAPI + Docker to classify gender from an image using [`prithivMLmods/Gender-Classifier-Mini`](https://huggingface.co/prithivMLmods/Gender-Classifier-Mini).
 
 ## Usage
 
-POST to:
+Make a `POST` request to:
 
 ```
 https://benstaf-gender-api-fastapi.hf.space/classify/
 ```
 
+with a JPEG/PNG image of a face.
+
 ## Example (Python)
 
 ```python
 import requests
 
 with open("face.jpg", "rb") as f:
-    r = requests.post("https://benstaf-gender-api-fastapi.hf.space/classify/", files={"image": f})
-    print(r.json())
+    response = requests.post(
+        "https://benstaf-gender-api-fastapi.hf.space/classify/",
+        files={"image": f}
+    )
+    print(response.json())
+```
+
+**Response format:**
+```json
+{
+  "label": "female",
+  "confidence": 0.987
+}
 ```
+
+## Model
+
+This API uses a lightweight gender classifier fine-tuned on vision models, optimized for single-face inputs.