> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hugging Face

> Obtenha um guia simples para simplificar a implantação de IA com Novita AI + Hugging Face.

A integração da Novita AI com a Plataforma Hugging Face permite recursos avançados de inferência sem servidor. Isso fornece acesso direto às páginas de modelos do Hub por meio de uma infraestrutura otimizada, oferecendo aos desenvolvedores uma experiência de configuração simplificada. Com suporte completo aos SDKs JavaScript e Python da Hugging Face, a Novita AI simplifica a implantação e o escalonamento de modelos sem gerenciamento de infraestrutura.

Nosso guia abrangente orienta você na implementação da Novita AI no Hugging Face, abordando tanto a interface web quanto os métodos de integração via SDK.

## **Como usar a Novita AI no Hugging Face na interface do site**

### **Etapa 1: Configurar chaves de API**

* Acesse o painel de configurações da sua conta para configurar suas chaves de API.
* Insira suas credenciais de autenticação da Novita AI na plataforma Hugging Face.

  <Frame>
    <img src="https://mintcdn.com/novitaai/OIO9nfACcX0vhcTI/images/third-party/ConfigureAPIKeysinHuggingFace.jpeg?fit=max&auto=format&n=OIO9nfACcX0vhcTI&q=85&s=7f70e8903dfb2bca046ca9d81271e930" alt=" Configurar chaves de API no Hugging Face" width="1678" height="1328" data-path="images/third-party/ConfigureAPIKeysinHuggingFace.jpeg" />
  </Frame>

### **Etapa 2: Escolher modos de Inference API**

* Custom Key Mode: As chamadas são enviadas diretamente ao provedor de inferência, utilizando sua própria chave de API.
* HF-Routed Mode: Nesse modo, nenhum token do provedor é necessário. As cobranças são aplicadas à sua conta Hugging Face em vez da conta do provedor.

  <Frame>
    <img src="https://mintcdn.com/novitaai/OIO9nfACcX0vhcTI/images/third-party/ChooseInferenceAPIModes.png?fit=max&auto=format&n=OIO9nfACcX0vhcTI&q=85&s=b14ffdd53826ab3276300dbf452c2a13" alt="Escolher modos de Inference API" width="1612" height="624" data-path="images/third-party/ChooseInferenceAPIModes.png" />
  </Frame>

### **Etapa 3: Explorar provedores compatíveis nas páginas dos modelos**

* As páginas dos modelos exibem provedores de inferência de terceiros compatíveis com o modelo selecionado (aqueles que são compatíveis com o modelo atual, ordenados pela preferência do usuário).

  <Frame>
    <img src="https://mintcdn.com/novitaai/OIO9nfACcX0vhcTI/images/third-party/ExploreCompatibleProvidersonModelPagesinHuggingFace.jpeg?fit=max&auto=format&n=OIO9nfACcX0vhcTI&q=85&s=c4b1d98633c874bbb8133c64890b7eff" alt=" Explorar provedores compatíveis nas páginas dos modelos no Hugging Face" width="2312" height="1196" data-path="images/third-party/ExploreCompatibleProvidersonModelPagesinHuggingFace.jpeg" />
  </Frame>

## **Como usar Huggingface\_hub em Python pelos SDKs de cliente**

### **Etapa 1: Instalar** [**Huggingface\_hub**](https://github.com/huggingface/huggingface_hub)

```python theme={"system"}
pip install huggingface_hub
```

### **Etapa 2: Chamar a API do modelo em Python**

```python theme={"system"}
from huggingface_hub import InferenceClient


client = InferenceClient(
    provider="novita",
    api_key="xxxxxxxxxxxxxxxxxxxxxxxx", # optional, required from 2nd calling, get from https://novita.ai/settings/key-management
)

# an example question
messages = [
    dict(
        role="user",
        content='Sally (a girl) has 3 brothers. Each brother has 2 sisters. How many sisters does Sally have?',
    ),
]
completion = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-R1",
    messages=messages,
    max_tokens=512,
)

print(completion.choices[0].message)
```

## **Como usar Huggingface\_hub em JS pelos SDKs de cliente**

```json theme={"system"}
import { HfInference } from "@huggingface/inference";

const client = new HfInference("xxxxxxxxxxxxxxxxxxxxxxxx");

const chatCompletion = await client.chatCompletion({
    model: "deepseek-ai/DeepSeek-R1",
    messages: [
        {
            role: "user",
            content: "What is the capital of France?"
        }
    ],
    provider: "novita",
    max_tokens: 500
});

console.log(chatCompletion.choices[0].message)
```
