> Índice: https://quebragalho.dev/docs/llms.txt

# 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](https://app.quebragalho.dev/api-keys), no painel. Guarde na variável do terminal; a key começa com `qg-sk-`.

```bash
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.

```text
https://api.quebragalho.dev/v1
```

### 3. Rode

**cURL**

```bash
curl https://api.quebragalho.dev/v1/chat/completions \
  -H "Authorization: Bearer $QUEBRAGALHO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hy4-flash",
    "messages": [{"role": "user", "content": "explica RAG em 3 linhas"}]
  }'
```

**Python**

```python
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.quebragalho.dev/v1",
    api_key=os.environ["QUEBRAGALHO_API_KEY"],
)

resp = client.chat.completions.create(
    model="hy4-flash",
    messages=[{"role": "user", "content": "explica RAG em 3 linhas"}],
)
print(resp.choices[0].message.content)
```

**Node.js**

```ts
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.quebragalho.dev/v1",
  apiKey: process.env.QUEBRAGALHO_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "hy4-flash",
  messages: [{ role: "user", content: "explica RAG em 3 linhas" }],
});
console.log(resp.choices[0].message.content);
```

O saldo é descontado por token, ao fim da resposta. Sem conta ainda? [Crie a sua](https://app.quebragalho.dev/register) 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](https://app.quebragalho.dev/api-keys)

## Próximos passos

- [Use no seu agente](https://quebragalho.dev/docs/integracoes.md): QGCLI, Claude Code, Codex, Copilot e outros, cada um com o passo a passo dele.
- [Respostas em tempo real](https://quebragalho.dev/docs/api/chat-completions.md#streaming): Streaming por SSE, com heartbeat para a conexão não cair.
- [Pague menos em conversas longas](https://quebragalho.dev/docs/api/chat-completions.md#conversas): Um ID por conversa mantém o cache do modelo aquecido.

Versão para ler no navegador: https://quebragalho.dev/docs/quickstart
