Pular para o conteúdo
quebragalho/docs

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

  1. 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_KEY
  2. Troque a base URL

    Aponte o SDK oficial da OpenAI para a nossa base. Nenhuma outra linha muda.

    https://api.quebragalho.dev/v1
  3. Rode

    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.

Gerenciar API keys

Próximos passos