Python

Visao Geral

O Floopy e um gateway sem SDK. Voce nao precisa instalar uma biblioteca especifica do Floopy. Basta apontar o SDK padrao da OpenAI para Python para https://api.floopy.ai/v1 e usar sua chave de API do Floopy. Todos os recursos — cache, rate limiting, fallbacks, observabilidade — funcionam automaticamente atraves de headers.

pip install openai

poetry add openai

Configuracao

from openai import OpenAI
import os

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

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

Requisicao Basica

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "Explain quantum computing in one sentence."}
    ],
)

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

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

# Anthropic
response = client.chat.completions.create(
    model="claude-sonnet-4-20250514",
    messages=[{"role": "user", "content": "Hello!"}],
)

Streaming

stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Write a short poem."}],
    stream=True,
)

for chunk in stream:
    content = chunk.choices[0].delta.content
    if content:
        print(content, end="")

Headers Personalizados

Passe headers especificos do Floopy usando extra_headers:

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello"}],
    extra_headers={
        "Floopy-Cache": "semantic",
        "floopy-property-environment": "production",
        "floopy-property-feature": "chat",
        "floopy-fallback": "claude-sonnet-4-20250514",
    },
)

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

Consulte a Referencia de Headers para a lista completa.