# Manual: Configurar Chave da OpenAI para Gerar Descrições de Imóveis

Este sistema usa a API da OpenAI para gerar descrições automáticas de imóveis usando Inteligência Artificial.

---

## Passo 1: Criar Conta na OpenAI

1. Acesse o site: **https://platform.openai.com/**
2. Clique em **"Sign Up"** para criar uma conta
3. Você pode criar usando seu e-mail ou conta Google/Microsoft
4. Complete o cadastro

---

## Passo 2: Adicionar Método de Pagamento

A OpenAI cobra por uso da API. Para gerar descrições, o custo é muito baixo (cerca de R$ 0,01 por descrição).

1. Acesse **https://platform.openai.com/account/billing**
2. Clique em **"Add payment method"**
3. Adicione seu cartão de crédito (aceita os principais cartões)
4. **Importante:** Não é necessário pagar antecipado - você só paga pelo que usar

---

## Passo 3: Gerar a Chave de API

1. Acesse **https://platform.openai.com/api-keys**
2. Clique no botão **"Create new secret key"**
3. Dê um nome para identificar (ex: "Gestão Imobiliária")
4. Clique em **"Create secret key"**
5. **IMPORTANTE:** Copie a chave mostrada - ela só aparece uma vez!
6. A chave começa com `sk-`

---

## Passo 4: Cadastrar a Chave no Sistema

1. Acesse o menu **Empresas**
2. Clique em **Editar** na sua empresa
3. Vá para a seção **Integrações**
4. No campo **OpenAI API Key**, cole a chave (começa com `sk-`)
5. Clique em **Salvar**

---

## Passo 5: Testar

1. Acesse um imóvel no sistema
2. Clique no botão **"Gerar com IA"**
3. Aguarde alguns segundos
4. A descrição será gerada automaticamente!

---

## Custos e Limites

- **Modelo usado:** gpt-4o-mini (mais econômico)
- **Custo médio:** R$ 0,01 a R$ 0,03 por descrição
- **Limite de caracteres:** 1000 por descrição

---

## Problemas Comuns

| Problema | Solução |
|----------|--------|
| "Chave da API não configurada" | Cadastre a chave conforme Passo 4 |
| "Erro ao chamar API" | Verifique se a chave está correta |
| "Saldo insuficiente" | Adicione método de pagamento na OpenAI |

---

## Suporte

Se precisar de ajuda, entre em contato com o suporte técnico.

---

*Manual atualizado em 30/04/2026*
*Feito por Joel Alexandre da Rosa Realino - Itajubá/MG*