Update README.md

README.md

@@ -68,9 +68,103 @@ Built on [Qwen3-1.7B-Base](https://huggingface.co/Qwen/Qwen3-1.7B-Base) with [Si
 | InternVL3-2B | 2.2B | 69.2 | 73.6 | 71.9 | 64.3 |
 | InternVL3.5-2B | 2.2B | 71.6 | 74.6 | 70.9 | 62.0 |
 
-## Usage
 
-### Installation
+## Via Jina API
+
+We provide an OpenAI-compatible API at `https://api-beta-vlm.jina.ai`. 
+
+All requests require a Jina API key in the Authorization header:
+
+```bash
+Authorization: Bearer YOUR_JINA_API_KEY
+```
+
+Get your API key at [jina.ai](https://jina.ai).
+
+
+### Image from URL
+
+| Format | Example |
+|--------|---------|
+| HTTP/HTTPS URL | `https://example.com/image.jpg` |
+| Base64 data URI | `data:image/jpeg;base64,/9j/4AAQ...` |
+
+```bash
+curl https://api-beta-vlm.jina.ai/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $JINA_API_KEY" \
+  -d '{
+    "model": "jina-vlm",
+    "messages": [{
+      "role": "user",
+      "content": [
+        {"type": "text", "text": "Describe this image"},
+        {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}
+      ]
+    }]
+  }'
+```
+
+### Text-only query
+
+```bash
+curl https://api-beta-vlm.jina.ai/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $JINA_API_KEY" \
+  -d '{
+    "model": "jina-vlm",
+    "messages": [{"role": "user", "content": "What is the capital of France?"}]
+  }'
+```
+
+### Local image (base64)
+
+```bash
+curl https://api-beta-vlm.jina.ai/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $JINA_API_KEY" \
+  -d '{
+    "model": "jina-vlm",
+    "messages": [{
+      "role": "user",
+      "content": [
+        {"type": "text", "text": "What is in this image?"},
+        {"type": "image_url", "image_url": {"url": "data:image/jpeg;base64,'$(base64 -i image.jpg)'"}}
+      ]
+    }]
+  }'
+```
+
+### Streaming response
+
+Add `"stream": true` to receive tokens as they're generated:
+
+```bash
+curl https://api-beta-vlm.jina.ai/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $JINA_API_KEY" \
+  -d '{
+    "model": "jina-vlm",
+    "stream": true,
+    "messages": [{"role": "user", "content": "Write a haiku about coding"}]
+  }'
+```
+
+When the service is cold starting, you'll receive:
+
+```json
+{
+  "error": {
+    "message": "Model is loading, please retry in 30-60 seconds. Cold start takes ~30s after the service scales up.",
+    "code": 503
+  }
+}
+```
+
+Simply retry your request after waiting.
+
+
+## Local Installation
 
 ```bash
 uv sync