Update vllm_support/README.md

vllm_support/README.md

@@ -126,7 +126,7 @@ CUDA_VISIBLE_DEVICES=0 PORT=8000 \
   ./KaLM-Reranker-V1-Nano/vllm_support/examples/start_online_server.sh
 ```
 
-Check health and send demo requests:
+In a second terminal, check health and send built-in demo requests:
 
 ```bash
 kalm-vllm-client --health
@@ -134,6 +134,30 @@ kalm-vllm-client --endpoint rerank --return-margin
 kalm-vllm-client --endpoint score --return-margin
 ```
 
+For custom input, pass one JSON object with `--json-file`. Use `/rerank` for
+one query against multiple documents:
+
+```bash
+kalm-vllm-client \
+  --endpoint rerank \
+  --json-file ./KaLM-Reranker-V1-Nano/vllm_support/examples/rerank_request.json \
+  --return-margin \
+  --top-k 10
+```
+
+Use `/score` for a batch of independent query-document pairs:
+
+```bash
+kalm-vllm-client \
+  --endpoint score \
+  --json-file ./KaLM-Reranker-V1-Nano/vllm_support/examples/score_request.json \
+  --return-margin
+```
+
+When `--json-file` is used, `--return-margin` sets
+`"return_margin": true` in the outgoing request, and `--top-k` overrides the
+JSON value for `/rerank`.
+
 ### `POST /rerank`
 
 ```json
@@ -177,7 +201,8 @@ Results are returned in descending score order:
 }
 ```
 
-`/score` preserves pair order and includes an input `id` when provided.
+`/score` accepts multiple entries in `pairs`, preserves their input order and
+includes an input `id` when provided.
 
 ### `GET /health`