documentação
API
Compatível com a API da OpenAI: qualquer SDK ou ferramenta que fala com a OpenAI funciona trocando o endereço e a chave. As chaves são liberadas para quem entra no beta.
| Endereço base | https://api.nofluffbr.com/v1 |
|---|---|
| Modelos | Anunciados no lançamento; a lista sai em GET /v1/models |
| Autenticação | Cabeçalho Authorization: Bearer sk-… |
Python (SDK oficial da OpenAI)
from openai import OpenAI
client = OpenAI(base_url="https://api.nofluffbr.com/v1", api_key="sk-sua-chave")
r = client.chat.completions.create(
model="nome-do-modelo",
messages=[{"role": "user", "content": "Explique o que é uma API em 2 frases."}],
)
print(r.choices[0].message.content)
Streaming (stream=True) e chamada de ferramentas (tools=[…]) funcionam.
curl
curl https://api.nofluffbr.com/v1/chat/completions \
-H "Authorization: Bearer sk-sua-chave" \
-H "Content-Type: application/json" \
-d '{"model": "nome-do-modelo", "messages": [{"role": "user", "content": "Oi"}]}'
Agentes de programação
Ferramentas como o OpenCode funcionam com o provedor "compatível com OpenAI", apontando para o endereço base acima. Atenção ao custo: agentes reenviam um contexto grande a cada passo, e uma pergunta simples pode consumir dezenas de milhares de tokens de entrada.
Rotas
Só existem POST /v1/chat/completions e GET /v1/models. As demais rotas da API da OpenAI (completions, responses, embeddings, arquivos) respondem 404.
Limites
- Saldo: cada chave tem saldo em reais; acabou, as chamadas param.
- 60 requisições por minuto e 3 simultâneas por chave.
- Tamanho da resposta: padrão de 4.096 tokens; teto de 8.192.
- O conteúdo das chamadas não fica guardado; só a contagem de tokens, para cobrança.
Erros
| HTTP | Quando |
|---|---|
| 400 | Conteúdo proibido pela política de uso, ou conversa maior que o contexto do modelo |
| 401 | Chave inválida ou revogada |
| 402 | Saldo esgotado |
| 429 | Mais requisições que o limite |
| 502 / 503 | Modelo ou filtro temporariamente fora do ar (não é cobrado) |
As mensagens de erro vêm em português, no campo error.message.