Como Chamar uma API e Escolher uma Plataforma de API

Já abordamos conceitos essenciais como API, Token e Temperature. Agora é hora da parte prática: Como chamar uma API de verdade?

Muitas pessoas acham que APIs são misteriosas, mas, depois que você entende alguns elementos-chave, chamar uma API é tão simples quanto fazer compras online. Este capítulo vai guiá-lo passo a passo.

Três Elementos Essenciais para Chamar uma API

Não importa qual ferramenta ou plataforma você use, chamar uma API de IA requer estas três coisas:

1. Chave de API

Chave de API = Sua identificação

Assim como você precisa de uma senha para sacar dinheiro no banco, chamar uma API exige uma Chave de API para provar “Sou eu, pode me atender”.

Como é uma Chave de API?

Geralmente é uma longa sequência de letras e números, por exemplo:

sk-REPLACE_WITH_YOUR_API_KEY

Lembrete Importante:

As chaves de API são privadas; não as compartilhe com outras pessoas.
Se alguém conseguir sua chave, poderá usar sua conta para chamar APIs (gastando seu dinheiro).
Se vazar acidentalmente, exclua imediatamente a chave antiga na plataforma e gere uma nova.

2. URL Base

URL Base = O endereço do restaurante

Quando você pede comida por delivery, precisa saber onde o restaurante fica. Ao chamar uma API, você precisa saber onde o servidor está.

URLs Base Comuns:

OpenAI: https://api.openai.com/v1
Anthropic Claude: https://api.anthropic.com/v1
Google Gemini: https://generativelanguage.googleapis.com/v1
DeepSeek: https://api.deepseek.com/v1

Plataformas de terceiros têm URLs diferentes, mas o formato é semelhante.

3. Nome do Modelo

Nome do Modelo = O prato que você quer pedir

Em um restaurante, você diz “Quero carne de porco cozida”. Ao chamar uma API, você diz “Quero usar o GPT-5.2”.

Nomes de Modelos Comuns:

OpenAI: gpt-5.2, gpt-5.2-chat-latest
Claude: claude-opus-4.5, claude-sonnet-4.5
Gemini: gemini-3-pro, gemini-3-flash
DeepSeek: deepseek-chat, deepseek-coder

Um Exemplo Completo de Chamada de API

Combine essas três coisas, e a chamada de API mais simples fica assim:

import openai

# 1. Set the API Key
openai.api_key = "sk-proj-YOUR_API_KEY"

# 2. Set the Base URL (if you use a third-party platform)
openai.base_url = "https://api.openai.com/v1"

# 3. Call the selected model
response = openai.chat.completions.create(
    model="gpt-5.2",  # Model Name
    messages=[
        {"role": "user", "content": "Hello"}
    ]
)

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

Parece complicado? Não se preocupe, as plataformas apresentadas a seguir têm métodos mais simples.

API Oficial vs. Plataformas de Terceiros

Antes de apresentar plataformas específicas, vamos esclarecer um conceito importante: Qual a diferença entre APIs oficiais e plataformas de terceiros?

API Oficial

API Oficial = Comprar diretamente da OpenAI, Anthropic, Google

Vantagens:

Melhor estabilidade, conexão direta com os servidores oficiais
Funcionalidades completas, novos recursos são suportados imediatamente
Máxima segurança, os dados não passam por terceiros

Desvantagens:

Exige um cartão de crédito internacional
Requer VPN para acessar (ChatGPT, Claude, Gemini)
Preços relativamente mais altos
O registro pode ter barreiras

Plataformas de Terceiros

Plataformas de Terceiros = Comprar de revendedores

Plataformas de terceiros compram cotas de API dos oficiais e as revendem para você.

Vantagens:

Aceitam pagamentos nacionais (Alipay, WeChat Pay, UnionPay)
Não precisam de VPN
Geralmente têm interface e atendimento em chinês
Uma plataforma pode chamar várias IAs (OpenAI, Claude, Gemini, etc.)
Algumas plataformas oferecem créditos gratuitos

Desvantagens:

A estabilidade pode não ser tão boa quanto a oficial
Os preços podem ser ligeiramente mais altos que os oficiais (mas alguns são mais baratos)
A segurança depende da confiança na plataforma
As atualizações de recursos podem ficar atrás das oficiais

Qual Escolher?

Escolha o oficial se você:

Tem um cartão de crédito internacional
Tem uma VPN estável
Valoriza a segurança dos dados
Precisa dos recursos mais recentes

Escolha terceiros se você:

Não tem métodos de pagamento internacionais
Não tem VPN
Quer usar pagamentos nacionais
Quer chamar várias IAs de uma única plataforma

Recomendações de Plataformas (2 Nacionais + 2 Internacionais)

Abaixo estão quatro plataformas de API que recomendo, duas nacionais e duas internacionais, cobrindo diferentes necessidades.

1. DeepSeek Oficial (Nacional, Plataforma Oficial)

Site: https://platform.deepseek.com

Tipo de Plataforma: Plataforma Oficial

Por que Recomendar?

Plataforma oficial, estável e confiável
O desempenho do DeepSeek V3.2 é próximo ao do GPT-5
Acesso rápido na China, sem necessidade de VPN
Registro simples, apenas um número de telefone
Preço extremamente baixo, ótimo custo-benefício

Passos para Obter a Chave de API:

Acesse https://platform.deepseek.com
Clique em “Login/Register” no canto superior direito
Registre uma conta com seu número de telefone
Após o login, clique em “API Keys” à esquerda
Clique em “Create API Key”
Copie a chave (ela é mostrada apenas uma vez, então salve)
Clique em “Interface Documentation” à esquerda para ver a URL e o nome do modelo

Parâmetros de Chamada:

URL Base: https://api.deepseek.com
Nome do Modelo: deepseek-chat (chat), deepseek-reasoner (raciocínio)
Chave de API: A chave que você acabou de copiar

2. Volcano Engine (Nacional, Plataforma Oficial + Terceiros)

Site: https://console.volcengine.com/ark

Tipo de Plataforma: Plataforma Oficial (da ByteDance)

Por que Recomendar?

Plataforma oficial da ByteDance, estável e confiável
Suporta a série de modelos Doubao
Aceita pagamentos nacionais (Alipay, WeChat Pay, UnionPay)
Preço acessível, ótimo custo-benefício
Além dos modelos próprios do Doubao, também pode chamar muitos modelos open-source nacionais como DeepSeek V3.2, GLM 4.7

Passos de Uso:

Acesse https://console.volcengine.com/ark
Registre uma conta no Volcano Engine com seu número de telefone
Entre no console “Ark Large Model”
Complete a autenticação de identidade (requer RG)
Clique em “API Key Management”
Crie uma nova chave de API
Copie e salve a chave
Clique em “Activation Management” à esquerda, selecione o modelo que deseja usar
Na nova página, copie o nome do modelo necessário (atenção: o mesmo modelo pode ter nomes diferentes em plataformas diferentes, verifique com cuidado)
Volte à página “Activation Management”, verifique se o status é “Activated”; caso contrário, clique à direita para ativar as permissões do modelo

Parâmetros de Chamada:

URL Base: https://ark.cn-beijing.volces.com/api/v3
Nome do Modelo: doubao-pro-32k, doubao-lite-32k, etc.
Chave de API: A chave que você criou

Benefícios para Novos Usuários:

Créditos gratuitos ao se registrar
Você também pode participar da atividade mostrada acima da captura de tela para obter mais créditos gratuitos. Eu tenho mais do que suficiente todos os dias.

3. Google AI Studio (Internacional, Plataforma Oficial)

Site: https://aistudio.google.com

Tipo de Plataforma: Plataforma Oficial

Por que Recomendar?

Plataforma oficial do Google
Créditos gratuitos disponíveis (com limites)
Gemini 3 com desempenho de primeira linha
Estável e confiável
Suporta contexto extremamente longo (2 milhões de tokens)
Pode ser usado gratuitamente diretamente na interface web, sem necessidade de programação

Além disso, Como Usar a Versão Web Gratuitamente

Se você não quer programar, o Google AI Studio oferece uma interface de chat web muito conveniente, onde você pode usar diretamente modelos como Gemini 3 Pro e Gemini 3 Flash. É basicamente como ser um usuário pago do Gemini.

Passos de Uso:

Acesse https://aistudio.google.com
Faça login com sua conta do Google (requer VPN)
Clique em “Playground” à esquerda
No canto superior direito, selecione um modelo:
- gemini-3-pro: Melhor modelo, adequado para tarefas complexas
- gemini-3-flash: Modelo rápido, adequado para conversas do dia a dia
- Outros modelos experimentais disponíveis
Digite sua pergunta diretamente na caixa de entrada, depois clique em “Run”, e a IA responderá

Recursos Avançados (Versão Web):

1. Upload de Arquivos

Clique no ícone + à direita da caixa de entrada
Você pode enviar imagens, PDFs, documentos, etc.
Suporta compreensão multimodal

2. Ajustar Parâmetros

À direita, você pode ajustar os parâmetros introduzidos anteriormente
Você pode ajustar:
- Temperature (criatividade)
- Top P
- Max output tokens
- Configurações de segurança

Vantagens da Versão Web:

Sem necessidade de programação
Sem necessidade de instalação de software
Use diretamente no navegador
Interface amigável e recursos completos
Adequado para testes rápidos e uso diário

Para quem é a versão web?

Iniciantes completos que não sabem programar
Quem quer testar rapidamente as capacidades do Gemini
Conversas diárias e perguntas
Lidar com tarefas multimodais como documentos e imagens

Obter Chave de API (Para Usuários Avançados)

Voltando ao assunto principal, aqui está como obter uma Chave de API.

Passos para Obter a Chave de API:

Na página do AI Studio, clique em “Get API Key” à esquerda
Clique em “Create API Key”
Crie e copie a Chave de API gerada
Volte ao Playground, selecione e copie o nome do modelo à direita

Parâmetros de Chamada:

URL Base: https://generativelanguage.googleapis.com/v1beta
Nome do Modelo: gemini-3-flash-preview
Chave de API: A chave que você copiou

Limites do Nível Gratuito

Nota importante! O Google AI Studio usa o nível gratuito por padrão, com os seguintes limites (em janeiro de 2026), e esses limites estão sujeitos a alterações:

Requisições por minuto (RPM): 15
Requisições por dia (RPD): 1500
Tokens por minuto (TPM): 1 milhão de tokens

Veja os limites detalhados em: https://ai.google.dev/gemini-api/docs/rate-limits?hl=en

O nível gratuito é suficiente?

Chat web: Mais do que suficiente
Chamadas de API ocasionais: Suficiente
Chamadas automatizadas pesadas: Pode não ser suficiente

Como Remover os Limites? Vincule seus Créditos na Nuvem

O Google Cloud oferece US$ 10 em créditos gratuitos para novos usuários. Após vincular ao AI Studio, você pode desbloquear limites mais altos. Para detalhes sobre como configurar uma conta do Google Cloud, pesquise por “Google Cloud free credits” online — há muitos tutoriais. Não abordaremos isso aqui.

Passos para Vincular:

No AI Studio, volte à interface da API e clique em “Set up billing”
Vincule a conta de faturamento do Google Cloud que você criou anteriormente

Benefícios após vincular:

Limites de taxa aumentam significativamente (RPM até 1000+)
Créditos gratuitos ainda válidos
US$ 10 podem durar muito tempo com o poderoso modelo flash
Tanto a versão web quanto a API aproveitam cotas mais altas

4. OpenRouter (Internacional, Plataforma de Terceiros)

Site: https://openrouter.ai

Tipo de Plataforma: Plataforma de Terceiros

Por que Recomendar?

Uma plataforma para chamar todas as principais IAs (GPT, Claude, Gemini, etc.)
Preços transparentes, às vezes mais baratos que os oficiais
Aceita pagamento via Alipay (amigável para usuários chineses)
Aceita cartão de crédito e criptomoedas
Modelos gratuitos disponíveis para teste
Pode chamar praticamente todos os modelos disponíveis
Rankings são convincentes

Passos para Obter a Chave de API:

Acesse https://openrouter.ai
Clique em “Sign In” no canto superior direito, faça login com Google ou GitHub
Após o login, clique no seu avatar no canto superior direito e selecione “Keys”
Clique em “Create Key”
Dê um nome à chave e clique em criar
Copie a chave gerada
Pesquise o modelo desejado na caixa de busca e copie o nome

Parâmetros de Chamada:

URL Base: https://openrouter.ai/api/v1
Nome do Modelo:
- GPT-5.2: openai/gpt-5.2
- Claude Opus 4.5: anthropic/claude-opus-4.5
- Gemini 3 Pro: google/gemini-3-pro
- Modelo gratuito: meta-llama/llama-3.1-8b-instruct:free
Chave de API: A chave que você criou

Métodos de Recarga:

Alipay (mais conveniente)
Cartão de crédito
Criptomoeda (USDC, etc.)

Vantagem de Preço:

Alguns modelos são 10-20% mais baratos que os oficiais
Preços transparentes, veja os preços diretamente no site
Diferentes provedores competem, você escolhe o mais barato

Opções Gratuitas:

Alguns modelos são totalmente gratuitos (marcados com :free)
Novos usuários recebem créditos gratuitos para testar
Você pode testar primeiro com modelos gratuitos

Rankings de Modelos

Na página de Rankings, você pode ver os dados de chamadas de modelo da plataforma; os rankings são muito convincentes.

Outras Plataformas Gratuitas

Devido a limitações de espaço, aqui estão algumas outras plataformas que você pode usar gratuitamente:

Cerebras (Inferência Ultra-rápida)

Site: https://cloud.cerebras.ai

Recursos:

Inferência extremamente rápida (afirma ser a mais rápida do mundo)
Oferece chamadas gratuitas ao modelo Llama
Registro simples, basta fazer login com GitHub

NVIDIA NIM (Oficial da NVIDIA)

Site: https://build.nvidia.com

Recursos:

Plataforma oficial de IA da NVIDIA
Oferece vários modelos gratuitos
Adequado para testes e desenvolvimento

Ambas as plataformas oferecem créditos gratuitos. Se tiver interesse, pode se inscrever e testar.

Resumo

Três Elementos Essenciais:

Chave de API
URL Base
Nome do Modelo

Quatro Plataformas Recomendadas:

DeepSeek Oficial (Oficial) - Melhor escolha de baixo custo na China
Volcano Engine (Oficial + Terceiros) - Plataforma nacional, pode chamar a maioria dos modelos open-source nacionais
Google AI Studio (Oficial) - Melhor escolha gratuita internacionalmente (com Cloud Credits), pode ser usado diretamente na web
OpenRouter (Terceiros) - Plataforma all-in-one, aceita Alipay