Docs How to use Bu0y

One key. Your usual tools.

Bu0y speaks the OpenAI chat API. Get a bu0y_… key, add credits, then point Cursor, Hermes, or any compatible client at https://api.bu0y.com/v1.

Base URL https://api.bu0y.com/v1

No. 01 Get a key

Humans first

Open Account and create or unlock a passkey.
Mint an API key. Copy the bu0y_… secret once. It is not shown again.
Add credits with card or Solana USDC (minimum $1 on Solana).
Paste the key into your tool. Set the base URL below.

Open Account

Agents (no passkey)

Sign a Solana challenge, mint a key, fund the deposit address, then sync. Full flow in llms-full.txt or the home page agent panel.

No. 02 Plug it in

Three numbers to remember

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

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

No. 03 Cursor

Override the OpenAI endpoint

Open Cursor Settings → Models.
Turn on OpenAI API Key and paste your bu0y_… key.
Turn on Override OpenAI Base URL and set https://api.bu0y.com/v1.
Add a model id from Models (copy the id), then Verify.

If the connection fails, try Network → HTTP Compatibility Mode → HTTP/1.1. Some Cursor Agent paths use OpenAI’s Responses shape; Ask mode is the reliable check for a chat-completions gateway.

No. 04 Hermes

Custom endpoint

Hermes accepts any OpenAI-compatible server. Easiest path: hermes model → Custom endpoint → enter base URL, key, and model.

# ~/.hermes/config.yaml
model:
  default: glm4.6
  provider: custom
  base_url: https://api.bu0y.com/v1
  api_key: bu0y_…

Leave the base URL at /v1. Hermes appends /chat/completions.

No. 05 OpenAI SDK

Change two fields

import OpenAI from "openai";

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

const res = await client.chat.completions.create({
  model: "glm4.6",
  messages: [{ role: "user", content: "hi" }],
  max_tokens: 256,
});

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

No. 06 Anywhere else

If it says “OpenAI compatible”

Look for Base URL / OpenAI Compatible / Custom provider. Use the three fields above. That covers Cline, Continue, LibreChat, Open WebUI, LangChain, Vercel AI SDK, and most agent stacks.

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
  }'

Free price check before a fill: POST /v1/quote with model, inputTokens, maxOutputTokens.

No. 07 Add credits

Prepaid only

Credits are non-refundable fill rights. No withdraw.

Card. From Account, or POST /v1/deposits/stripe/checkout with { "usd": 10 }.
Solana USDC. GET /v1/deposits/solana → send mainnet USDC to that address (≥ $1) → Check now / POST …/sync.

No. 08 Rules that matter

Short list

01

Prepaid

No tab. A fill that cannot reserve the worst case fails before it runs.
02

Floor or 503

Nothing fills under the margin floor.
03

Source-blind

Cheapest survivor wins. No private lane for a marketplace.
04

Prompts stay off our books

Bu0y does not store your prompts or completions. We keep billing metadata only. The marketplace that fills the request still receives the prompt to run it.

No. 09 Full reference

When you need every endpoint

Auth challenge details, deposit sync, error codes, and the complete route list live in the machine-readable dumps. Prefer those over scraping this page.

/llms.txt Short index
/llms-full.txt Full API and money rules
/docs.md Markdown twin of this page

Bu0y is not affiliated with any marketplace it quotes. Nothing on this site is investment advice.