Skip to main content

Como Conectar o Codex a APIs Externas em 2026

· 7 minutos de leitura
Felo Search Tips Buddy
Felo Search Tips Buddy
Committed to answers at your fingertips

Guia passo a passo para estender o Codex com busca, geração de PPT, memória LiveDocs e mais, usando uma única chave de API através do Felo OpenAPI.

O Codex é um poderoso agente de codificação por IA. Mas sem acesso a dados da web em tempo real, ferramentas de apresentação e memória persistente, ele fica limitado ao que já conhece. Conectar o Codex a APIs externas muda tudo.

O Que o Codex Precisa Além da Geração de Código​

O Codex é excelente em raciocinar sobre código, depurar e gerar soluções. O que ele não faz por padrão:

  • Busca na web em tempo real — não consegue obter informações atuais ou verificar afirmações em fontes recentes
  • Extração de páginas web — não lê URLs arbitrários nem extrai conteúdo estruturado
  • Sinais de redes sociais — sem acesso a dados do X (Twitter) ou transcrições do YouTube
  • Entregáveis de escritório — pode descrever uma apresentação, mas não gerar uma
  • Memória compartilhada — não possui um espaço de trabalho persistente para arquivos, URLs e contexto de equipe

Essas lacunas limitam o Codex a tarefas de código. Com APIs externas, ele se torna um agente de fluxo de trabalho completo.

A Solução: API do Codex via Felo OpenAPI​

O Felo OpenAPI dá ao Codex acesso a APIs de modelos, ferramentas, memória e capacidades de saída usando uma única chave de API. A configuração utiliza protocolos familiares que o Codex já entende.

Endpoints de API Que o Codex Pode Acessar​

APIs de Modelo:

GET /api/v1/models
POST /api/v1/chat/completions
POST /api/v1/messages
POST /api/v1/responses

APIs de Ferramentas:

POST /v2/chat              — Busca por IA
POST /v2/web/extract       — Busca na Web
POST /v2/x/tweet/search    — Busca no X
POST /v2/x/user/tweets     — Tweets de Usuário
GET /v2/youtube/subtitling — Legendas do YouTube
POST /v2/ppts              — Geração de PPT
POST /v2/mindmap           — Mapa Mental
POST /v2/landing_page      — Página de Lançamento
GET /v2/ppt-themes         — Temas de PPT

Tudo acessível por uma URL base e uma chave de API do Codex.

Passo 1: Obtenha Sua Chave de API​

Acesse as configurações do Felo OpenAPI e gere uma chave de API. Essa chave funciona em todas as APIs do Felo — chamadas de modelo, busca, PPT, LiveDocs, tudo.

Passo 2: Configure o Codex​

Abra o guia de configuração do Felo OpenAPI para o Codex em openapi.felo.ai/docs/agent-clients/codex. O guia mostra exatamente onde configurar:

  • Base URL — o endpoint do Felo OpenAPI
  • API key — a chave do Passo 1
  • Modelo — escolha entre os modelos disponíveis, incluindo GPT-5.6 Sol, GPT-5.6 Terra, Claude Opus 4.8, Claude Sonnet 4.6, Grok 4.5

Passo 3: Verifique a Conexão​

Execute o passo de verificação no guia de configuração. Ele envia uma requisição de teste e confirma que o Codex consegue acessar a API do Felo e retornar uma resposta.

O Que o Codex Pode Fazer Após a Conexão​

Camada de Modelo​

O Codex pode chamar múltiplos modelos através de protocolos padrão:

  • Chat Completions compatível com OpenAI — substituição direta para chamadas da API OpenAI
  • Messages compatível com Anthropic — funciona com requisições estruturadas do Claude
  • Responses API — para saída estruturada e chamadas de função
  • SuperAgent SSE — conversas em streaming para fluxos de trabalho complexos

Modelos disponíveis:

  • Claude Opus 4.8, Claude Sonnet 4.6, Claude Haiku 4.5
  • GPT-5.6 Sol, GPT-5.6 Terra
  • Grok 4.5

O menor custo permite que o Codex rode modelos mais potentes com mais frequência sem estourar o orçamento.

Camada de Busca e Dados​

  • Busca por IA — busca na web em tempo real com resultados estruturados via POST /v2/chat
  • Busca na Web — lê qualquer página e extrai conteúdo via POST /v2/web/extract
  • Busca no X — pesquisa usuários, tweets, rastreia sinais sociais via POST /v2/x/tweet/search
  • Legendas do YouTube — obtém transcrições de vídeos via GET /v2/youtube/subtitling

Agora o Codex pode pesquisar tópicos, verificar documentação em fontes ao vivo e obter contexto de redes sociais ou vídeos.

Camada de Saída​

  • API de PPT — gera apresentações temáticas via POST /v2/ppts
  • API de Mapa Mental — cria mapas visuais de estrutura via POST /v2/mindmap
  • API de Página de Lançamento — rascunha páginas de lançamento via POST /v2/landing_page
  • Geração de Imagens — cria ativos visuais

Memória LiveDocs​

O LiveDocs oferece ao Codex um espaço de trabalho compartilhado:

  • Faça upload de arquivos e adicione URLs como recursos
  • Recuperação semântica para encontrar contexto relevante
  • Tarefas, registros e comentários para colaboração

O Codex pode lembrar o que sua equipe salvou na semana passada e combinar com a pesquisa de hoje.

Fluxo de Trabalho Real: Codex Faz Pesquisa de Mercado​

Prompt: "Pesquise o mercado de agentes de codificação por IA e crie uma apresentação."

Codex:

  1. Chama a Search API (POST /v2/chat) para dados de mercado
  2. Chama o Web Fetch (POST /v2/web/extract) para ler relatórios de analistas
  3. Chama o X Search (POST /v2/x/tweet/search) para rastrear o sentimento do setor
  4. Salva as descobertas no LiveDocs com atribuição de fonte
  5. Chama a PPT API (POST /v2/ppts) para gerar um slide deck temático
  6. Retorna uma apresentação finalizada com fontes citadas

Fluxo de Trabalho Real: Codex Revisa um Projeto​

Prompt: "Revise este repositório de código de acordo com as melhores práticas atuais."

Codex:

  1. Lê os arquivos do projeto
  2. Busca a documentação e melhores práticas mais recentes
  3. Extrai páginas relevantes da documentação oficial
  4. Produz uma revisão respaldada por evidências recentes e com fontes

Por Que Isso Funciona Melhor do Que APIs Separadas​

Conectar o Codex ao Felo OpenAPI é mais limpo do que integrar serviços individuais:

  • Uma chave de API em vez de gerenciar contas em busca, PPT, provedores de memória
  • Uma URL base para todas as chamadas de ferramentas
  • Protocolos padrão — APIs compatíveis com OpenAI e Anthropic que o Codex já conhece
  • Menor custo — acesso aos melhores modelos por tarifas reduzidas
  • Memória integrada — LiveDocs armazena contexto entre sessões do Codex

Solução de Problemas​

Falha na Conexão​

Verifique se a URL base e a chave de API do Codex foram inseridas corretamente. A maioria dos problemas são erros de digitação no endpoint ou na chave.

Chamadas de Ferramentas Retornam Erros​

Certifique-se de que o Codex está configurado para chamar a API do Felo para execução de ferramentas. Algumas configurações de agente exigem habilitação explícita das ferramentas.

Respostas dos Modelos Estão Lentas​

Modelos potentes como o Claude Opus 4.8 levam mais tempo. Experimente o GPT-5.6 Terra ou o Claude Sonnet 4.6 para resultados mais rápidos em tarefas menos complexas.

Começando​

  1. Crie sua chave de API gratuita
  2. Abra o guia de configuração do Codex
  3. Configure, verifique e teste com um fluxo de trabalho real

O Codex mantém seu poder de codificação. O Felo adiciona as ferramentas que ele precisa para concluir trabalhos reais.

Conecte o Codex ao Felo OpenAPI →

Este post também está disponível em English, 简体中文, 日本語, 한국어, 繁體中文, हिन्दी, Français, العربية, Русский, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Türkçe, Italiano, ไทย, Español and বাংলা.