Começar
Primeira chamada
Chat completions no formato da OpenAI. Se o seu código já fala com a OpenAI, trocar a base URL e a key é a migração inteira.
Sua primeira chamada
Crie uma key
Em API keys, no painel. Guarde na variável do terminal; a key começa com
qg-sk-.export QUEBRAGALHO_API_KEY=qg-sk-SUA_KEYTroque a base URL
Aponte o SDK oficial da OpenAI para a nossa base. Nenhuma outra linha muda.
https://api.quebragalho.dev/v1Rode
curl https://api.quebragalho.dev/v1/chat/completions \ -H "Authorization: Bearer $QUEBRAGALHO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6.2-astra", "messages": [{"role": "user", "content": "explica RAG em 3 linhas"}] }'O saldo é descontado por token, ao fim da resposta. Sem conta ainda? Crie a sua e a key sai na hora.
Uma key por projeto
A key vai no header Authorization: Bearer. Crie uma para cada projeto: se uma vazar, você revoga só ela.
- Mostrada uma vez. Guardamos só o hash. Perdeu, gera outra.
- Para trocar, crie a nova, troque no projeto e revogue a antiga.
- Nunca no git nem no front-end. Use variável de ambiente.