Quickstart

curl -N -X POST https://api.bahith.dev/v1/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $BAHITH_API_KEY" \
  -d '{
    "query": "What is RLHF and why does it matter for LLMs?",
    "reasoning_level": "medium"
  }'

const res = await fetch("https://api.bahith.dev/v1/research", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": process.env.BAHITH_API_KEY!,
  },
  body: JSON.stringify({
    query: "What is RLHF and why does it matter for LLMs?",
    reasoning_level: "medium",
  }),
});

import requests
 
url = "https://api.bahith.dev/v1/research"
headers = {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY"
}
data = {
    "query": "What is RLHF and why does it matter for LLMs?",
    "reasoning_level": "medium"
}
 
response = requests.post(url, headers=headers, json=data, stream=True)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
public class BahithClient {
    public static void main(String[] args) throws Exception {
        String json = """
            {
                "query": "What is RLHF and why does it matter for LLMs?",
                "reasoning_level": "medium"
            }
            """;
 
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.bahith.dev/v1/research"))
            .header("Content-Type", "application/json")
            .header("X-API-Key", "YOUR_API_KEY")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();
    }
}

# curl outputs the stream directly to standard output:
curl -N -X POST https://api.bahith.dev/v1/research \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $BAHITH_API_KEY" \
  -d '{ "query": "What is RLHF?" }'

// Assuming 'res' is the Response object from step 2
const reader = res.body.getReader();
const decoder = new TextDecoder();
let buffer = "";
 
while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });
 
  const lines = buffer.split("\n");
  buffer = lines.pop() ?? "";
  for (const line of lines) {
    if (!line.startsWith("data: ")) continue;
    const payload = line.slice(6);
    if (payload === "[DONE]") return;
    const event = JSON.parse(payload);
    if (event.type === "research.answer.delta") {
      process.stdout.write(event.data.content);
    }
  }
}

import json
 
# Assuming 'response' is the requests Response object from step 2
for line in response.iter_lines():
    if not line:
        continue
    payload = line.decode("utf-8").removeprefix("data: ")
    if payload == "[DONE]":
        break
    event = json.loads(payload)
    if event["type"] == "research.answer.delta":
        print(event["data"]["content"], end="", flush=True)
    elif event["type"] == "research.completed":
        print("\n\nCitations:", len(event["data"]["citations"]))

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.stream.Stream;
 
public class BahithStreamClient {
    public static void main(String[] args) throws Exception {
        String json = """
            {
                "query": "What is RLHF?",
                "reasoning_level": "medium"
            }
            """;
 
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.bahith.dev/v1/research"))
            .header("Content-Type", "application/json")
            .header("X-API-Key", "YOUR_API_KEY")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();
 
        client.sendAsync(request, HttpResponse.BodyHandlers.ofLines())
            .thenAccept(response -> {
                try (Stream<String> lines = response.body()) {
                    lines.forEach(line -> {
                        if (line.startsWith("data: ")) {
                            String payload = line.substring(6);
                            if (!payload.equals("[DONE]")) {
                                if (payload.contains("\"type\":\"research.answer.delta\"")) {
                                    int start = payload.indexOf("\"content\":\"") + 11;
                                    int end = payload.indexOf("\"", start);
                                    if (start > 10 && end > start) {
                                        System.out.print(payload.substring(start, end));
                                        System.out.flush();
                                    }
                                }
                            }
                        }
                    });
                }
            }).join();
    }
}