# Bu0y docs

> One key. Your usual tools. Point anything OpenAI-compatible at `https://api.bu0y.com/v1`.

- Site: https://bu0y.com
- API base: `https://api.bu0y.com/v1`
- Agent index: https://bu0y.com/llms.txt
- Full API dump: https://bu0y.com/llms-full.txt

## Get a key

1. Open https://bu0y.com/account.html
2. Create or unlock a passkey
3. Mint a `bu0y_…` key (shown once)
4. Add credits (card or Solana USDC, min $1 on Solana)

Agents without a passkey: Solana challenge → mint → deposit → sync. See `llms-full.txt`.

## Three fields every client needs

| Field | Value |
|-------|-------|
| Base URL | `https://api.bu0y.com/v1` |
| API key | your `bu0y_…` secret |
| Model | any id from [Models](https://bu0y.com/models.html) or `/v1/models` — you pick it; clients do not auto-fill |

Stop the base URL at `/v1`. Clients append `/chat/completions`.

## Cursor

1. Settings → Models
2. OpenAI API Key = your `bu0y_…` key
3. Override OpenAI Base URL = `https://api.bu0y.com/v1`
4. Add a model id from [Models](https://bu0y.com/models.html) (copy the id), then Verify

If it fails: Network → HTTP Compatibility Mode → HTTP/1.1. Ask mode is the reliable check for chat-completions gateways.

## Hermes

`hermes model` → Custom endpoint, or in `~/.hermes/config.yaml`:

```yaml
model:
  default: glm4.6
  provider: custom
  base_url: https://api.bu0y.com/v1
  api_key: bu0y_…
```

## OpenAI SDK

```js
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.BU0Y_KEY,
  baseURL: "https://api.bu0y.com/v1",
});
```

Python: `OpenAI(api_key=…, base_url="https://api.bu0y.com/v1")`.

## Anywhere else

If the tool says OpenAI compatible / custom provider / base URL, use the three fields above. That covers Cline, Continue, LibreChat, Open WebUI, LangChain, Vercel AI SDK, and most agent stacks.

```bash
curl https://api.bu0y.com/v1/chat/completions \
  -H "Authorization: Bearer $BU0Y_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"glm4.6","messages":[{"role":"user","content":"hi"}],"max_tokens":256}'
```

## Add credits

Prepaid, non-refundable, no withdraw. Card via Account / Stripe checkout, or Solana USDC to your deposit address then sync.

## Rules

- Prepaid only
- Nothing fills under the margin floor (503)
- Routing is source-blind
- Bu0y does not store prompts or completions. Billing metadata only. The marketplace that fills still receives the prompt.

## Full reference

https://bu0y.com/llms-full.txt