curl

Visao Geral

O Floopy expoe uma API REST compativel com a OpenAI. Voce pode chama-la diretamente com curl ou qualquer cliente HTTP — sem SDK necessario. Basta enviar requisicoes para https://api.floopy.ai/v1 com sua chave de API do Floopy no header Authorization.

Requisicao Basica

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": "Explain quantum computing in one sentence."}
    ]
  }'

Defina FLOOPY_API_KEY no seu ambiente. Voce pode criar uma no dashboard.

Troque de provedor alterando o nome do modelo — nenhuma outra mudanca necessaria:

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

Streaming

Adicione "stream": true ao corpo da requisicao e use --no-buffer para ver os tokens conforme chegam:

curl --no-buffer 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": "Write a short poem."}],
    "stream": true
  }'

Headers Personalizados

Adicione headers especificos do Floopy com -H:

curl https://api.floopy.ai/v1/chat/completions \
  -H "Authorization: Bearer $FLOOPY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Floopy-Cache: semantic" \
  -H "floopy-property-environment: production" \
  -H "floopy-property-feature: chat" \
  -H "floopy-fallback: claude-sonnet-4-20250514" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Header	Descricao
`Floopy-Cache`	Estrategia de cache: `semantic` ou `exact`
`floopy-property-*`	Anexe metadados personalizados para filtragem no dashboard
`floopy-fallback`	Modelo de fallback se o provedor principal falhar
`floopy-session-id`	Agrupe requisicoes relacionadas em uma sessao
`floopy-user-id`	Associe requisicoes a um usuario final

Headers de Resposta

Use -i para inspecionar os headers de resposta retornados pelo gateway:

curl -i 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"}]
  }'

# Response includes:
# Floopy-Provider: openai
# Floopy-Model: gpt-4o
# Floopy-Fallback-Used: false

Consulte a Referencia de Headers para a lista completa.