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

# Novita AI - Plataforma GPU Serverless

> Aprenda a usar os modelos da Novita com o Kodus

## Como a Novita funciona

A Novita é uma plataforma de infraestrutura serverless para IA, projetada para escalar modelos open-source com baixa latência e custo reduzido. Ela suporta centenas de modelos prontos para produção — incluindo Llama, Mistral, Claude e Stable Diffusion — e fornece APIs otimizadas, GPUs sob demanda e implantações de modelos personalizados sem qualquer sobrecarga de DevOps.

## Modelos Recomendados

Recomendamos bons modelos de codificação com janela de contexto de +100k.

<Info>
  {" "}

  Para informações mais atualizadas, visite o [site da Novita](https://novita.ai/models/llm).{" "}
</Info>

| Modelo                             | Preço       | Janela de Contexto |
| ---------------------------------- | ----------- | ------------------ |
| **Deepseek v3 0324** `recommended` | \$0.33/1.3  | \~128k tokens      |
| **Deepseek R1 0528**               | \$0.7/2.5   | \~128k tokens      |
| **Llama 4 Maverick Instruct**      | \$0.17/0.85 | \~100k tokens      |

## Criando a Chave de API

<Warning>Uma conta na Novita é necessária para criar a Chave de API.</Warning>

Acesse diretamente a [página de Chaves de API da Novita](https://novita.ai/settings/key-management) para criar uma nova Chave de API.

Ou siga estas etapas:

1. Acesse o console da Novita
2. Clique no botão "Manage API Keys" ou vá até sua foto de perfil e clique em API Keys
3. Clique em "Add New Key" e preencha com 'Kodus' ou qualquer nome que quiser
4. Clique em "Confirm"
5. Copie a Chave de API e salve em um local seguro

<Snippet file="deploy-basic-setup.mdx" />

### Configure a Novita no Arquivo de Ambiente

Edite seu arquivo `.env` e configure as definições principais. Para **Integração com LLM**, use a Novita no Modo Fixo:

```env theme={null}
# Core System Settings (update with your domains)
WEB_HOSTNAME_API="kodus-api.yourdomain.com"    
WEB_PORT_API=443                               
NEXTAUTH_URL="https://kodus-web.yourdomain.com"

# Security Keys (generate with openssl commands above)
WEB_NEXTAUTH_SECRET="your-generated-secret"
API_CRYPTO_KEY="your-generated-hex-key"
API_JWT_SECRET="your-generated-secret"
API_JWT_REFRESH_SECRET="your-generated-secret"

# Database Configuration
API_PG_DB_PASSWORD="your-secure-db-password"
API_MG_DB_PASSWORD="your-secure-db-password"

# Novita Configuration (Fixed Mode) 
API_LLM_PROVIDER_MODEL="deepseek-v3-0324"                    # Choose your preferred model
API_OPENAI_FORCE_BASE_URL="https://api.novita.ai/v3/openai"  # Novita API URL
API_OPEN_AI_API_KEY="your-novita-api-key"                    # Your Novita API Key

# Git Provider Webhooks (choose your provider)
API_GITHUB_CODE_MANAGEMENT_WEBHOOK="https://kodus-api.yourdomain.com/github/webhook"
# or API_GITLAB_CODE_MANAGEMENT_WEBHOOK="https://kodus-api.yourdomain.com/gitlab/webhook"
# or GLOBAL_BITBUCKET_CODE_MANAGEMENT_WEBHOOK="https://kodus-api.yourdomain.com/bitbucket/webhook"
```

<Note>
  As URLs de webhook devem alcançar o serviço de Webhooks (porta 3332). Use um domínio dedicado para webhooks ou roteie `/.../webhook` para a porta 3332 no seu proxy reverso.
</Note>

<Info>
  **O Modo Fixo é ideal para a Novita** porque fornece APIs compatíveis com OpenAI e requer apenas uma chave de API. Isso simplifica significativamente sua configuração.
</Info>

<Snippet file="deploy-installation.mdx" />

### 6. Configure o Proxy Reverso (Para Produção)

Para webhooks e acesso externo, configure o Nginx:

```nginx theme={null}
# Web App (port 3000)
server {
    listen 80;
    server_name kodus-web.yourdomain.com;
    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

# API (port 3001)  
server {
    listen 80;
    server_name kodus-api.yourdomain.com;
    location ~ ^/(github|gitlab|bitbucket|azure-repos)/webhook {
        proxy_pass http://localhost:3332;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location / {
        proxy_pass http://localhost:3001;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
```

### Verifique a Integração com a Novita

Além da verificação básica de instalação, confirme que a Novita está funcionando:

```bash theme={null}
# Verify Novita API connection specifically
docker-compose logs api worker | grep -i novita
```

<Tip>
  Para informações detalhadas sobre configuração de SSL, monitoramento e configurações avançadas, consulte nosso [guia completo de implantação](https://docs.kodus.io/docs/how_to_deploy/en/deploy_kodus/generic_vm).
</Tip>

### Solução de Problemas

<AccordionGroup>
  <Accordion title="Problemas com a Chave de API">
    * Verifique se sua chave de API está correta e ativa no [console da Novita](https://novita.ai/settings/key-management)
    * Verifique se você tem créditos suficientes em sua conta Novita
    * Certifique-se de que não há espaços extras no seu arquivo `.env`
  </Accordion>

  <Accordion title="Modelo Não Encontrado">
    * Verifique se o nome do modelo está escrito corretamente na sua configuração
    * Confirme se o modelo está disponível no seu plano Novita
    * Tente com um modelo diferente da nossa lista recomendada
  </Accordion>

  <Accordion title="Erros de Conexão">
    * Verifique se seu servidor tem acesso à internet para alcançar `api.novita.ai`
    * Verifique se há restrições de firewall
    * Revise os logs da API/worker para mensagens de erro detalhadas
  </Accordion>
</AccordionGroup>