Skip to main content
POST
https://sac-waffle-v2.theo-110.workers.dev
/
openai
/
chat
curl -X POST https://sac-waffle-v2.theo-110.workers.dev/openai/chat \
  -H "Authorization: Bearer seu_token_jwt" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Explique o que é uma newsletter em 2 frases"
  }'

{
  "success": true,
  "data": {
    "content": "Uma newsletter é uma publicação periódica enviada por email para assinantes com conteúdo relevante sobre temas específicos. Ela permite que empresas e criadores mantenham contato direto com seu público, compartilhando notícias, insights e atualizações de forma regular.",
    "usage": {
      "promptTokens": 18,
      "completionTokens": 52,
      "totalTokens": 70
    },
    "finishReason": "stop"
  }
}

​
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:
Você é um assistente útil que responde em português brasileiro.
Seja conciso e direto nas respostas.
​
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
curl -X POST https://sac-waffle-v2.theo-110.workers.dev/openai/chat \
  -H "Authorization: Bearer seu_token_jwt" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Explique o que é uma newsletter em 2 frases"
  }'

{
  "success": true,
  "data": {
    "content": "Uma newsletter é uma publicação periódica enviada por email para assinantes com conteúdo relevante sobre temas específicos. Ela permite que empresas e criadores mantenham contato direto com seu público, compartilhando notícias, insights e atualizações de forma regular.",
    "usage": {
      "promptTokens": 18,
      "completionTokens": 52,
      "totalTokens": 70
    },
    "finishReason": "stop"
  }
}

​
Use Cases

​
📝 Geração de Conteúdo

{
  "prompt": "Escreva um parágrafo sobre os benefícios de ler newsletters diárias",
  "temperature": 0.8
}

​
💡 Respostas Técnicas

{
  "prompt": "Explique o conceito de webhooks em programação",
  "temperature": 0.3,
  "maxTokens": 500
}

​
📊 Análise de Dados

{
  "prompt": "Analise estes números de engajamento: Opens: 45%, Clicks: 12%, Unsubscribe: 0.5%",
  "systemPrompt": "Você é um analista de marketing digital",
  "model": "gpt-4o"
}

​
🔄 Tradução

{
  "prompt": "Traduza para inglês: 'Nosso boletim informativo é enviado toda manhã'",
  "temperature": 0.1
}

​
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