update readme

README.md

@@ -1,36 +1,36 @@
 ---
 language:
-  - en
+- en
 license: apache-2.0
 tags:
-  - VLM
-  - video-understanding
-  - image-captioning
-  - gemma
-  - json-mode
-  - structured-output
-  - video-analysis
+- VLM
+- video-understanding
+- image-captioning
+- gemma
+- json-mode
+- structured-output
+- video-analysis
 base_model: google/gemma-12b
 pipeline_tag: image-text-to-text
 model-index:
-  - name: ClipTagger-12b
-    results:
-      - task:
-          type: image-to-text
-          name: Video Frame Captioning
-        metrics:
-          - name: Average Judge Score
-            type: quality
-            value: 3.53
-          - name: ROUGE-1
-            type: rouge-1
-            value: 0.674
-          - name: ROUGE-L
-            type: rouge-l
-            value: 0.520
-          - name: BLEU
-            type: bleu
-            value: 0.267
+- name: ClipTagger-12b
+  results:
+  - task:
+      type: image-to-text
+      name: Video Frame Captioning
+    metrics:
+    - name: Average Judge Score
+      type: quality
+      value: 3.53
+    - name: ROUGE-1
+      type: rouge-1
+      value: 0.674
+    - name: ROUGE-L
+      type: rouge-l
+      value: 0.520
+    - name: BLEU
+      type: bleu
+      value: 0.267
 ---
 
 # ClipTagger-12b
@@ -39,9 +39,7 @@ model-index:
 
 ## Model Description
 
-**ClipTagger-12b** is a 12-billion parameter vision-language model (VLM) designed for video understanding at massive scale. Developed by [Inference.net](https://inference.net) in collaboration with [Grass](https://grass.io), this model was created to meet the demanding requirements of trillion-scale video frame captioning workloads, without sacrificing output quality.
-
-**ClipTagger-12b exceeds or matches the performance of GPT-4.1 and Claude 4 Sonnet, while costing 15x less per generation.**
+**ClipTagger-12b** is a 12-billion parameter vision-language model (VLM) designed for video understanding at massive scale. Developed by [Inference.net](https://inference.net) in collaboration with [Grass](https://grass.io), this model was created to meet the demanding requirements of trillion-scale video frame captioning workloads.
 
 The model generates structured, schema-consistent JSON outputs for every video frame, making it ideal for building searchable video databases, content moderation systems, and accessibility tools. It maintains temporal consistency across frames while delivering frontier-quality performance at a fraction of the cost of closed-source alternatives.
 
@@ -59,7 +57,6 @@ The model generates structured, schema-consistent JSON outputs for every video f
 ClipTagger-12b is based on the Gemma-12B architecture and has been optimized with FP8 quantization for maximum throughput on modern GPUs. The model is specifically tuned for RTX 40-series and H100 GPUs, leveraging native FP8 support for efficient inference.
 
 ### Technical Specifications
-
 - **Parameters**: 12 billion
 - **Base Architecture**: Gemma-12B
 - **Quantization**: FP8 (no quality loss vs bf16)
@@ -73,7 +70,6 @@ ClipTagger-12b is based on the Gemma-12B architecture and has been optimized wit
 The model was trained on 1 million carefully curated single-frame samples from publicly available video data. Training employed knowledge distillation from a high-quality teacher model to ensure consistent, accurate outputs while maintaining the ability to generalize across diverse video content types.
 
 ### Training Process
-
 - **Dataset Size**: 1M video frames
 - **Training Method**: Teacher-student distillation
 - **Data Source**: Publicly available video content
@@ -81,12 +77,16 @@ The model was trained on 1 million carefully curated single-frame samples from p
 
 ## Benchmarks
 
+ClipTagger-12b achieves **equal or superior performance** compared to the leading closed-source models across all major evaluation metrics. Despite being open-source and significantly more cost-effective, our model **outperforms Claude 4 Sonnet across every metric** and achieves **comparable quality to GPT-4.1**.
+
 Performance metrics on our internal evaluation set:
 | Model | Avg Judge Score | ROUGE-1 | ROUGE-2 | ROUGE-L | BLEU |
 |-------|-----------------|---------|---------|---------|------|
-| ClipTagger-12b | **3.53** | **0.674** | **0.404** | **0.520** | **0.267** |
-| Claude 4 Sonnet | 3.16 | 0.463 | 0.179 | 0.281 | 0.060 |
-| GPT-4.1 | 3.64 | 0.581 | 0.260 | 0.376 | 0.119 |
+| cliptagger_12b | **3.53** | **0.674** | **0.404** | **0.520** | **0.267** |
+| claude_4_sonnet | 3.16 | 0.463 | 0.179 | 0.281 | 0.060 |
+| gpt_4.1 | 3.64 | 0.581 | 0.260 | 0.376 | 0.119 |
+
+### Benchmark Visualizations
 
 <table>
   <tr>
@@ -115,26 +115,26 @@ ClipTagger-12b offers **15x cost savings** compared to GPT-4.1 and **17x cost sa
 | GPT-4.1         | $3.00           | $12.00           | $5,100                  | $0.0051             |
 | Claude 4 Sonnet | $3.00           | $15.00           | $5,850                  | $0.00585            |
 
+*Cost calculations based on an average of 700 input tokens and 250 output tokens per generation.
+
 ## Usage
 
 ### API Access
 
 For production deployments, we recommend using our managed API service which includes advanced features like batch processing, webhooks, and automatic scaling:
 
-**[Run ClipTagger-12b via Inference.net API →](https://inference.net/use-cases/video-understanding)**
+**[Run ClipTagger-12b via Inference.net API →](https://localhost:3000/use-cases/video-understanding)**
 
 ### Required Prompts
 
 The model requires specific system and user prompts for optimal performance. Use these prompts exactly as shown:
 
 #### System Prompt
-
 ```
 You are an image annotation API trained to analyze YouTube video keyframes. You will be given instructions on the output format, what to caption, and how to perform your job. Follow those instructions. For descriptions and summaries, provide them directly and do not lead them with 'This image shows' or 'This keyframe displays...', just get right into the details.
 ```
 
 #### User Prompt
-
 ```
 You are an image annotation API trained to analyze YouTube video keyframes. You must respond with a valid JSON object matching the exact structure below.
 
@@ -214,21 +214,37 @@ Given a nature scene with a wooden boardwalk through grassland:
 ```
 
 ## Use Cases
+
 - **Video Search & Discovery** - Build searchable databases with structured metadata
 - **Content Moderation** - Automated content analysis and categorization
 - **Accessibility** - Generate consistent alt-text and scene descriptions
 - **Ad Verification** - Track product visibility and brand appearances
 - **Video Analytics** - Extract insights from large video collections
 - **Content Management** - Automatic tagging and organization of video libraries
--
+
+## Limitations
+
+- Processes one video frame per request
+- English-only descriptions (can identify text in other languages)
+- Maximum image size: 1MB
+- Requires specific prompts for optimal performance
+- Not supported on A100 GPUs (no native FP8)
+
+## Best Practices
+
+1. **Use exact prompts** - The provided system and user prompts are optimized for best results
+2. **Set low temperature** - Use temperature=0.1 for consistent outputs
+3. **Enable JSON mode** - Always set response_format to ensure valid JSON
+4. **Process systematically** - Maintain temporal order when processing video sequences
+5. **Batch similar content** - Group frames from the same video for efficiency
 
 ## Support
-- **Documentation**: [docs.inference.net](https://inference.net/use-cases/video-understanding)
-- **API Access**: [inference.net/use-cases/video-understanding](https://inference.net/use-cases/video-understanding)
-- **Email**: [email protected]
 
-## Interested in training your own model?
-Contact us at [sales@inference.net](mailto:[email protected]) for a free consultation with our research team.
+- **Documentation**: [docs.inference.net](https://docs.inference.net)
+- **API Access**: [inference.net/use-cases/video-understanding](https://localhost:3000/use-cases/video-understanding)
+- **Email**: [email protected]
+- **Enterprise**: [Schedule a consultation](https://inference.net/sales)
 
 ## License
-This model is released under the Apache-2.0 license, allowing for commercial use and modification with proper attribution.
+
+This model is released under the Apache-2.0 license, allowing for commercial use and modification with proper attribution.