Apply suggestions from code review

Co-authored-by: Pierric Cistac <[email protected]>

Author: Wauplin

docs/api-inference/hub-api.md

@@ -94,7 +94,7 @@ Inference status is either "warm" or undefined:
 <curl>
 
 ```sh
-# Get inference status (not warm)
+# Get inference status (no inference)
 ~ curl -s https://huggingface.co/api/models/manycore-research/SpatialLM-Llama-1B?expand[]=inference
 {
 "_id": "67d3b141d8b6e20c6d009c8b",
@@ -112,7 +112,7 @@ In the `huggingface_hub`, use `model_info` with the expand parameter:
 >>> from huggingface_hub import model_info
 
 >>> info = model_info("manycore-research/SpatialLM-Llama-1B", expand="inference")
->>> info.inference_provider_mapping
+>>> info.inference
 None
 ```
 

docs/api-inference/hub-integration.md

@@ -1,6 +1,6 @@
 # Hub Integration
 
-The Inference Providers is tightly integrated with the Hugging Face Hub. No matter which provider you use, the usage and billing will be centralized in your Hugging Face account.
+Inference Providers is tightly integrated with the Hugging Face Hub. No matter which provider you use, the usage and billing will be centralized in your Hugging Face account.
 
 ## Model search
 
@@ -46,7 +46,7 @@ Several Hugging Face features utilize Inference Providers and count towards your
 ## User Settings
 
 In your user account settings, you are able to:
-- set your own API keys for the providers you’ve signed up with. Otherwise, you can still use them – your requests will be billed on your HF account. More details in the [billing section](./pricing#routed-requests-vs-direct-calls).
+- set your own API keys for the providers you’ve signed up with. If you don't, your requests will be billed on your HF account. More details in the [billing section](./pricing#routed-requests-vs-direct-calls).
 
 <div class="flex justify-center">
     <img class="block light:hidden" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/inference-providers/set-custom-key-light.png"/>

docs/api-inference/index.md

@@ -1,19 +1,19 @@
 # Inference Providers
 
-The Hugging Face Inference Providers revolutionizes how developers access and run machine learning models by offering a unified, flexible interface to multiple serverless inference providers. This new approach extends our previous Serverless Inference API, providing more models, increased performances and better reliability thanks to our awesome partners.
+Hugging Face Inference Providers revolutionizes how developers access and run machine learning models by offering a unified, flexible interface to multiple serverless inference providers. This new approach extends our previous Serverless Inference API, providing more models, increased performances and better reliability thanks to our awesome partners.
 
-To learn more about the launch of the Inference Providers, check out our [announcement blog post](https://huggingface.co/blog/inference-providers).
+To learn more about the launch of Inference Providers, check out our [announcement blog post](https://huggingface.co/blog/inference-providers).
 
-## Why use the Inference Providers?
+## Why use Inference Providers?
 
-The Inference Providers offers a fast and simple way to explore thousands of models for a variety of tasks. Whether you're experimenting with ML capabilities or building a new application, this API gives you instant access to high-performing models across multiple domains:
+Inference Providers offers a fast and simple way to explore thousands of models for a variety of tasks. Whether you're experimenting with ML capabilities or building a new application, 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 and Video 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.
 
-⚡ **Fast and Free to Get Started**: The Inference Providers comes with a free-tier and additional included credits for [PRO users](https://hf.co/subscribe/pro).
+⚡ **Fast and Free to Get Started**: Inference Providers comes with a free-tier and additional included credits for [PRO users](https://hf.co/subscribe/pro), as well as [Enterprise Hub organizations](https://huggingface.co/enterprise).
 
 ## Key Features
 
@@ -33,13 +33,13 @@ To get started quickly with [Chat Completion models](http://huggingface.co/model
 
 ## Get Started
 
-You can call the Inference Providers with your preferred tools, such as Python, JavaScript, or cURL. To simplify integration, we offer both a Python SDK (`huggingface_hub`) and a JavaScript SDK (`huggingface.js`).
+You can use Inference Providers with your preferred tools, such as Python, JavaScript, or cURL. To simplify integration, we offer both a Python SDK (`huggingface_hub`) and a JavaScript SDK (`huggingface.js`).
 
 In this section, we will demonstrate a simple example using [deepseek-ai/DeepSeek-V3-0324](https://huggingface.co/deepseek-ai/DeepSeek-V3-0324), a conversational Large Language Model. For the example, we will use [Novita AI](https://novita.ai/) as Inference Provider.
 
 ### Authentication
 
-The Inference Providers requires passing a user token in the request headers. You can generate a token by signing up on the Hugging Face website and going to the [settings page](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained). We recommend creating a `fine-grained` token with the scope to `Make calls to Inference Providers`.
+Inference Providers requires passing a user token in the request headers. You can generate a token by signing up on the Hugging Face website and going to the [settings page](https://huggingface.co/settings/tokens/new?ownUserPermissions=inference.serverless.write&tokenType=fineGrained). We recommend creating a `fine-grained` token with the scope to `Make calls to Inference Providers`.
 
 For more details about user tokens, check out [this guide](https://huggingface.co/docs/hub/en/security-tokens).
 
@@ -140,7 +140,7 @@ const response = await fetch(
 console.log(await response.json());
 ```
 
-For convenience, the JS  library `@huggingface/inference` provides an [`InferenceClient`](https://huggingface.co/docs/huggingface.js/inference/classes/InferenceClient) that handles inference for you. Make sure to install it with `npm install @huggingface/inference`.
+For convenience, the JS library `@huggingface/inference` provides an [`InferenceClient`](https://huggingface.co/docs/huggingface.js/inference/classes/InferenceClient) that handles inference for you. You can install it with `npm install @huggingface/inference`.
 
 
 ```js
@@ -166,7 +166,7 @@ console.log(chatCompletion.choices[0].message);
 
 In this introduction, we've covered the basics of Inference Providers. To learn more about this service, check out our guides and API Reference:
 - [Pricing and Billing](./pricing): everything you need to know about billing
-- [Hub integration](./hub-integration): how Inference Providers is integrated with the Hub?
+- [Hub integration](./hub-integration): how is Inference Providers integrated with the Hub?
 - [External Providers](./providers): everything about providers and how to become an official partner
-- [Hub API](./hub-api): high level API for inference providers
+- [Hub API](./hub-api): high-level API for Inference Providers
 - [API Reference](./tasks/index): learn more about the parameters and task-specific settings.

docs/api-inference/pricing.md

@@ -1,6 +1,6 @@
 # Pricing and Billing
 
-Inference Providers is a production-ready service involving external partners and is therefore a paid-product. However, as a Hugging Face user you get monthly credits to run experiments. The amount of credits you get depends on your type of account:
+Inference Providers is a production-ready service involving external partners and is therefore a paid product. However, as a Hugging Face user, you get monthly credits to run experiments. The amount of credits you get depends on your type of account:
 
 | User Tier                | Included monthly credits           |
 | ------------------------ | ---------------------------------- |