Developer Docs

Build with CaveauAI

From first API call to production deployment in under 10 minutes. Full REST API, Python SDK, and MCP server support.

Quick Start Guide

1

Get Your API Key

Sign up for a free sandbox account. Your API key is available immediately on your dashboard.

# Your API key from the dashboard
export BLUENOTE_API_KEY="bnai_sk_your_key_here"
2

Upload a Document

Upload your first document to a corpus. The pipeline processes it automatically — chunking, embedding, and indexing.

curl -X POST https://ai.bluenotelogic.com/api/v2/documents \
  -H "Authorization: Bearer $BLUENOTE_API_KEY" \
  -F "file=@contract.pdf" \
  -F "corpus_id=your_corpus_id"
3

Ask a Question

Query your corpus using natural language. Every response includes cited source passages.

curl -X POST https://ai.bluenotelogic.com/api/v2/chat \
  -H "Authorization: Bearer $BLUENOTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "What are the termination clauses?",
    "corpus_id": "your_corpus_id"
  }'

Get Cited Answers

{
  "answer": "The contract may be terminated by either party with 90 days written notice...",
  "sources": [
    {
      "document": "contract.pdf",
      "page": 12,
      "text": "Either party may terminate this agreement...",
      "relevance": 0.94
    }
  ]
}

Explore the Documentation

Build a corpus. Earn 80%.

Our Creator Program lets domain experts build and monetize knowledge corpora. You bring the expertise, we handle the infrastructure.

Learn About the Creator Program