Authorization: Bearer bai_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Using an API key
curl https://bundleai.cloud/v1/models \
  -H "Authorization: Bearer bai_your_api_key_here"

{
  "id":      "chatcmpl-abc123",
  "object":  "chat.completion",
  "created": 1712345678,
  "model":   "deepseek-r1:14b",
  "choices": [
    {
      "index":         0,
      "message": {
        "role":    "assistant",
        "content": "Quantum entanglement is a phenomenon where..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens":     28,
    "completion_tokens": 214,
    "total_tokens":      242
  }
}

curl https://bundleai.cloud/v1/models \
  -H "Authorization: Bearer bai_your_key_here"

{
  "object": "list",
  "data": [
    {
      "id":       "deepseek-r1:14b",
      "object":  "model",
      "created": 1712000000,
      "owned_by": "bundleai"
    }
  ]
}

curl https://bundleai.cloud/skills \
  -H "Authorization: Bearer bai_your_key_here"

{
  "skills": [
    { "id": "general",      "name": "General Assistant",  "description": "Balanced everyday assistant" },
    { "id": "researcher",   "name": "Researcher",         "description": "Deep research and analysis" },
    { "id": "coder",        "name": "Coder",              "description": "Code generation and debugging" },
    { "id": "writer",       "name": "Writer",             "description": "Professional writing and editing" },
    { "id": "data-analyst", "name": "Data Analyst",      "description": "Data interpretation and stats" },
    { "id": "web-analyst",  "name": "Web Analyst",       "description": "Web research and competitive analysis" }
  ]
}

curl -X POST https://bundleai.cloud/user/apikeys \
  -H "Authorization: Bearer bai_your_key" \
  -H "Content-Type: application/json" \
  -d '{"label": "My App"}'

{
  "id":         42,
  "key":        "bai_newlygeneratedkeyvalue",
  "label":      "My App",
  "created_at": "2026-04-09T12:00:00Z"
}

curl https://bundleai.cloud/user/apikeys \
  -H "Authorization: Bearer bai_your_key"

curl -X DELETE https://bundleai.cloud/user/apikeys/42 \
  -H "Authorization: Bearer bai_your_key"

curl https://bundleai.cloud/auth/me \
  -H "Authorization: Bearer bai_your_key_here"

{
  "id":              7,
  "email":           "user@example.com",
  "first_name":      "Alice",
  "last_name":       "Smith",
  "role":            "user",
  "token_balance":   2847500,
  "created_at":      "2026-01-15T09:30:00Z"
}

{
  "error": {
    "message": "Insufficient token balance to complete this request.",
    "type":    "insufficient_tokens",
    "code":    402
  }
}

"""
BundleAI — Python SDK Example
Requires: pip install openai
"""

import os
from openai import OpenAI

# Initialize the client pointing to BundleAI
client = OpenAI(
    base_url="https://bundleai.cloud/v1",
    api_key=os.environ["BUNDLEAI_API_KEY"],  # bai_xxxx
)

# ── Non-streaming request ──────────────────────────────────────────
response = client.chat.completions.create(
    model="deepseek-r1:14b",
    messages=[
        {"role": "system",  "content": "You are a senior Python developer."},
        {"role": "user",    "content": "Write a binary search function with type hints."},
    ],
    temperature=0.3,
    extra_body={"skill": "coder"},
)

print("Assistant:", response.choices[0].message.content)
print("Tokens used:", response.usage.total_tokens)

# ── Streaming request ──────────────────────────────────────────────
print("\n--- Streaming ---")
stream = client.chat.completions.create(
    model="deepseek-r1:14b",
    messages=[{"role": "user", "content": "What is 42 * 1337?"}],
    stream=True,
    extra_body={"use_tools": True},
)

for chunk in stream:
    delta = chunk.choices[0].delta.content or ""
    print(delta, end="", flush=True)

print()  # newline after stream

/**
 * BundleAI — Node.js SDK Example
 * Install: npm install openai
 */

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://bundleai.cloud/v1",
  apiKey:  process.env.BUNDLEAI_API_KEY,  // bai_xxxx
});

// ── Non-streaming ─────────────────────────────────────────────────
async function askQuestion(question) {
  const response = await client.chat.completions.create({
    model: "deepseek-r1:14b",
    messages: [
      { role: "system", content: "You are a helpful research assistant." },
      { role: "user",   content: question },
    ],
    // BundleAI extensions
    "skill":     "researcher",
    "use_tools": true,
  });

  return response.choices[0].message.content;
}

// ── Streaming ────────────────────────────────────────────────────
async function streamAnswer(prompt) {
  const stream = await client.chat.completions.create({
    model:  "deepseek-r1:14b",
    stream: true,
    messages: [{ role: "user", content: prompt }],
  });

  for await (const chunk of stream) {
    process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
  }
  console.log();
}

// Run examples
askQuestion("What are the latest advances in fusion energy?")
  .then(answer => console.log("Answer:", answer))
  .catch(console.error);

streamAnswer("Write a haiku about the ocean.")
  .catch(console.error);