KOMPUTE docs

Overview

Think of KOMPUTE as an exchange for API calls to AI models:

• Buyers get one API key and one base URL. Call it like OpenAI — the marketplace picks a live seller for the requested model.
• Sellers list any OpenAI-compatible endpoint, set a $/M input price, and receive that price on their balance when their offer is selected. The platform fee is a separate basis-point setting and starts at zero.
• Agents use the same key and base URL. x402 is a Base payment for agents that do not have an account. It uses the same chat URL.

The HTTP API is OpenAI-compatible at https://kompute-kompute.vercel.app/v1. Anything that speaks /v1/chat/completions can point here with a base-URL change.

Choose your path

Current snapshot

Counts from this server.

• 0 active seller offers · 1 buyer keys · test-credit balance $—
• GET https://kompute-kompute.vercel.app/v1/models — models from active offers
• GET https://kompute-kompute.vercel.app/api/state — account, keys, and offers
• GET https://kompute-kompute.vercel.app/healthz — service check

Quick start

1. Open Buy, add credits, create a key. Copy the secret once — it is not shown again.
2. Confirm a model exists: GET https://kompute-kompute.vercel.app/v1/models or list an offer on Sell.
3. Point any OpenAI-compatible client at https://kompute-kompute.vercel.app/v1 with your key.

curl

curl https://kompute-kompute.vercel.app/v1/chat/completions \
  -H "Authorization: Bearer kompute_…" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llama-3.3-70b",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Python (OpenAI SDK)

# pip install openai
from openai import OpenAI

client = OpenAI(
    base_url="https://kompute-kompute.vercel.app/v1",
    api_key="kompute_…",
)

reply = client.chat.completions.create(
    model="llama-3.3-70b",
    messages=[{"role": "user", "content": "Hello"}],
)
print(reply.choices[0].message.content)

Node (OpenAI SDK)

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://kompute-kompute.vercel.app/v1",
  apiKey: "kompute_…",
});

const reply = await client.chat.completions.create({
  model: "llama-3.3-70b",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(reply.choices[0].message.content);

API keys

Create keys in Buy. Each key draws from the shared prepaid balance and enforces its own daily cap.

The secret is shown once on Buy, right after you create the key. Store it on your server. The prefix in the table is safe to display.

Auth header:

Authorization: Bearer kompute_<secret>

A call without Authorization: Bearer returns HTTP 401. A funded key is required.

Models

Model ids come from active seller offers. Pause or delete an offer and it leaves the catalog.

• No active offers — list one on Sell.

curl https://kompute-kompute.vercel.app/v1/models

{
  "object": "list",
  "data": [
    { "id": "llama-3.3-70b", "object": "model", "owned_by": "kompute" }
  ]
}

Pass the id as model in chat requests. If several sellers list the same id, the router picks the cheapest active healthy offer.

Chat completions

POST https://kompute-kompute.vercel.app/v1/chat/completions — OpenAI Chat Completions shape.

Request body

Example

POST https://kompute-kompute.vercel.app/v1/chat/completions
Authorization: Bearer kompute_…
Content-Type: application/json

{
  "model": "llama-3.3-70b",
  "messages": [
    { "role": "system", "content": "Be brief." },
    { "role": "user", "content": "hello" }
  ]
}

Response

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "llama-3.3-70b",
  "choices": [{
    "index": 0,
    "finish_reason": "stop",
    "message": { "role": "assistant", "content": "…" }
  }],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 22,
    "total_tokens": 34
  },
  "kompute": {
    "seller": "seller-a.example",
    "charged_usd": 0.01
  }
}

The kompute object is KOMPUTE-specific metadata (selected seller host and charge). OpenAI SDKs ignore unknown fields.

Errors

{
  "error": {
    "message": "daily cap reached",
    "type": "insufficient_quota"
  }
}

Sellers

List capacity from Sell or via the form POST endpoints the console uses.

Console actions:

• POST /sell/offers — create
• POST /sell/offers/{id}/toggle — pause / activate
• POST /sell/offers/{id}/delete — remove

Offers are health-checked against the seller’s /models endpoint. The upstream key is stored encrypted and sent only when KOMPUTE proxies a call.

Payments

Clients & tools

Any stack that accepts a custom OpenAI base URL works:

• Cursor / Continue / Aider / OpenCode — set base URL to https://kompute-kompute.vercel.app/v1 and paste a buyer key.
• LangChain / Vercel AI SDK / LlamaIndex — OpenAI chat provider with the same base URL.
• Raw HTTP — curl examples above.

Use the OpenAI chat path for every model.

Playground

Sends the message through KOMPUTE. Paste a key secret from Buy.

Response lands here.

Agent guide

Machine-readable summary for LLMs and agents. Prefer this over scraping HTML.

GET https://kompute-kompute.vercel.app/docs.md

Includes the base URL, endpoints, auth, and payment rails in one markdown document.