Documentation

Getting Started

Go from zero to your first API call in under 5 minutes. This guide walks you through account creation, API key generation, and making your first request.

1

Create Your Account

Head to the registration page and create your Bolor Intelligence account. You will need a valid email address and a password with at least 8 characters. After registering, verify your email address by clicking the link we send you.

Your account starts on the Free tier, which includes 100 API requests per hour across all products. No credit card is required to get started.

2

Generate Your API Key

Once logged in, navigate to the API Keys section in your dashboard. Click "Create New Key" and give your key a descriptive name (e.g., "Development" or "Production").

Your API key will be displayed once. Copy it and store it securely. You will not be able to see the full key again. If you lose it, you can create a new one and revoke the old one.

API keys are prefixed with sk- and look like this:

sk-bolor-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3

Make Your First API Call

The simplest way to verify your setup is to call the OrchestrAI routing endpoint with a test query. Here is how to do it with curl:

curl
curl -X POST https://api.bolor.ai/v1/orchestrai/route \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "What is neuro-symbolic AI?",
  "options": {
    "max_latency_ms": 5000,
    "min_confidence": 0.7
  }
}'

You should receive a JSON response like this:

Response
{
  "id": "req_abc123",
  "model_used": "claude-3-sonnet",
  "routing_reason": "factual_query",
  "confidence": 0.92,
  "latency_ms": 1240,
  "response": {
    "text": "Neuro-symbolic AI combines neural networks...",
    "sources": []
  }
}
4

Install an SDK

While you can use the REST API directly, our official SDKs provide a more ergonomic experience with type safety, automatic retries, and streaming support.

Python

terminal
pip install bolor-ai
python
from bolor import BolorClient

client = BolorClient(api_key="sk-your-api-key")

# Route a query to the optimal model
response = client.orchestrai.route(
    query="What is neuro-symbolic AI?",
    max_latency_ms=5000,
    min_confidence=0.7
)

print(response.text)
print(f"Model: {response.model_used}")
print(f"Confidence: {response.confidence}")

Node.js / TypeScript

terminal
npm install @bolor-ai/sdk
typescript
import { BolorClient } from "@bolor-ai/sdk";

const client = new BolorClient({
  apiKey: "sk-your-api-key",
});

const response = await client.orchestrai.route({
  query: "What is neuro-symbolic AI?",
  maxLatencyMs: 5000,
  minConfidence: 0.7,
});

console.log(response.text);
console.log(`Model: ${response.modelUsed}`);
console.log(`Confidence: ${response.confidence}`);

Next Steps

  • Authentication →

    Learn about JWT tokens, OAuth2 flows, and advanced authentication options.

  • API Key Management →

    Scope keys to specific products, set up key rotation, and manage permissions.

  • Rate Limits →

    Understand request quotas for your plan and how to handle rate limiting gracefully.