Getting Started

1. Crie Sua Conta

Cadastre-se em app.floopy.ai/signup — e gratuito e nao e necessario cartao de credito. O fluxo de onboarding criara sua organizacao automaticamente.

2. Adicione um Provider

Acesse Settings > Providers no dashboard e adicione pelo menos uma chave de API de um provider de LLM (OpenAI, Anthropic, Google Gemini, etc.). Essa e a chave que o Floopy usa para chamar o provider em seu nome.

1. Clique em Add provider.
2. Selecione um provider da lista.
3. Cole sua chave de API do provider.
4. Clique em Save.

Sua chave do provider e criptografada em repouso e nunca mais sera exibida apos salvar.

3. Crie uma API Key

Acesse Settings > API Keys e crie uma API key do Floopy. Essa e a chave que sua aplicacao usa para se autenticar com o gateway.

1. Clique em Create API key.
2. De um nome para a chave (ex: dev-local).
3. Copie a chave imediatamente — ela sera exibida apenas uma vez.

4. Faca Sua Primeira Requisicao

Aponte seu codigo existente para https://api.floopy.ai/v1 e use sua API key do Floopy. Nenhuma alteracao de SDK e necessaria.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.floopy.ai/v1",
  apiKey: process.env.FLOOPY_API_KEY,
});

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "Hello from Floopy!" }],
});

console.log(response.choices[0].message.content);

from openai import OpenAI

client = OpenAI(
    base_url="https://api.floopy.ai/v1",
    api_key=os.environ["FLOOPY_API_KEY"],
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello from Floopy!"}],
)

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

curl https://api.floopy.ai/v1/chat/completions \
  -H "Authorization: Bearer $FLOOPY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello from Floopy!"}]
  }'

5. Verifique no Dashboard

Abra a pagina Requests no dashboard. Voce deve ver sua requisicao listada com:

• Model — o modelo que processou a requisicao (ex: gpt-4o)
• Provider — qual provider foi chamado (ex: OpenAI)
• Latency — tempo de resposta ponta a ponta em milissegundos
• Tokens — contagem de tokens de prompt e completion
• Cost — custo estimado com base nos precos do provider

Clique em qualquer linha para ver o payload completo da requisicao e resposta, headers e status do cache.

Proximos Passos

• Routing — controle qual provider e modelo processa cada requisicao
• Caching — reduza latencia e custo com cache exato e semantico
• Firewall — bloqueie injecoes de prompt e conteudo nocivo
• Prompts — gerencie e versione templates de prompt
• Headers Reference — lista completa de headers de requisicao e resposta do Floopy