Capítulo 1: APIs e Integração

Conectando-se a Serviços de IA

APIs são a porta de entrada para integrar capacidades de IA em suas aplicações. Entender como trabalhar com APIs de IA é essencial para construir produtos com inteligência artificial.

---

Principais APIs de IA

Provedor	API Principal	Principais Características
OpenAI	GPT-4, DALL-E	Mais popular, abrangente
Anthropic	Claude	Foco em segurança, contexto longo
Google	Gemini	Integração com Google
Hugging Face	Múltiplas	Modelos open source
Cohere	Command	Foco em empresas

---

Noções Básicas da API da OpenAI

Autenticação

from openai import OpenAI

client = OpenAI(api_key="your-api-key")

Chat Básico

response = client.chat.completions.create(
    model="gpt-4",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "What is machine learning?"}
    ]
)

print(response.choices[0].message.content)

Principais Parâmetros

Parâmetro	Finalidade
model	Qual modelo utilizar
messages	Histórico da conversa
temperature	Criatividade (0-2)
max_tokens	Limite de tamanho da resposta

---

API da Anthropic (Claude)

Uso Básico

import anthropic

client = anthropic.Anthropic(api_key="your-api-key")

message = client.messages.create(
    model="claude-3-sonnet-20240229",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ]
)

---

Limites de Uso e Cotas

Entendendo os Limites

• Requests per minute (RPM): Chamadas de API permitidas
• Tokens per minute (TPM): Volume de texto permitido
• Tokens per day (TPD): Limites diários

Lidando com Limites de Uso

import time
from openai import RateLimitError

def call_with_retry(func, max_retries=3):
    for attempt in range(max_retries):
        try:
            return func()
        except RateLimitError:
            time.sleep(2 ** attempt)
    raise Exception("Max retries exceeded")

---

Considerações sobre Preços

Preço Baseado em Tokens

Modelo	Entrada	Saída
GPT-4	$30/1M tokens	$60/1M tokens
GPT-3.5	$0.50/1M	$1.50/1M
Claude 3 Sonnet	$3/1M	$15/1M

Estimativa de Custos

Tokens por requisição × Requisições por dia × Dias × Preço por token

---

Boas Práticas de Segurança

Gerenciamento de Chaves de API

• Nunca faça commit de chaves no código
• Use variáveis de ambiente
• Gire as chaves regularmente
• Use chaves diferentes por ambiente

import os
api_key = os.environ.get("OPENAI_API_KEY")

---

Principais Pontos

✅ APIs permitem a integração de IA em aplicações

✅ Diferentes provedores têm diferentes pontos fortes

✅ Limites de uso e custos exigem planejamento

✅ Gerenciamento seguro de chaves é essencial

---

Próximos Passos

Continue para Capítulo 2: Construindo Aplicações com IA.