New api docs structure

docs/api-inference/_toctree.yml

@@ -0,0 +1,15 @@
+- sections:
+  - local: index
+    title: Serverless Inference API
+  - local: overview
+    title: Overview
+  - local: getting-started
+    title: Get started
+  title: Get Started
+- sections:
+  - local: task_parameters
+    title: Task Parameters
+  - sections:
+    - local: tasks/fill-mask
+      title: Fill Mask
+  title: Parameters

docs/api-inference/getting-started.md

@@ -0,0 +1 @@
+# Getting Started

docs/api-inference/index.md

@@ -0,0 +1,50 @@
+# Serverless Inference API
+
+**Instant Access to 800,000+ ML Models for Fast Prototyping**
+
+Explore the most popular models for text, image, speech, and more — all with a simple API request. Build, test, and experiment without worrying about infrastructure or setup.
+
+---
+
+## Why use the Inference API?
+
+The Serverless Inference API offers a fast and free way to explore thousands of models for a variety of tasks. Whether you're prototyping a new application or experimenting with ML capabilities, this API gives you instant access to high-performing models across multiple domains:
+
+* **Text Generation:** Including large language models and tool-calling prompts, generate and experiment with high-quality responses.
+* **Image Generation:** Easily create customized images, including LoRAs for your own styles.
+* **Document Embeddings:** Build search and retrieval systems with SOTA embeddings.
+* **Classical AI Tasks:** Ready-to-use models for text classification, image classification, speech recognition, and more.
+
+TODO: add some flow chart image
+
+⚡ **Fast and Free to Get Started**: The Inference API is free with rate limits. For production needs, explore [Inference Endpoints](https://huggingface.co/docs/inference-endpoints/index) for dedicated resources, autoscaling, advanced security features, and more.
+
+---
+
+## Key Benefits
+
+- 🚀 **Instant Prototyping:** Access powerful models without setup.
+- 🎯 **Diverse Use Cases:** One API for text, image, and beyond.
+- 🔧 **Developer-Friendly:** Simple requests, fast responses.
+
+---
+
+## Contents
+
+The documentation is organized into two sections:
+
+* **Quick Overview** Learn the basics of how to use the Inference API.
+* **Detailed Parameters** Dive deep into task-specific settings and parameters.
+
+---
+
+## Looking for custom support from the Hugging Face team?
+
+<a target="_blank" href="https://huggingface.co/support">
+    <img alt="HuggingFace Expert Acceleration Program" src="https://cdn-media.huggingface.co/marketing/transformers/new-support-improved.png" style="max-width: 600px; border: 1px solid #eee; border-radius: 4px; box-shadow: 0 1px 2px 0 rgba(0, 0, 0, 0.05);">
+</a><br>
+
+## Hugging Face is trusted in production by over 10,000 companies
+
+<img class="block dark:hidden !shadow-none !border-0 !rounded-none" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/inference-api/companies-light.png" width="600">
+<img class="hidden dark:block !shadow-none !border-0 !rounded-none" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/inference-api/companies-dark.png" width="600">

docs/api-inference/overview.md

@@ -0,0 +1,7 @@
+# Overview
+
+## Main Features
+
+## Warm vs Cold vs Frozen models
+
+## Security and Compliance

docs/api-inference/task_parameters.md

@@ -0,0 +1,16 @@
+# Detailed Parameters
+
+Table with 
+- Domain
+- Task
+- Whether it's supported in Inference API
+- Supported libraries (not sure)
+- Recommended model
+- Link to model specific page
+
+
+
+## Additional parameters (different page?)
+
+- Controling cache
+- Modifying the task used by a model (Which task is used by this model?)

docs/api-inference/tasks/fill-mask.md

@@ -0,0 +1,6 @@
+## Fill Mask
+
+Mask filling is the task of predicting the right word (token to be precise) in the middle of a sequence. 
+
+Automated docs below
+