Primeiros passos

O Felo API Platform oferece uma única chave para ferramentas de agente, protocolos de modelo e as APIs Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page e SuperAgent. Comece aqui, escolha a ferramenta que você usa e siga o guia de configuração dedicado a ela.

É novo por aqui? Leia a visão geral da plataforma para entender como a Model API, a Data API e as Felo APIs se encaixam, ou vá direto para Protocolos e SDKs e Canais e roteamento de provedores.

Configure o Codex ou o Claude Code com a CLI

Com o Node.js 22+ e sua ferramenta de IA instalados, execute:

npx feloapi-cli setup

Siga as instruções para colar sua chave de API Felo completa e escolher modelos, Skills ou ambos. Depois inicie sua ferramenta com npx feloapi-cli run codex ou npx feloapi-cli run claude-code.

Instalação e uso da CLI

Fluxo de início rápido

1. Obtenha uma chave do Felo API Platform e compre créditos de serviço quando necessário; nenhuma assinatura é exigida.
2. Escolha sua ferramenta ou plataforma de IA na tabela abaixo.
3. Abra o guia de configuração correspondente e cole a URL base e a chave de API da Felo.
4. Execute uma tarefa pequena na ferramenta para confirmar a conexão.
5. Adicione APIs de fluxo de trabalho quando seu agente precisar de busca, saída de escritório, extração web, fluxos de imagem, LiveDocs ou SuperAgent.

Etapa 1: obtenha sua chave de API

O Felo API Platform usa uma única chave de API tanto em chamadas diretas à API quanto nas ferramentas de IA compatíveis.

1. Abra a página de chaves de API do Felo API Platform.
2. Entre com sua conta Felo se for solicitado.
3. Informe um nome para a chave e clique em Create Key.
4. Copie a chave completa quando ela aparecer. Ela é exibida apenas uma vez.
5. Guarde a chave com segurança e use-a como FELO_API_KEY.

Recarregue conforme o uso em Console Billing a partir de $1. Você compra créditos de serviço denominados em dólares para o uso real da API. Nenhuma assinatura é exigida.

Defina a chave como variável de ambiente:

export FELO_API_KEY="YOUR_API_KEY"

Windows PowerShell:

$env:FELO_API_KEY="YOUR_API_KEY"

Etapa 2: escolha sua ferramenta de IA

Clique na ferramenta que você quer usar. Cada link abre um guia de configuração dedicado com a URL base correta, as variáveis de ambiente e o passo de verificação.

Etapa 3: use a URL base correta

A maioria das ferramentas pede três valores: chave de API, URL base e nome do modelo. Escolha a URL base de acordo com o protocolo compatível com a ferramenta.

Se você não tem certeza de qual modo seu cliente oferece suporte, comece pela URL base compatível com OpenAI. Use a URL base compatível com Anthropic para o Claude Code ou para clientes que pedem explicitamente um endpoint Anthropic Messages.

Etapa 4: verifique com uma chamada direta à API

Se você só quer confirmar que sua chave funciona, chame a Chat API diretamente.

curl -X POST https://openapi.felo.ai/v2/chat \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Research the latest AI agent product trends"
  }'

Uma resposta bem-sucedida inclui uma resposta, a análise da consulta e recursos da web.

{
  "status": "ok",
  "data": {
    "id": "HabCj883yHLSXc8mWqu4Eq",
    "message_id": "18ea8517-5559-4f48-a355-1f8a79e73b71",
    "answer": "...",
    "query_analysis": {
      "queries": ["AI agent product trends"]
    },
    "resources": [
      {
        "link": "https://example.com/report",
        "title": "AI Agent Market Report",
        "snippet": "..."
      }
    ]
  }
}

Etapa 5: adicione APIs de fluxo de trabalho

Depois que sua primeira ferramenta ou chamada de API funcionar, conecte as APIs que correspondem ao seu cenário.

Exemplos de chamada direta à API

Se você está construindo diretamente contra a API em vez de configurar uma ferramenta de IA, comece por uma destas chamadas mínimas.

Criar uma tarefa de PPT

Use a PPT Task API quando quiser gerar uma apresentação de slides de forma assíncrona. A resposta retorna um task_id que você pode consultar.

curl -X POST https://openapi.felo.ai/v2/ppts \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Create a 5-slide strategy deck about AI agents for office productivity"
  }'

Exemplo de resposta:

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
    "livedoc_short_id": "PvyKouzJirXjFdst4uKRK3",
    "ppt_business_id": "BfLPuQKmChk9SPmyQawxgr"
  }
}

Consulte o status da tarefa:

curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
  -H "Authorization: Bearer $FELO_API_KEY"

Criar uma tarefa de landing page

Use a Landing Page Task API quando quiser que a Felo gere uma landing page a partir de um prompt.

curl -X POST https://openapi.felo.ai/v2/landing_page \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Generate a launch landing page for an AI research assistant"
  }'

Exemplo de resposta:

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
    "thread_short_id": "9qiLTmT77fA3aVurrMHvRJ"
  }
}

Consulte o mesmo endpoint de status usado pelas tarefas de PPT:

curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
  -H "Authorization: Bearer $FELO_API_KEY"

Python

import os
import requests

api_key = os.environ["FELO_API_KEY"]

response = requests.post(
    "https://openapi.felo.ai/v2/chat",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={"query": "What are the latest AI agent product trends?"},
    timeout=60,
)

response.raise_for_status()
print(response.json()["data"]["answer"])

JavaScript (Node.js)

const response = await fetch("https://openapi.felo.ai/v2/chat", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FELO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query: "What are the latest AI agent product trends?",
  }),
});

if (!response.ok) {
  throw new Error(`Felo API request failed: ${response.status}`);
}

const result = await response.json();
console.log(result.data.answer);

Problemas comuns de configuração

Próximos passos

• Configurar o Codex
• Configurar o Claude Code
• Guia de autenticação
• Referência da LLM API
• Referência da Chat API
• Referência da SuperAgent API