DrAI API Documentation

🔑 Authentication

All /v1/ endpoints use OpenAI-compatible authentication. Include your API key in the header:

Authorization: Bearer sk-your-api-key-here

Contact admin for API key generation. Two keys available: GPT-Series (44 models) and OpenSource-Series (35 models).

🤖 Chat Completions

POST /v1/chat/completions

OpenAI-compatible chat completion. Supports streaming.

curl https://ai.dr-ai.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.4-mini","messages":[{"role":"user","content":"Hello"}],"max_tokens":100}'

Available Models

Provider	Model	Series
GPT-Series	gpt-5.4-mini, gpt-5.5, gpt-5.4, gpt-5-mini	GPT-5.x
Claude-Series	claude-sonnet-4-6, claude-opus-4-6, claude-opus-4-7	Anthropic
DeepSeek	deepseek-ai/DeepSeek-V4-Flash, V4-Pro, V3.2, R1	OpenSource
GLM	zai-org/GLM-5.2, GLM-4.5V, GLM-4.5-Air	OpenSource
Kimi	moonshotai/Kimi-K2.7-Code, Pro/moonshotai/Kimi-K2.6	OpenSource
Qwen	Qwen/Qwen3.6-35B-A3B, Qwen3.5-397B-A17B, Qwen3.5-27B	OpenSource

📄 List Models

GET /v1/models

List all available models for your API key.

curl https://ai.dr-ai.top/v1/models -H "Authorization: Bearer $API_KEY"

🤖 AI Agent

POST /agent/execute COMING SOON

Multi-step autonomous AI agent with planning and execution.

curl https://ai.dr-ai.top/agent/execute \
  -H "Content-Type: application/json" \
  -d '{"goal":"Your task here","max_steps":3,"model":"gpt-5.4-mini"}'

GET /agent/health COMING SOON

Agent health check + tool list.

curl https://ai.dr-ai.top/agent/health

📄 File Parser

GET /parser/parse/url?url=... COMING SOON

Extract text from any webpage.

curl "https://ai.dr-ai.top/parser/parse/url?url=https://example.com"

POST /parser/parse/upload COMING SOON

Upload and parse files (PDF, DOCX, XLSX, PPTX, TXT, MP3).

curl -F "file=@document.pdf" https://ai.dr-ai.top/parser/parse/upload

GET /parser/health COMING SOON

Supported formats: pdf, docx, xlsx, pptx, url, youtube, txt, audio

curl https://ai.dr-ai.top/parser/health

🧠 RAG Knowledge Base

POST /rag/query COMING SOON

Query indexed documents with semantic search + LLM.

curl -X POST https://ai.dr-ai.top/rag/query \
  -H "Content-Type: application/json" \
  -d '{"question":"Your question","model":"gpt-5.4-mini"}'

POST /rag/index/text COMING SOON

Index text for retrieval.

curl -X POST https://ai.dr-ai.top/rag/index/text \
  -H "Content-Type: application/json" \
  -d '{"title":"My Doc","text":"Content to index..."}'

📊 Monitoring

GET /dashboard.html

Real-time system dashboard (30s auto-refresh).

open https://ai.dr-ai.top/dashboard.html

GET /api/stats

Raw stats JSON (models, containers, plans).

curl https://ai.dr-ai.top/api/stats

💳 Billing

GET /pricing.html

Subscription plans: Free ($0), Pro ($9.99/mo), Max ($29.99/mo). Stripe LIVE.

open https://ai.dr-ai.top/pricing.html