Guias
Visão geral da plataforma
Veja como Model API, Data API e Felo APIs se encaixam e por qual começar.
O Felo API Platform oferece uma única chave de API para três superfícies de requisição diferentes. Elas compartilham a mesma conta, os mesmos créditos e a mesma chave, mas resolvem problemas distintos e usam URLs base diferentes.
As três superfícies
| Superfície | URL base | Use para | Referência |
|---|---|---|---|
| Model API | https://openapi.felo.ai/api/v1 (compatível com OpenAI) e https://openapi.felo.ai/api (compatível com Anthropic) | Chamar diretamente um modelo de linguagem, imagem, vídeo ou decisão | Model API |
| Data API | https://openapi.felo.ai/v1/beta | Chamar provedores nomeados de dados e de busca de terceiros | Data API |
| Felo APIs | https://openapi.felo.ai/v2 | Usar os fluxos de busca, escritório, conteúdo, extração e conhecimento da própria Felo | Referência da Felo API |
Qual superfície devo usar?
| Quero… | Use |
|---|---|
| Executar um LLM a partir do meu próprio código ou de uma ferramenta de codificação com IA | Model API |
| Obter uma resposta com busca na web, citações e análise de consulta | Chat API (/v2/chat) |
| Gerar uma apresentação de slides, uma landing page, um mapa mental ou um vídeo | O endpoint de tarefa ou de modelo Felo correspondente |
| Criar uma base de conhecimento e recuperar informações dela | LiveDoc API |
| Chamar Tavily, Exa, Apollo ou outro provedor de dados nomeado | Data API |
| Fixar um modelo em um provedor upstream específico | Model API com X-Felo-Channel |
Configuração compartilhada
- Crie uma chave de API no console do Felo API Platform.
- Envie-a como
Authorization: Bearer $FELO_API_KEY. - Recarregue créditos de serviço denominados em dólares conforme usar a plataforma.
- Escolha a URL base da superfície que está chamando.
A mesma chave funciona em todas as superfícies documentadas aqui. Use chaves separadas para ambientes separados, assim você pode rotacionar uma sem afetar a outra.
O que a plataforma adiciona
- Uma chave em vez de uma conta separada em cada provedor de modelo e de dados.
- Um catálogo de modelos publicado com IDs de modelo, limites de contexto, protocolos e tarifas.
- Preços publicados dos fornecedores para modelos disponíveis por mais de um canal.
- Uso e cobrança consolidados em um único console.
Próximos passos
- Modelos e preços — leia o catálogo e estime uma requisição.
- Canais e roteamento de provedores — fixe um modelo em um provedor.
- Protocolos e SDKs — escolha entre compatível com OpenAI, Responses e Messages.
- Tarefas assíncronas — trate trabalhos de PPT, landing page, vídeo e exportação.
- Visão geral da Data API — chame endpoints de terceiros pelo prefixo compartilhado.