Skip to main content
POST

Descrição

Endpoint para chat completion simples usando modelos GPT da OpenAI. Ideal para perguntas diretas, geração de texto e tarefas que não requerem tools ou contexto adicional.

Headers

Authorization
string
required
Bearer token JWT para autenticação
Content-Type
string
required
application/json

Body Parameters

prompt
string
required
Mensagem ou prompt para o modelo processarDicas:
  • Seja claro e específico
  • Forneça contexto quando necessário
  • Use exemplos para melhor resultado
systemPrompt
string
Instruções do sistema para configurar o comportamento do modeloExemplo:
model
string
default:"gpt-4o-mini"
Modelo GPT a ser usadoOpções:
  • gpt-4o-mini - Rápido e econômico (recomendado)
  • gpt-4o - Mais avançado
  • gpt-4-turbo - Versão anterior
  • gpt-3.5-turbo - Legacy, mais barato
temperature
number
default:"0.7"
Controla a criatividade das respostas (0.0 a 2.0)Valores comuns:
  • 0.0 - Determinístico, sempre a mesma resposta
  • 0.3 - Pouca variação
  • 0.7 - Balanceado (padrão)
  • 1.0 - Criativo
  • 1.5+ - Muito criativo, pode ser imprevisível
maxTokens
number
default:"4096"
Número máximo de tokens na respostaConsiderações:
  • 1 token ≈ 0.75 palavras
  • Limitar reduz custos
  • Máximo depende do modelo
responseFormat
object
Formato da resposta (opcional)

Response

success
boolean
required
Indica se a operação foi bem-sucedida
data
object

Use Cases

📝 Geração de Conteúdo

💡 Respostas Técnicas

📊 Análise de Dados

🔄 Tradução

Dicas de Otimização

  1. Reduza custos: Use gpt-4o-mini sempre que possível
  2. Cache respostas: Implemente cache para prompts repetidos
  3. Limite tokens: Defina maxTokens apropriado para sua necessidade
  4. Temperature baixa: Para tarefas factuais, use 0.0-0.3
  5. Batch requests: Agrupe múltiplas perguntas em um prompt quando possível