Capítulo 1: Usando APIs de LLM

Como Aplicações se Conectam a LLMs

Quando você usa o ChatGPT pelo site, está utilizando uma interface de usuário. Mas como aplicativos, sites e serviços integram LLMs em seus produtos? Através de APIs.

---

O Que É uma API?

Definição simples

Uma API (Interface de Programação de Aplicações) é uma forma de diferentes aplicações de software se comunicarem entre si.

A Analogia do Restaurante

Pense em uma API como fazer um pedido em um restaurante:

Restaurante	API
Você (cliente)	Seu aplicativo
Cardápio	Documentação da API
Garçom	A própria API
Cozinha	O serviço de LLM
Seu pedido	Sua requisição de API
Sua comida	A resposta do LLM

Você não vai até a cozinha—você se comunica através do garçom (API), que leva seu pedido (requisição) para a cozinha (LLM) e traz sua comida (resposta).

---

ChatGPT vs. API

São formas diferentes de acessar a mesma tecnologia:

Aspecto	Site/App do ChatGPT	OpenAI API
Usuário	Usuários comuns	Desenvolvedores
Interface	Janela de chat	Código
Preço	Assinatura mensal	Pagamento por uso (tokens)
Personalização	Limitada	Extensa
Caso de uso	Produtividade pessoal	Construção de produtos

---

Como Funcionam as Chamadas de API

Um Fluxo Simplificado

O Que Vai em uma Requisição

1. Sua chave de API: Identifica e autentica você
2. O modelo: Qual LLM usar (ex.: gpt-4, claude-3)
3. O prompt: O que você quer que o LLM faça
4. Parâmetros: Configurações como temperatura, max tokens

O Que Volta

1. O texto gerado: A resposta do LLM
2. Informações de uso: Quantos tokens foram usados
3. Metadados: Versão do modelo, informações de tempo

---

Exemplo Simples de API (Conceitual)

Você não precisa programar, mas aqui está como uma chamada de API se parece:

// Conceptual example - not code to run
Request:
{
  "model": "gpt-4",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant"},
    {"role": "user", "content": "What is the capital of France?"}
  ],
  "temperature": 0.7
}

Response:
{
  "choices": [
    {"message": {"content": "The capital of France is Paris."}}
  ],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 8,
    "total_tokens": 33
  }
}

---

Principais Provedores de API

OpenAI API

• Modelos: GPT-4, GPT-3.5-turbo
• Pontos fortes: Mais popular, bem documentada
• Acesso: api.openai.com

Anthropic API

• Modelos: Claude 3 (Opus, Sonnet, Haiku)
• Pontos fortes: Contexto longo, foco em segurança
• Acesso: anthropic.com

Google AI

• Modelos: Gemini Pro, Gemini Ultra
• Pontos fortes: Multimodal, integração com Google
• Acesso: ai.google.dev

Azure OpenAI

• Modelos: Os mesmos da OpenAI, via Microsoft
• Pontos fortes: Recursos corporativos, conformidade
• Acesso: azure.microsoft.com

---

Opções No-Code

Você não precisa ser desenvolvedor para usar APIs de LLM!

Ferramentas No-Code

Ferramenta	O Que Faz
Zapier	Conecta LLMs a outros apps sem código
Make (Integromat)	Automação visual com IA
LangFlow	Programação visual para apps com LLM
ChatGPT GPT Builder	Crie GPTs personalizados sem programar

Plataformas Low-Code

Plataforma	Caso de Uso
Microsoft Power Platform	Automação corporativa
Bubble	Web apps com IA
Retool	Ferramentas internas

---

Conceitos-Chave de API

Autenticação

Sua chave de API é como uma senha—mantenha em segredo!

Limites de Taxa (Rate Limits)

Limites de requisições por minuto para evitar sobrecarga:

• Planos gratuitos: ~3 requisições/minuto
• Planos pagos: ~60+ requisições/minuto

Endpoints

URLs diferentes para funções diferentes:

• /chat/completions - Respostas de chat
• /embeddings - Texto para números
• /audio/transcriptions - Áudio para texto

Streaming

Receber respostas palavra por palavra conforme são geradas (como o ChatGPT digitando).

---

Casos de Uso Comuns

1. Bots de Suporte ao Cliente

• Integração em site ou app
• Responde dúvidas frequentes
• Escala questões complexas

2. Geração de Conteúdo

• Rascunhos de e-mail
• Textos de marketing
• Descrições de produtos

3. Processamento de Dados

• Resumir documentos
• Extrair informações
• Categorizar conteúdo

4. Assistência em Código

• Gerar trechos de código
• Explicar código
• Corrigir bugs

---

Escolhendo Entre Consumidor e API

Escolha Consumidor (ChatGPT/Claude) Quando...	Escolha API Quando...
Uso pessoal	Construindo um produto
Uso ocasional	Precisa de automação
Explorando IA	Alto volume
Tarefas simples	Integração personalizada

---

Principais Aprendizados

✅ APIs permitem que aplicações se comuniquem com serviços de LLM

✅ ChatGPT é para consumidores; APIs são para construir produtos

✅ Chamadas de API incluem sua chave, escolha de modelo, prompt e configurações

✅ Ferramentas no-code tornam APIs acessíveis para não desenvolvedores

✅ Limites de taxa e autenticação são considerações importantes

---

Reflita

1. Que tipo de aplicação você criaria se tivesse acesso à API de um LLM?
2. Por que uma empresa usaria a API em vez de apenas pedir aos funcionários para usarem o ChatGPT?
3. Que preocupações de segurança podem surgir ao usar chaves de API?

---

Próximos Passos

Agora vamos entender os custos envolvidos em Capítulo 2: Tokens e Preços.