API Documentation

Authentication

All requests must include your API key in the Authorization header as a Bearer token. Your key is provided when you subscribe.

Authorization: Bearer YOUR_API_KEY

Requests without a valid key return 401 Unauthorized. Keep your key secret — contact us immediately if you believe it has been compromised.

Base URL

https://api.faradaymind.com

Available Models

Generate a response

Request body

Examples

cURL

curl https://api.faradaymind.com/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen2.5:14b",
    "prompt": "Summarise the key obligations in this contract:\n\n[DOCUMENT TEXT HERE]",
    "stream": false
  }'

Python

import requests

response = requests.post(
    "https://api.faradaymind.com/api/generate",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "qwen2.5:14b",
        "prompt": f"Summarise the key obligations:\n\n{document_text}",
        "stream": False
    }
)

result = response.json()["response"]

Node.js

const response = await fetch("https://api.faradaymind.com/api/generate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "qwen2.5:14b",
    prompt: `Summarise the key obligations:\n\n${documentText}`,
    stream: false
  })
});

const { response: result } = await response.json();

Response

{
  "model": "qwen2.5:14b",
  "response": "The contract contains the following key obligations...",
  "done": true,
  "done_reason": "stop"
}

Rate Limits

Exceeding your rate limit returns 429 Too Many Requests. Implement exponential backoff before retrying.

Best Practices

• →
  Include the full document in the prompt. The model works from the context you provide — always include the source document rather than asking it to recall facts.
• →
  Be specific in your instruction. "Summarise this contract" is weaker than "List the payment obligations, termination clauses, and liability caps in this contract."
• →
  Set stream: false unless you're building a real-time UI. Non-streaming responses are simpler to handle.
• →
  Human review for high-stakes decisions. AI summaries are a productivity tool, not a replacement for professional judgement.