API Reference

Everything you need to wire BuilderAI Kits into your stack

[!]

Beta Preview

The API is in closed beta. Endpoints below reflect the launch spec. Breaking changes are possible.

Authentication

All requests require a Bearer token. Pass your API key in the Authorization header:

Authorization: Bearer bak_your_api_key_here

Generate keys from your dashboard after account activation.

Kits API

Send prompts to any active kit and receive structured responses.

Endpoint

POST https://api.builderaikits.com/v1/kits/run

Request Body

{
  "kit": "text-gen",
  "input": {
    "prompt": "Summarize this article in 3 bullet points.",
    "context": "..."
  },
  "config": {
    "max_tokens": 500,
    "temperature": 0.6
  }
}

Response

{
  "id": "run_8f3k2m",
  "kit": "text-gen",
  "status": "completed",
  "output": {
    "text": "- Point one...\n- Point two...\n- Point three..."
  },
  "usage": {
    "input_tokens": 245,
    "output_tokens": 87,
    "total_tokens": 332
  },
  "latency_ms": 142
}

cURL Example

curl -X POST https://api.builderaikits.com/v1/kits/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer bak_your_key" \
  -d '{
    "kit": "text-gen",
    "input": {"prompt": "Hello, world!"}
  }'

Python Example

import requests

resp = requests.post(
    "https://api.builderaikits.com/v1/kits/run",
    headers={
        "Authorization": "Bearer bak_your_key",
        "Content-Type": "application/json"
    },
    json={
        "kit": "text-gen",
        "input": {"prompt": "Hello, world!"}
    }
)

print(resp.json())

JavaScript Example

const res = await fetch('https://api.builderaikits.com/v1/kits/run', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer bak_your_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    kit: 'text-gen',
    input: { prompt: 'Hello, world!' }
  })
});

const data = await res.json();
console.log(data);

Available Kits

Kit ID	Description	Max Tokens	Price
`text-gen`	General text generation & chat	4,096	$0.0004/1K tokens
`code-assist`	Code completion & review	8,192	$0.0006/1K tokens
`summarizer`	Document & article summarization	16,384	$0.0005/1K tokens
`classifier`	Text classification & sentiment	2,048	$0.0003/1K tokens

Rate Limits

Plan	Requests/min	Tokens/min
Maker	30	15,000
Builder	120	100,000
Enterprise	Custom	Custom

Error Codes

Code	Meaning
`200`	OK - Request succeeded
`400`	Bad Request - Malformed input
`401`	Unauthorized - Invalid API key
`429`	Rate Limited - Slow down
`500`	Internal Error - Our fault

Official SDKs

Client libraries shipping with the public launch:

Python

pip install builderaikits Coming Soon

Node.js

npm i @builderaikits/sdk Coming Soon

Go

go get builderaikits.com/sdk Coming Soon

Ready to Integrate?

Get on the waitlist for early API access and beta keys.

Join Waitlist