1 line
47 KiB
JSON
1 line
47 KiB
JSON
{"repo": "aryanxpatel/mind", "files": {"content/2.about/4.faq.md": {"cae6cacb1027263ae11f9070d62b9184b314ac5f": {"t": 1785746554.9021883, "n": 2437, "h": "3351ea4a186de8de", "c": "---\ntitle: FAQ\ndescription: Frequently asked questions about BluesMinds API.\nicon: lucide:help-circle\n---\n\n## What is BluesMinds?\n\nBluesMinds provides **one API key** for 897+ AI models across 19 providers with unified billing. It works with any OpenAI-compatible library — just change `base_url`.\n\n## How do I get started?\n\n::steps\n### Sign up at the Console\n\nGo to [api.bluesminds.com/console](https://api.bluesminds.com/console)\n\n### Generate an API Key\n\nNavigate to **Tokens → Create New Token**\n\n### Set your environment variables\n\n```bash\nexport BLUESMINDS_API_KEY=\"sk-your-key\"\nexport BLUESMINDS_BASE=\"https://api.bluesminds.com/v1\"\n```\n::\n\n## Which providers are supported?\n\n| Provider | Example Models |\n|----------|---------------|\n| OpenAI | `gpt-4o`, `gpt-4.1`, `gpt-4o-mini` |\n| Anthropic | `claude-sonnet-4-5`, `claude-opus-4-5` |\n| Google | `gemini-2.0-flash`, `gemini-2.5-pro` |\n| Mistral | `mistral-large` |\n| DeepSeek | `deepseek-chat`, `deepseek-reasoner` |\n| xAI | `grok-3` |\n| Alibaba | Qwen models |\n| Open Source | Various community models |\n\n## Pricing\n\n| Plan | Price | RPM |\n|------|-------|-----|\n| **Free** | $0 forever | 20 |\n| **Trial Pack** | $5 / 24hrs | 15 |\n| **10-Day Pass** | $25 / 10 days | 15 |\n| **Unlimited** | $60 / month | 15 |\n| **Enterprise** | Custom | Custom |\n\n::callout{type=\"info\" icon=\"lucide:gift\"}\nFree accounts receive **500 pi credits** on signup — no credit card required.\n::\n\n## What happens when a provider is down?\n\nBluesMinds automatically routes to an alternate provider. If no provider is available for your model, you'll receive a `404` error.\n\n## Common Errors\n\n| Error | Cause | Fix |\n|-------|-------|-----|\n| `401` | Invalid or missing API key | Check `Authorization: Bearer sk-...` header; ensure no trailing slash on base URL |\n| `404` | Model not available | Refresh model list with `GET /v1/models`; some models require paid plans |\n| `429` | Rate limit exceeded | Apply exponential backoff; check `Retry-After` header |\n\n## Does BluesMinds support vision?\n\nYes. Vision requires publicly accessible image URLs or base64-encoded data in the request.\n\n## Does BluesMinds support tool/function calling?\n\nYes, for supported models like `gpt-4o` and `claude-sonnet-4-5`. See [Tool Calling](/features/tool-calling).\n\n## How do I get support?\n\n- **Telegram:** [t.me/apibluesminds](https://t.me/apibluesminds)\n- **Email:** [hello@bluesminds.com](mailto:hello@bluesminds.com)\n"}}, "docs/plans/2026-04-01-docs-restructure.md": {"cae6cacb1027263ae11f9070d62b9184b314ac5f": {"t": 1785746559.1978126, "n": 34169, "h": "1fef035268e90c68", "c": "# BluesMinds Docs Restructure — Quick Start First\n\n> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.\n\n**Goal:** Restructure the docs site so users land on their coding tool, copy 2 commands, and are running in 30 seconds. Add 7 new tool pages, a combined Models & Pricing page, and reorganize the sidebar to put Quick Start first.\n\n**Architecture:** The content directory gets renumbered: `1.quick-start/` (tool pages + API quickstart), `2.about/` (intro, models-pricing, principles, faq), `3.features/` (unchanged), `4.api/` (unchanged). The old `3.integrations/` section is deleted — its content migrates into Quick Start. Header nav in `app.config.ts` is rebuilt to match.\n\n**Tech Stack:** Nuxt 3, shadcn-docs-nuxt (MDC markdown), Nuxt Content\n\n---\n\n## Phase 1: Restructure Sidebar & Sections\n\n### Task 1: Create new directory structure\n\n**Files:**\n- Create: `content/1.quick-start/_dir.yml`\n- Create: `content/2.about/_dir.yml`\n\n**Step 1: Create Quick Start section directory config**\n\nCreate `content/1.quick-start/_dir.yml`:\n```yaml\ntitle: Quick Start\nicon: lucide:rocket\n```\n\n**Step 2: Create About section directory config**\n\nCreate `content/2.about/_dir.yml`:\n```yaml\ntitle: About\nicon: lucide:book-open\n```\n\n**Step 3: Verify directories exist**\n\nRun: `ls D:\\dev\\mind\\content\\`\nExpected: Both new directories visible alongside existing ones.\n\n---\n\n### Task 2: Move existing pages to new locations\n\n**Files:**\n- Move: `content/1.getting-started/1.introduction.md` → `content/2.about/1.introduction.md`\n- Move: `content/1.getting-started/3.principles.md` → `content/2.about/3.principles.md`\n- Move: `content/1.getting-started/5.faq.md` → `content/2.about/4.faq.md`\n- Move: `content/1.getting-started/2.quickstart.md` → `content/1.quick-start/1.api-quickstart.md`\n- Move: `content/3.integrations/1.claude-code.md` → `content/1.quick-start/2.claude-code.md`\n- Move: `content/3.integrations/2.codex-cli.md` → `content/1.quick-start/3.codex-cli.md`\n- Move: `content/3.integrations/3.openclaw.md` → `content/1.quick-start/11.openclaw.md` (last in list)\n- Move: `content/1.getting-started/4.models.md` → will be replaced by new models-and-pricing page\n- Delete: `content/1.getting-started/` (entire old directory)\n- Delete: `content/3.integrations/` (entire old directory)\n\n**Step 1: Move files**\n\n```bash\n# Create new dirs\nmkdir -p \"D:\\dev\\mind\\content\\1.quick-start\"\nmkdir -p \"D:\\dev\\mind\\content\\2.about\"\n\n# Move to About\nmv \"D:\\dev\\mind\\content\\1.getting-started\\1.introduction.md\" \"D:\\dev\\mind\\content\\2.about\\1.introduction.md\"\nmv \"D:\\dev\\mind\\content\\1.getting-started\\3.principles.md\" \"D:\\dev\\mind\\content\\2.about\\3.principles.md\"\nmv \"D:\\dev\\mind\\content\\1.getting-started\\5.faq.md\" \"D:\\dev\\mind\\content\\2.about\\4.faq.md\"\n\n# Move Quickstart to Quick Start as API Quickstart\nmv \"D:\\dev\\mind\\content\\1.getting-started\\2.quickstart.md\" \"D:\\dev\\mind\\content\\1.quick-start\\1.api-quickstart.md\"\n\n# Move integrations to Quick Start\nmv \"D:\\dev\\mind\\content\\3.integrations\\1.claude-code.md\" \"D:\\dev\\mind\\content\\1.quick-start\\2.claude-code.md\"\nmv \"D:\\dev\\mind\\content\\3.integrations\\2.codex-cli.md\" \"D:\\dev\\mind\\content\\1.quick-start\\3.codex-cli.md\"\nmv \"D:\\dev\\mind\\content\\3.integrations\\3.openclaw.md\" \"D:\\dev\\mind\\content\\1.quick-start\\11.openclaw.md\"\n```\n\n**Step 2: Clean up old directories**\n\n```bash\nrm -rf \"D:\\dev\\mind\\content\\1.getting-started\"\nrm -rf \"D:\\dev\\mind\\content\\3.integrations\"\n```\n\n**Step 3: Renumber features from 3 to 3 (stays same) and api from 4 to 4 (stays same)**\n\nFeatures and API keep their numbers. No rename needed.\n\n**Step 4: Verify structure**\n\nRun: `find D:\\dev\\mind\\content -type f -name \"*.md\" | sort`\nExpected: New structure with `1.quick-start/`, `2.about/`, `3.features/`, `4.api/`\n\n---\n\n### Task 3: Update moved page frontmatter and content\n\n**Files:**\n- Modify: `content/1.quick-start/1.api-quickstart.md`\n- Modify: `content/2.about/1.introduction.md`\n\n**Step 1: Update API Quickstart page**\n\nChange title from \"Quickstart\" to \"API Quickstart\" and add a callout at the top redirecting tool users:\n\n```markdown\n---\ntitle: API Quickstart\ndescription: Get your first BluesMinds API call running in under 2 minutes.\nicon: lucide:zap\n---\n\n::alert{type=\"info\" icon=\"lucide:lightbulb\"}\n**Using a coding tool?** Skip straight to your tool's guide:\n[Claude Code](/quick-start/claude-code) · [Codex CLI](/quick-start/codex-cli) · [Gemini CLI](/quick-start/gemini-cli) · [Cursor](/quick-start/cursor) · [Continue.dev](/quick-start/continue-dev)\n::\n\nGet up and running with the BluesMinds API in under 2 minutes.\n```\n\nKeep the rest of the existing content (Setup, Make Your First Call, Streaming, Coding Tools table, Next Steps) but update the Next Steps links to new paths:\n\n```markdown\n## Next Steps\n\n:read-more{title=\"Models & Pricing\" to=\"/about/models-and-pricing\"}\n:read-more{title=\"Tool Calling\" to=\"/features/tool-calling\"}\n:read-more{title=\"Provider Routing\" to=\"/features/provider-routing\"}\n```\n\n**Step 2: Update Introduction page links**\n\nIn `content/2.about/1.introduction.md`, update the \"Getting Started\" steps and \"Quick Links\" table to point to new paths:\n- Quickstart → `/quick-start/api-quickstart`\n- Models → `/about/models-and-pricing`\n- FAQ → `/about/faq`\n\n---\n\n### Task 4: Update app.config.ts navigation\n\n**Files:**\n- Modify: `app.config.ts`\n\n**Step 1: Rewrite the header nav array**\n\nReplace the entire `nav` array in `app.config.ts` with:\n\n```typescript\nnav: [\n {\n title: 'Quick Start',\n links: [\n {\n title: 'API Quickstart',\n to: '/quick-start/api-quickstart',\n description: 'Make your first API call in 2 minutes',\n icon: 'lucide:zap',\n },\n {\n title: 'Claude Code',\n to: '/quick-start/claude-code',\n description: 'Use Claude Code via BluesMinds',\n icon: 'lucide:terminal',\n },\n {\n title: 'Codex CLI',\n to: '/quick-start/codex-cli',\n description: 'OpenAI Codex CLI integration',\n icon: 'lucide:square-terminal',\n },\n {\n title: 'Gemini CLI',\n to: '/quick-start/gemini-cli',\n description: 'Google Gemini CLI integration',\n icon: 'lucide:sparkles',\n },\n {\n title: 'Cursor',\n to: '/quick-start/cursor',\n description: 'AI code editor setup',\n icon: 'lucide:mouse-pointer',\n },\n {\n title: 'More Tools...',\n to: '/quick-start/continue-dev',\n description: 'Continue.dev, RooCode, Kilocode, and more',\n icon: 'lucide:plus',\n },\n ],\n },\n {\n title: 'About',\n links: [\n {\n title: 'Introduction',\n to: '/about/introduction',\n description: 'Overview of BluesMinds API gateway',\n icon: 'lucide:info',\n },\n {\n title: 'Models & Pricing',\n to: '/about/models-and-pricing',\n description: 'Plans, models, RPM limits, and costs',\n icon: 'lucide:cpu',\n },\n {\n title: 'Principles',\n to: '/about/principles',\n description: 'Core design principles behind the API',\n icon: 'lucide:compass',\n },\n {\n title: 'FAQ',\n to: '/about/faq',\n description: 'Common questions and troubleshooting',\n icon: 'lucide:help-circle',\n },\n ],\n },\n {\n title: 'Features',\n links: [\n {\n title: 'Provider Routing',\n to: '/features/provider-routing',\n description: 'Automatic failover and load balancing',\n icon: 'lucide:route',\n },\n {\n title: 'Tool Calling',\n to: '/features/tool-calling',\n description: 'OpenAI-compatible function calling',\n icon: 'lucide:wrench',\n },\n {\n title: 'Message Transforms',\n to: '/features/message-transforms',\n description: 'Auto-convert between API formats',\n icon: 'lucide:repeat',\n },\n {\n title: 'Privacy & Logging',\n to: '/features/privacy-logging',\n description: 'Data handling and security controls',\n icon: 'lucide:shield',\n },\n {\n title: 'Web Search',\n to: '/features/web-search',\n description: 'Real-time web search in LLM responses',\n icon: 'lucide:search',\n },\n ],\n },\n {\n title: 'API Reference',\n to: '/api/bluesminds-api',\n showLinkIcon: false,\n },\n],\n```\n\n**Step 2: Verify dev server starts**\n\nRun: `cd D:\\dev\\mind && npx nuxt dev`\nExpected: No build errors. Sidebar shows new structure.\n\n**Step 3: Commit Phase 1**\n\n```bash\ngit add -A\ngit commit -m \"restructure: move to Quick Start first sidebar layout\"\n```\n\n---\n\n## Phase 2: Create New Quick Start Tool Pages\n\nAll tool pages follow the same template. Each has: paid-plan warning, prerequisites, env vars (Linux/macOS + Windows tabs), run command, persistent config, model selection, troubleshooting.\n\n### Task 5: Enhance Claude Code page (already exists, needs OS tabs + paid warning)\n\n**Files:**\n- Modify: `content/1.quick-start/2.claude-code.md`\n\n**Full rewrite:**\n\n```markdown\n---\ntitle: Claude Code\ndescription: Use Claude Code with BluesMinds — automatic failover, unified billing, 100+ models.\nicon: lucide:terminal\n---\n\n::alert{type=\"warning\" icon=\"lucide:alert-triangle\"}\n**Paid plan required.** Coding tools need a Trial ($5/day) plan or higher. Free accounts cannot use Claude Code.\n[Get a plan →](https://api.bluesminds.com/console){target=\"_blank\"}\n::\n\n## Install Claude Code\n\n:pm-install{name=\"-g @anthropic-ai/claude-code\"}\n\n## Set Environment Variables\n\n::tabs{variant=\"card\"}\n ::div{label=\"Linux / macOS\" icon=\"lucide:terminal\"}\n ```bash\n export ANTHROPIC_BASE_URL=https://api.bluesminds.com/\n export ANTHROPIC_API_KEY=sk-your-bluesminds-key\n ```\n ::\n\n ::div{label=\"Windows PowerShell\" icon=\"lucide:terminal\"}\n ```powershell\n $env:ANTHROPIC_BASE_URL = \"https://api.bluesminds.com/\"\n $env:ANTHROPIC_API_KEY = \"sk-your-bluesminds-key\"\n ```\n ::\n::\n\n::alert{type=\"info\" icon=\"lucide:key\"}\nGet your API key at [api.bluesminds.com/console](https://api.bluesminds.com/console){target=\"_blank\"} → **Tokens** → **Create New Token**.\n::\n\n## Run It\n\n```bash\nclaude\n```\n\nThat's it. Claude Code is now routing through BluesMinds.\n\n## Persistent Configuration (Optional)\n\n::tabs{variant=\"card\"}\n ::div{label=\"bash / zsh\" icon=\"lucide:terminal\"}\n ```bash\n echo 'export ANTHROPIC_BASE_URL=https://api.bluesminds.com/' >> ~/.bashrc\n echo 'export ANTHROPIC_API_KEY=sk-your-bluesminds-key' >> ~/.bashrc\n source ~/.bashrc\n ```\n ::\n\n ::div{label=\"PowerShell Profile\" icon=\"lucide:terminal\"}\n ```powershell\n Add-Content $PROFILE \"`n`$env:ANTHROPIC_BASE_URL = 'https://api.bluesminds.com/'\"\n Add-Content $PROFILE \"`$env:ANTHROPIC_API_KEY = 'sk-your-bluesminds-key'\"\n ```\n Then restart your terminal.\n ::\n::\n\n## Model Selection\n\n```bash\nclaude --model claude-sonnet-4-5\n```\n\n| Model | Best For | Context |\n|-------|----------|---------|\n| `claude-sonnet-4-5` | Balanced quality/speed **(recommended)** | 200k |\n| `claude-opus-4-5` | Complex tasks, deep reasoning | 200k |\n| `claude-haiku-3-5` | Fastest, most cost-efficient | 200k |\n\n## Why Route Through BluesMinds?\n\n::card-group{cols=2}\n ::card\n ---\n title: Automatic Failover\n icon: lucide:refresh-cw\n ---\n If the primary Anthropic channel is degraded, BluesMinds routes to an alternate provider automatically.\n ::\n\n ::card\n ---\n title: Rate-Limit Distribution\n icon: lucide:gauge\n ---\n Spread requests across multiple channels to avoid hitting per-provider rate limits.\n ::\n\n ::card\n ---\n title: Unified Billing\n icon: lucide:credit-card\n ---\n One bill for all models across all providers — no juggling multiple accounts.\n ::\n\n ::card\n ---\n title: Privacy Controls\n icon: lucide:lock\n ---\n Request bodies are not stored by default. Full control over logging and data retention.\n ::\n::\n\n## Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| `401 Unauthorized` | Verify key starts with `sk-`; run `echo $ANTHROPIC_API_KEY` to check |\n| `Connection refused` | Ensure no trailing path after the base URL |\n| Wrong model | Restart Claude Code after changing env vars (it caches the base URL) |\n| Older versions | May need `ANTHROPIC_AUTH_TOKEN` in addition to `ANTHROPIC_API_KEY` |\n\n**Connectivity check:**\n\n```bash\ncurl https://api.bluesminds.com//models \\\n -H \"Authorization: Bearer sk-your-key\"\n```\n\n## Next Steps\n\n:read-more{title=\"Models & Pricing\" to=\"/about/models-and-pricing\"}\n:read-more{title=\"Codex CLI Setup\" to=\"/quick-start/codex-cli\"}\n:read-more{title=\"API Quickstart\" to=\"/quick-start/api-quickstart\"}\n```\n\n---\n\n### Task 6: Enhance Codex CLI page\n\n**Files:**\n- Modify: `content/1.quick-start/3.codex-cli.md`\n\n**Full rewrite** following same template as Claude Code but with OpenAI env vars:\n\n```markdown\n---\ntitle: Codex CLI\ndescription: Use OpenAI Codex CLI with BluesMinds for multi-provider access and failover.\nicon: lucide:square-terminal\n---\n\n::alert{type=\"warning\" icon=\"lucide:alert-triangle\"}\n**Paid plan required.** Coding tools need a Trial ($5/day) plan or higher. Free accounts cannot use Codex CLI.\n[Get a plan →](https://api.bluesminds.com/console){target=\"_blank\"}\n::\n\n## Install Codex CLI\n\n:pm-install{name=\"-g @openai/codex\"}\n\n## Set Environment Variables\n\n::tabs{variant=\"card\"}\n ::div{label=\"Linux / macOS\" icon=\"lucide:terminal\"}\n ```bash\n export OPENAI_BASE_URL=https://api.bluesminds.com/v1\n export OPENAI_API_KEY=sk-your-bluesminds-key\n ```\n ::\n\n ::div{label=\"Windows PowerShell\" icon=\"lucide:terminal\"}\n ```powershell\n $env:OPENAI_BASE_URL = \"https://api.bluesminds.com/v1\"\n $env:OPENAI_API_KEY = \"sk-your-bluesminds-key\"\n ```\n ::\n::\n\n::alert{type=\"info\" icon=\"lucide:key\"}\nGet your API key at [api.bluesminds.com/console](https://api.bluesminds.com/console){target=\"_blank\"} → **Tokens** → **Create New Token**.\n::\n\n## Run It\n\n```bash\ncodex \"describe your task here\"\n```\n\nThat's it. Codex CLI is now routing through BluesMinds.\n\n## Persistent Configuration (Optional)\n\n::tabs{variant=\"card\"}\n ::div{label=\"bash / zsh\" icon=\"lucide:terminal\"}\n ```bash\n echo 'export OPENAI_BASE_URL=https://api.bluesminds.com/v1' >> ~/.bashrc\n echo 'export OPENAI_API_KEY=sk-your-bluesminds-key' >> ~/.bashrc\n source ~/.bashrc\n ```\n ::\n\n ::div{label=\"PowerShell Profile\" icon=\"lucide:terminal\"}\n ```powershell\n Add-Content $PROFILE \"`n`$env:OPENAI_BASE_URL = 'https://api.bluesminds.com/v1'\"\n Add-Content $PROFILE \"`$env:OPENAI_API_KEY = 'sk-your-bluesminds-key'\"\n ```\n Then restart your terminal.\n ::\n::\n\n## Model Selection\n\n| Model | Best For |\n|-------|----------|\n| `gpt-4o` | General purpose, fast **(recommended)** |\n| `gpt-4.1` | 1M token context window |\n| `claude-sonnet-4-5` | Balanced quality, cross-provider |\n\n## Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| `401 Unauthorized` | Verify `OPENAI_API_KEY` starts with `sk-` |\n| Model not found | Check available models with `GET /v1/models` |\n| Slow responses | Try a faster model like `gpt-4o-mini` |\n\n## Next Steps\n\n:read-more{title=\"Models & Pricing\" to=\"/about/models-and-pricing\"}\n:read-more{title=\"Claude Code Setup\" to=\"/quick-start/claude-code\"}\n:read-more{title=\"API Quickstart\" to=\"/quick-start/api-quickstart\"}\n```\n\n---\n\n### Task 7: Create Gemini CLI page (NEW)\n\n**Files:**\n- Create: `content/1.quick-start/4.gemini-cli.md`\n\n```markdown\n---\ntitle: Gemini CLI\ndescription: Use Google's Gemini CLI with BluesMinds for multi-provider access.\nicon: lucide:sparkles\n---\n\n::alert{type=\"warning\" icon=\"lucide:alert-triangle\"}\n**Paid plan required.** Coding tools need a Trial ($5/day) plan or higher.\n[Get a plan →](https://api.bluesminds.com/console){target=\"_blank\"}\n::\n\n## Install Gemini CLI\n\n:pm-install{name=\"-g @anthropic-ai/claude-code\"}\n\n::alert{type=\"info\" icon=\"lucide:info\"}\nGemini CLI uses the same protocol as Claude Code. Install Claude Code, then configure it to use Gemini models via BluesMinds.\n::\n\n## Set Environment Variables\n\n::tabs{variant=\"card\"}\n ::div{label=\"Linux / macOS\" icon=\"lucide:terminal\"}\n ```bash\n export ANTHROPIC_BASE_URL=https://api.bluesminds.com/\n export ANTHROPIC_API_KEY=sk-your-bluesminds-key\n ```\n ::\n\n ::div{label=\"Windows PowerShell\" icon=\"lucide:terminal\"}\n ```powershell\n $env:ANTHROPIC_BASE_URL = \"https://api.bluesminds.com/\"\n $env:ANTHROPIC_API_KEY = \"sk-your-bluesminds-key\"\n ```\n ::\n::\n\n::alert{type=\"info\" icon=\"lucide:key\"}\nGet your API key at [api.bluesminds.com/console](https://api.bluesminds.com/console){target=\"_blank\"} → **Tokens** → **Create New Token**.\n::\n\n## Run It\n\n```bash\nclaude --model gemini-2.0-flash\n```\n\n## Model Selection\n\n| Model | Best For | Context |\n|-------|----------|---------|\n| `gemini-2.0-flash` | Fast, multimodal **(recommended)** | 1M |\n| `gemini-2.5-pro` | Best quality reasoning | 1M |\n\n## Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| `401 Unauthorized` | Verify key starts with `sk-` |\n| Model not found | Ensure your plan supports this model |\n| Slow responses | Try `gemini-2.0-flash` for speed |\n\n## Next Steps\n\n:read-more{title=\"Models & Pricing\" to=\"/about/models-and-pricing\"}\n:read-more{title=\"Claude Code Setup\" to=\"/quick-start/claude-code\"}\n```\n\n---\n\n### Task 8: Create Cursor page (NEW)\n\n**Files:**\n- Create: `content/1.quick-start/5.cursor.md`\n\n```markdown\n---\ntitle: Cursor\ndescription: Use Cursor AI editor with BluesMinds for 100+ models through one key.\nicon: lucide:mouse-pointer\n---\n\n::alert{type=\"warning\" icon=\"lucide:alert-triangle\"}\n**Paid plan required.** Coding tools need a Trial ($5/day) plan or higher.\n[Get a plan →](https://api.bluesminds.com/console){target=\"_blank\"}\n::\n\n## Configure Cursor\n\n::steps\n### Open Cursor Settings\n\nGo to **Settings** → **Models** → **OpenAI API Key**\n\n### Set the API Key\n\nEnter your BluesMinds key:\n```\nsk-your-bluesminds-key\n```\n\n### Set the Base URL\n\nOverride the base URL:\n```\nhttps://api.bluesminds.com/v1\n```\n\n### Choose a Model\n\nSelect or type a model ID, e.g. `gpt-4o` or `claude-sonnet-4-5`.\n::\n\n::alert{type=\"info\" icon=\"lucide:key\"}\nGet your API key at [api.bluesminds.com/console](https://api.bluesminds.com/console){target=\"_blank\"} → **Tokens** → **Create New Token**.\n::\n\n## Recommended Models\n\n| Model | Best For |\n|-------|----------|\n| `gpt-4o` | Fast general purpose **(recommended)** |\n| `claude-sonnet-4-5` | High quality code generation |\n| `deepseek-chat` | Cost-efficient coding |\n\n## Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| `401 Unauthorized` | Re-enter your API key in settings |\n| Model not found | Check available models with `GET /v1/models` |\n| No completions | Ensure base URL ends with `/v1` |\n\n## Next Steps\n\n:read-more{title=\"Models & Pricing\" to=\"/about/models-and-pricing\"}\n:read-more{title=\"API Quickstart\" to=\"/quick-start/api-quickstart\"}\n```\n\n---\n\n### Task 9: Create Continue.dev page (NEW)\n\n**Files:**\n- Create: `content/1.quick-start/6.continue-dev.md`\n\n```markdown\n---\ntitle: Continue.dev\ndescription: Use Continue.dev VS Code extension with BluesMinds for multi-provider AI.\nicon: lucide:puzzle\n---\n\n::alert{type=\"warning\" icon=\"lucide:alert-triangle\"}\n**Paid plan required.** Coding tools need a Trial ($5/day) plan or higher.\n[Get a plan →](https://api.bluesminds.com/console){target=\"_blank\"}\n::\n\n## Install Continue.dev\n\nInstall the [Continue extension](https://marketplace.visualstudio.com/items?itemName=Continue.continue) from the VS Code marketplace.\n\n## Configure\n\nEdit your Continue config file (`~/.continue/config.json`):\n\n```json\n{\n \"models\": [\n {\n \"title\": \"BluesMinds - GPT-4o\",\n \"provider\": \"openai\",\n \"model\": \"gpt-4o\",\n \"apiBase\": \"https://api.bluesminds.com/v1\",\n \"apiKey\": \"sk-your-bluesminds-key\"\n }\n ]\n}\n```\n\n::alert{type=\"info\" icon=\"lucide:key\"}\nGet your API key at [api.bluesminds.com/console](https://api.bluesminds.com/console){target=\"_blank\"} → **Tokens** → **Create New Token**.\n::\n\n## Recommended Models\n\n| Model | Best For |\n|-------|----------|\n| `gpt-4o` | Fast general purpose **(recommended)** |\n| `claude-sonnet-4-5` | High quality code generation |\n| `gemini-2.0-flash` | Fast, large context |\n\n## Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| No completions | Check `apiBase` ends with `/v1` |\n| Auth errors | Verify `apiKey` in config.json |\n| Wrong model | Ensure model ID matches `GET /v1/models` |\n\n## Next Steps\n\n:read-more{title=\"Models & Pricing\" to=\"/about/models-and-pricing\"}\n:read-more{title=\"Cursor Setup\" to=\"/quick-start/cursor\"}\n```\n\n---\n\n### Task 10: Create RooCode page (NEW)\n\n**Files:**\n- Create: `content/1.quick-start/7.roocode.md`\n\n```markdown\n---\ntitle: RooCode\ndescription: Use RooCode with BluesMinds for AI-assisted coding with 100+ models.\nicon: lucide:code\n---\n\n::alert{type=\"warning\" icon=\"lucide:alert-triangle\"}\n**Paid plan required.** Coding tools need a Trial ($5/day) plan or higher.\n[Get a plan →](https://api.bluesminds.com/console){target=\"_blank\"}\n::\n\n## Install RooCode\n\nInstall the [RooCode extension](https://marketplace.visualstudio.com/items?itemName=RooVetGit.roo-cline) from the VS Code marketplace.\n\n## Configure\n\n::steps\n### Open RooCode Settings\n\nClick the RooCode icon in the sidebar → **Settings** (gear icon)\n\n### Select API Provider\n\nChoose **OpenAI Compatible** as the provider.\n\n### Enter API Details\n\n- **Base URL:** `https://api.bluesminds.com/v1`\n- **API Key:** `sk-your-bluesminds-key`\n- **Model:** `claude-sonnet-4-5` (or any model from `/v1/models`)\n::\n\n::alert{type=\"info\" icon=\"lucide:key\"}\nGet your API key at [api.bluesminds.com/console](https://api.bluesminds.com/console){target=\"_blank\"} → **Tokens** → **Create New Token**.\n::\n\n## Recommended Models\n\n| Model | Best For |\n|-------|----------|\n| `claude-sonnet-4-5` | Balanced quality/speed **(recommended)** |\n| `gpt-4o` | Fast general purpose |\n| `deepseek-chat` | Cost-efficient |\n\n## Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| Connection error | Verify base URL is `https://api.bluesminds.com/v1` |\n| Auth failed | Re-enter API key in settings |\n| Model not found | Check available models with `GET /v1/models` |\n\n## Next Steps\n\n:read-more{title=\"Models & Pricing\" to=\"/about/models-and-pricing\"}\n:read-more{title=\"Kilocode Setup\" to=\"/quick-start/kilocode\"}\n```\n\n---\n\n### Task 11: Create Kilocode page (NEW)\n\n**Files:**\n- Create: `content/1.quick-start/8.kilocode.md`\n\n```markdown\n---\ntitle: Kilocode\ndescription: Use Kilocode with BluesMinds for AI-powered development.\nicon: lucide:zap\n---\n\n::alert{type=\"warning\" icon=\"lucide:alert-triangle\"}\n**Paid plan required.** Coding tools need a Trial ($5/day) plan or higher.\n[Get a plan →](https://api.bluesminds.com/console){target=\"_blank\"}\n::\n\n## Install Kilocode\n\nInstall the [Kilocode extension](https://marketplace.visualstudio.com/items?itemName=kilocode.kilocode) from the VS Code marketplace.\n\n## Configure\n\n::steps\n### Open Kilocode Settings\n\nClick the Kilocode icon in the sidebar → **Settings**\n\n### Select API Provider\n\nChoose **OpenAI Compatible** as the provider.\n\n### Enter API Details\n\n- **Base URL:** `https://api.bluesminds.com/v1`\n- **API Key:** `sk-your-bluesminds-key`\n- **Model:** `gpt-4o` (or any model from `/v1/models`)\n::\n\n::alert{type=\"info\" icon=\"lucide:key\"}\nGet your API key at [api.bluesminds.com/console](https://api.bluesminds.com/console){target=\"_blank\"} → **Tokens** → **Create New Token**.\n::\n\n## Recommended Models\n\n| Model | Best For |\n|-------|----------|\n| `gpt-4o` | Fast general purpose **(recommended)** |\n| `claude-sonnet-4-5` | High quality code generation |\n| `deepseek-chat` | Cost-efficient |\n\n## Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| Connection error | Verify base URL ends with `/v1` |\n| Auth failed | Re-enter API key in settings |\n| No completions | Ensure model ID is valid |\n\n## Next Steps\n\n:read-more{title=\"Models & Pricing\" to=\"/about/models-and-pricing\"}\n:read-more{title=\"RooCode Setup\" to=\"/quick-start/roocode\"}\n```\n\n---\n\n### Task 12: Create Qwen Code page (NEW)\n\n**Files:**\n- Create: `content/1.quick-start/9.qwen-code.md`\n\n```markdown\n---\ntitle: Qwen Code\ndescription: Use Qwen Code with BluesMinds for Alibaba's AI coding assistant.\nicon: lucide:bot\n---\n\n::alert{type=\"warning\" icon=\"lucide:alert-triangle\"}\n**Paid plan required.** Coding tools need a Trial ($5/day) plan or higher.\n[Get a plan →](https://api.bluesminds.com/console){target=\"_blank\"}\n::\n\n## Set Environment Variables\n\n::tabs{variant=\"card\"}\n ::div{label=\"Linux / macOS\" icon=\"lucide:terminal\"}\n ```bash\n export OPENAI_BASE_URL=https://api.bluesminds.com/v1\n export OPENAI_API_KEY=sk-your-bluesminds-key\n ```\n ::\n\n ::div{label=\"Windows PowerShell\" icon=\"lucide:terminal\"}\n ```powershell\n $env:OPENAI_BASE_URL = \"https://api.bluesminds.com/v1\"\n $env:OPENAI_API_KEY = \"sk-your-bluesminds-key\"\n ```\n ::\n::\n\n::alert{type=\"info\" icon=\"lucide:key\"}\nGet your API key at [api.bluesminds.com/console](https://api.bluesminds.com/console){target=\"_blank\"} → **Tokens** → **Create New Token**.\n::\n\n## Run It\n\n```bash\nqwen\n```\n\n## Recommended Models\n\n| Model | Best For |\n|-------|----------|\n| `gpt-4o` | General purpose **(recommended)** |\n| `claude-sonnet-4-5` | High quality code generation |\n\n## Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| `401 Unauthorized` | Verify `OPENAI_API_KEY` starts with `sk-` |\n| Model not found | Check models with `GET /v1/models` |\n\n## Next Steps\n\n:read-more{title=\"Models & Pricing\" to=\"/about/models-and-pricing\"}\n:read-more{title=\"Droid CLI Setup\" to=\"/quick-start/droid-cli\"}\n```\n\n---\n\n### Task 13: Create Droid CLI page (NEW)\n\n**Files:**\n- Create: `content/1.quick-start/10.droid-cli.md`\n\n```markdown\n---\ntitle: Droid CLI\ndescription: Use Droid CLI with BluesMinds for terminal-based AI coding.\nicon: lucide:smartphone\n---\n\n::alert{type=\"warning\" icon=\"lucide:alert-triangle\"}\n**Paid plan required.** Coding tools need a Trial ($5/day) plan or higher.\n[Get a plan →](https://api.bluesminds.com/console){target=\"_blank\"}\n::\n\n## Set Environment Variables\n\n::tabs{variant=\"card\"}\n ::div{label=\"Linux / macOS\" icon=\"lucide:terminal\"}\n ```bash\n export ANTHROPIC_BASE_URL=https://api.bluesminds.com/\n export ANTHROPIC_API_KEY=sk-your-bluesminds-key\n ```\n ::\n\n ::div{label=\"Windows PowerShell\" icon=\"lucide:terminal\"}\n ```powershell\n $env:ANTHROPIC_BASE_URL = \"https://api.bluesminds.com/\"\n $env:ANTHROPIC_API_KEY = \"sk-your-bluesminds-key\"\n ```\n ::\n::\n\n::alert{type=\"info\" icon=\"lucide:key\"}\nGet your API key at [api.bluesminds.com/console](https://api.bluesminds.com/console){target=\"_blank\"} → **Tokens** → **Create New Token**.\n::\n\n## Run It\n\n```bash\ndroid\n```\n\n## Troubleshooting\n\n| Problem | Solution |\n|---------|----------|\n| `401 Unauthorized` | Verify key starts with `sk-` |\n| Connection error | Check base URL formatting |\n\n## Next Steps\n\n:read-more{title=\"Models & Pricing\" to=\"/about/models-and-pricing\"}\n:read-more{title=\"Claude Code Setup\" to=\"/quick-start/claude-code\"}\n```\n\n---\n\n### Task 14: Commit Phase 2\n\n```bash\ngit add content/1.quick-start/\ngit commit -m \"feat: add 7 new tool quickstart pages with OS tabs and paid-plan warnings\"\n```\n\n---\n\n## Phase 3: Create Models & Pricing Page\n\n### Task 15: Create combined Models & Pricing page\n\n**Files:**\n- Create: `content/2.about/2.models-and-pricing.md`\n- Delete: old `content/1.getting-started/4.models.md` (already moved/deleted in Phase 1)\n\n```markdown\n---\ntitle: Models & Pricing\ndescription: Plans, rate limits, available models, and pricing for BluesMinds.\nicon: lucide:cpu\n---\n\nAll 100+ models are accessible through every plan. Plans differ by **usage quotas**, **rate limits**, and **context window access**.\n\n## Plans\n\n| | Free | Trial ⚡ | 10-Day Pass | Unlimited | Enterprise |\n|---|---|---|---|---|---|\n| **Price** | $0 | $5 / 24hrs | $25 / 10 days | $60 / month | Custom |\n| **Requests** | 300/day | Unlimited | Unlimited | Unlimited | Custom |\n| **RPM** | 20 | 15 | 15 | 15 | Custom |\n| **Model Access** | Limited subset | Good quality | Good quality | All available | All + priority |\n| **Context Window** | ~50% | Full | Full | Full | Full |\n| **Coding Tools** | ✕ | ✓ | ✓ | ✓ | ✓ |\n| **Uptime SLA** | — | — | 90% | 90% | Custom |\n| | [Start Free](https://api.bluesminds.com/console){target=\"_blank\"} | [Buy](https://api.bluesminds.com/console){target=\"_blank\"} | [Buy](https://api.bluesminds.com/console){target=\"_blank\"} | [Buy](https://api.bluesminds.com/console){target=\"_blank\"} | [Contact](https://t.me/apibluesminds){target=\"_blank\"} |\n\n::alert{type=\"info\" icon=\"lucide:gift\"}\n**Free forever:** Every new account receives **500 pi credits** on signup. No credit card required. Credits never expire.\n::\n\n::alert{type=\"warning\" icon=\"lucide:alert-triangle\"}\n**Coding tools** (Claude Code, Cursor, Codex CLI, etc.) require a **paid plan** (Trial or higher). Free accounts cannot use coding tools.\n::\n\n## RPM Add-Ons\n\nNeed more requests per minute? Purchase RPM add-ons:\n\n::tabs{variant=\"card\"}\n ::div{label=\"10-Day Pass\" icon=\"lucide:zap\"}\n | Extra RPM | Cost |\n |-----------|------|\n | +5 RPM | $5 |\n | +10 RPM | $5 per 5 |\n | +15 RPM | $4 per 5 |\n | +20+ RPM | $4 per 5 |\n ::\n\n ::div{label=\"Unlimited Plan\" icon=\"lucide:infinity\"}\n | Extra RPM | Cost |\n |-----------|------|\n | +5 RPM | $10 |\n | +10 RPM | $9 per 5 |\n | +15 RPM | $8 per 5 |\n | +20+ RPM | $7 per 5 |\n ::\n::\n\n## Popular Models\n\n| Provider | Model | Best For | Context |\n|----------|-------|----------|---------|\n| OpenAI | `gpt-4o` | General purpose, fast | 128k |\n| OpenAI | `gpt-4.1` | Huge context window | 1M |\n| Anthropic | `claude-sonnet-4-5` | Balanced quality/speed | 200k |\n| Anthropic | `claude-opus-4-5` | Complex reasoning | 200k |\n| Google | `gemini-2.0-flash` | Fast, multimodal | 1M |\n| Google | `gemini-2.5-pro` | Best quality | 1M |\n| DeepSeek | `deepseek-chat` | Cost-efficient | 64k |\n| DeepSeek | `deepseek-reasoner` | Reasoning chains | 64k |\n| xAI | `grok-3` | Alternative reasoning | 128k |\n\n::alert{type=\"info\" icon=\"lucide:lightbulb\"}\n**Full model list:** Query the API for real-time availability:\n```bash\ncurl https://api.bluesminds.com/v1/models \\\n -H \"Authorization: Bearer $BLUESMINDS_API_KEY\"\n```\n::\n\n## Pi Credits\n\n- Every API request deducts credits based on the model used\n- Live per-model rates at [api.bluesminds.com/pricing](https://api.bluesminds.com/pricing){target=\"_blank\"}\n- Free tier: 500 pi credits on signup, never expire\n- Paid plans: quota depends on plan (see table above)\n\n## Payment Methods\n\n- Credit and debit cards\n- Cryptocurrency\n- Enterprise: custom invoicing via [Telegram](https://t.me/apibluesminds){target=\"_blank\"}\n\n## Next Steps\n\n:read-more{title=\"API Quickstart\" to=\"/quick-start/api-quickstart\"}\n:read-more{title=\"Provider Routing\" to=\"/features/provider-routing\"}\n:read-more{title=\"FAQ\" to=\"/about/faq\"}\n```\n\n---\n\n### Task 16: Commit Phase 3\n\n```bash\ngit add content/2.about/2.models-and-pricing.md\ngit commit -m \"feat: add combined Models & Pricing page with plan tiers and RPM add-ons\"\n```\n\n---\n\n## Phase 4: Update Cross-References & Landing Page\n\n### Task 17: Update index.md (landing page)\n\n**Files:**\n- Modify: `content/index.md`\n\n**Changes:**\n- Update hero CTA links to new paths\n- Update card links to new paths\n- Update \"Start in 30 seconds\" section\n- Add a \"Pick Your Tool\" section before the pricing cards\n\nReplace relevant link targets:\n- `/getting-started/quickstart` → `/quick-start/api-quickstart`\n- `/getting-started/models` → `/about/models-and-pricing`\n- `/features/provider-routing` → `/features/provider-routing` (unchanged)\n- `/integrations/claude-code` → `/quick-start/claude-code`\n\nAdd new section after \"Start in 30 seconds\":\n\n```markdown\n## Pick Your Coding Tool\n\n::card-group{cols=3}\n ::card\n ---\n title: Claude Code\n icon: lucide:terminal\n to: /quick-start/claude-code\n ---\n Set 2 env vars, run `claude`. Done in 30 seconds.\n ::\n\n ::card\n ---\n title: Cursor\n icon: lucide:mouse-pointer\n to: /quick-start/cursor\n ---\n Configure in Settings → Models. Any model, one key.\n ::\n\n ::card\n ---\n title: Codex CLI\n icon: lucide:square-terminal\n to: /quick-start/codex-cli\n ---\n Set 2 env vars, run `codex`. OpenAI-compatible.\n ::\n::\n\n:read-more{title=\"See all supported tools\" to=\"/quick-start/api-quickstart\"}\n```\n\n---\n\n### Task 18: Update FAQ page internal links\n\n**Files:**\n- Modify: `content/2.about/4.faq.md`\n\nUpdate internal link `/features/tool-calling` stays the same. No broken links expected since features paths didn't change.\n\n---\n\n### Task 19: Update Introduction page internal links\n\n**Files:**\n- Modify: `content/2.about/1.introduction.md`\n\nUpdate Quick Links table targets:\n- Quickstart → `/quick-start/api-quickstart`\n- Models → `/about/models-and-pricing`\n- FAQ → `/about/faq`\n- API Reference → `/api/bluesminds-api` (unchanged)\n\n---\n\n### Task 20: Commit Phase 4\n\n```bash\ngit add -A\ngit commit -m \"fix: update all cross-references to new URL structure\"\n```\n\n---\n\n## Phase 5: Verify & Polish\n\n### Task 21: Start dev server and verify all pages load\n\n**Run:** `cd D:\\dev\\mind && npx nuxt dev`\n\n**Check each page manually:**\n- [ ] `/quick-start/api-quickstart` — loads, tabs work\n- [ ] `/quick-start/claude-code` — loads, OS tabs work\n- [ ] `/quick-start/codex-cli` — loads\n- [ ] `/quick-start/gemini-cli` — loads\n- [ ] `/quick-start/cursor` — loads\n- [ ] `/quick-start/continue-dev` — loads\n- [ ] `/quick-start/roocode` — loads\n- [ ] `/quick-start/kilocode` — loads\n- [ ] `/quick-start/qwen-code` — loads\n- [ ] `/quick-start/droid-cli` — loads\n- [ ] `/quick-start/openclaw` — loads\n- [ ] `/about/introduction` — loads, links work\n- [ ] `/about/models-and-pricing` — loads, tabs work\n- [ ] `/about/principles` — loads\n- [ ] `/about/faq` — loads\n- [ ] `/features/*` — all 5 pages load\n- [ ] `/api/bluesminds-api` — loads\n- [ ] `/` — landing page, all cards link correctly\n- [ ] Sidebar shows correct order: Quick Start → About → Features → API Reference\n- [ ] Header dropdowns work\n\n### Task 22: Fix any broken links or build errors\n\nAddress any issues found in Task 21.\n\n### Task 23: Final commit\n\n```bash\ngit add -A\ngit commit -m \"docs: complete site restructure — Quick Start first with 10 tool pages\"\n```\n"}}, "content/4.api/1.bluesminds-api.md": {"cae6cacb1027263ae11f9070d62b9184b314ac5f": {"t": 1785746565.5606105, "n": 4238, "h": "e36d99dd5f4420f7", "c": "---\ntitle: BluesMinds API\ndescription: Complete API reference for BluesMinds endpoints.\nicon: lucide:code\n---\n\n## Base URL\n\n```\nhttps://api.bluesminds.com/v1\n```\n\n## Authentication\n\n| Surface | Auth Method | Example |\n|---------|------------|---------|\n| **LLM endpoints** | Bearer token | `Authorization: Bearer sk-...` |\n| **Management** | Session token | Obtained via login |\n\n## Core Endpoints\n\n### Chat Completions\n\n```bash\nPOST /v1/chat/completions\n```\n\n```python\nfrom openai import OpenAI\n\nclient = OpenAI(\n api_key=\"sk-your-api-key\",\n base_url=\"https://api.bluesminds.com/v1\"\n)\n\nresponse = client.chat.completions.create(\n model=\"gpt-4o\",\n messages=[{\"role\": \"user\", \"content\": \"Hello!\"}],\n)\n```\n\n### List Models\n\n```bash\nGET /v1/models\n```\n\nReturns all available models for your plan tier.\n\n### Anthropic-style Messages\n\n```bash\nPOST /v1/messages\n```\n\nFor apps built against the Anthropic SDK — accepts native Anthropic message format.\n\n### Image Generation\n\n```bash\nPOST /v1/images/generations\n```\n\n## Available Models\n\n| Provider | Model | Context | Group |\n|----------|-------|---------|-------|\n| OpenAI | `gpt-4o` | 128k | default |\n| OpenAI | `gpt-4.1` | 1M | default |\n| Anthropic | `claude-sonnet-4-5` | 200k | default |\n| Anthropic | `claude-opus-4-5` | 200k | vip |\n| Google | `gemini-2.0-flash` | 1M | default |\n| Google | `gemini-2.5-pro` | 1M | default |\n| DeepSeek | `deepseek-chat` | 128k | default |\n| DeepSeek | `deepseek-reasoner` | 128k | default |\n\n## Pricing\n\n| Plan | Price | Credits | RPM |\n|------|-------|---------|-----|\n| **Free** | $0 | 500 pi credits (never expire) | 20 |\n| **Trial Pack** | $5 / 24hrs | Unlimited | 15 |\n| **10-Day Pass** | $25 / 10 days | Unlimited | 15 |\n| **Unlimited** | $60 / month | Unlimited | 15 |\n| **Enterprise** | Custom | Custom | Custom |\n\n### Credit Costs (Free Tier)\n\n| Model | Cost per Request |\n|-------|-----------------|\n| `claude-opus-4-5` | 20 pi credits |\n| `claude-sonnet-4-5` | 10 pi credits |\n| Other models | Varies |\n\n## Error Handling\n\n### Response Format\n\n**Success:**\n\n```json\n{\n \"id\": \"chatcmpl-abc123\",\n \"object\": \"chat.completion\",\n \"model\": \"gpt-4o\",\n \"choices\": [\n {\n \"index\": 0,\n \"message\": {\n \"role\": \"assistant\",\n \"content\": \"Hello! How can I help?\"\n },\n \"finish_reason\": \"stop\"\n }\n ],\n \"usage\": {\n \"prompt_tokens\": 10,\n \"completion_tokens\": 15,\n \"total_tokens\": 25\n }\n}\n```\n\n**Error:**\n\n```json\n{\n \"error\": {\n \"message\": \"Model not found\",\n \"type\": \"invalid_request_error\",\n \"code\": \"model_not_found\"\n }\n}\n```\n\n### Error Codes\n\n| Status | Code | Action |\n|--------|------|--------|\n| `401` | Unauthorized | Check API key format and header |\n| `403` | Forbidden | Key lacks permission for this resource |\n| `404` | Not found | Model unavailable — refresh `/v1/models` |\n| `429` | Rate limited | Backoff with jitter; check `Retry-After` |\n| `500` | Server error | Retry with exponential backoff |\n\n::callout{type=\"warning\" icon=\"lucide:alert-triangle\"}\n**Retry logic:** Retry on `429` and `500` with exponential backoff. Never retry `401`, `403`, or `404` without fixing inputs.\n::\n\n## SDK Compatibility\n\nBluesMinds is compatible with any OpenAI SDK by setting `base_url`:\n\n::tabs{variant=\"card\"}\n ::div{label=\"Python\" icon=\"lucide:code\"}\n ```python\n from openai import OpenAI\n client = OpenAI(\n api_key=\"sk-...\",\n base_url=\"https://api.bluesminds.com/v1\"\n )\n ```\n ::\n\n ::div{label=\"Node.js\" icon=\"lucide:file-code\"}\n ```javascript\n import OpenAI from \"openai\";\n const client = new OpenAI({\n apiKey: \"sk-...\",\n baseURL: \"https://api.bluesminds.com/v1\",\n });\n ```\n ::\n\n ::div{label=\"cURL\" icon=\"lucide:terminal\"}\n ```bash\n curl https://api.bluesminds.com/v1/chat/completions \\\n -H \"Authorization: Bearer sk-...\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"model\":\"gpt-4o\",\"messages\":[{\"role\":\"user\",\"content\":\"Hi\"}]}'\n ```\n ::\n::\n\n::callout{type=\"info\" icon=\"lucide:info\"}\n**Embeddings and more:** BluesMinds also supports `/v1/embeddings`, `/v1/responses`, `/v1/audio/speech`, `/v1/audio/transcriptions`, and `/v1/rerank`. See [Models & Pricing](/about/models-and-pricing#api-endpoints) for the full endpoint list.\n::\n"}, "b3006592601a71c9597eba91ac99bac9497f52f0": {"t": 1785765649.674126, "n": 4086, "h": "711812d9c4c9f880", "c": "---\ntitle: BluesMinds API\ndescription: Complete API reference for BluesMinds endpoints.\nicon: lucide:code\n---\n\n## Base URL\n\n```\nhttps://api.bluesminds.com/v1\n```\n\n## Authentication\n\n| Surface | Auth Method | Example |\n|---------|------------|---------|\n| **LLM endpoints** | Bearer token | `Authorization: Bearer sk-...` |\n| **Management** | Session token | Obtained via login |\n\n## Core Endpoints\n\n### Chat Completions\n\n```bash\nPOST /v1/chat/completions\n```\n\n```python\nfrom openai import OpenAI\n\nclient = OpenAI(\n api_key=\"sk-your-api-key\",\n base_url=\"https://api.bluesminds.com/v1\"\n)\n\nresponse = client.chat.completions.create(\n model=\"gpt-4o\",\n messages=[{\"role\": \"user\", \"content\": \"Hello!\"}],\n)\n```\n\n### List Models\n\n```bash\nGET /v1/models\n```\n\nReturns all available models for your plan tier.\n\n### Anthropic-style Messages\n\n```bash\nPOST /v1/messages\n```\n\nFor apps built against the Anthropic SDK — accepts native Anthropic message format.\n\n### Image Generation\n\n```bash\nPOST /v1/images/generations\n```\n\n## Available Models\n\n| Provider | Model | Context | Group |\n|----------|-------|---------|-------|\n| OpenAI | `gpt-4o` | 128k | default |\n| OpenAI | `gpt-4.1` | 1M | default |\n| Anthropic | `claude-sonnet-4-5` | 200k | default |\n| Anthropic | `claude-opus-4-5` | 200k | premium |\n| Google | `gemini-2.0-flash` | 1M | default |\n| Google | `gemini-2.5-pro` | 1M | default |\n| DeepSeek | `deepseek-chat` | 128k | default |\n| DeepSeek | `deepseek-reasoner` | 128k | default |\n\n## Pricing\n\n| Plan | Price | Credits | RPM |\n|------|-------|---------|-----|\n| **Free** | $0 | 500 pi credits (never expire) | 20 |\n| **Trial Pack** | $5 / 24hrs | Unlimited | 10 |\n| **10-Day Pass** | $25 / 10 days | Unlimited | 10 |\n| **Unlimited** | $60 / month | Unlimited | 15 |\n| **Enterprise** | Custom | Custom | Custom |\n\n### Credit Costs (Free Tier)\n\n| Model | Cost per Request |\n|-------|-----------------|\n| `claude-opus-4-5` | 20 pi credits |\n| `claude-sonnet-4-5` | 10 pi credits |\n| Other models | Varies |\n\n## Error Handling\n\n### Response Format\n\n**Success:**\n\n```json\n{\n \"id\": \"chatcmpl-abc123\",\n \"object\": \"chat.completion\",\n \"model\": \"gpt-4o\",\n \"choices\": [\n {\n \"index\": 0,\n \"message\": {\n \"role\": \"assistant\",\n \"content\": \"Hello! How can I help?\"\n },\n \"finish_reason\": \"stop\"\n }\n ],\n \"usage\": {\n \"prompt_tokens\": 10,\n \"completion_tokens\": 15,\n \"total_tokens\": 25\n }\n}\n```\n\n**Error:**\n\n```json\n{\n \"error\": {\n \"message\": \"Model not found\",\n \"type\": \"invalid_request_error\",\n \"code\": \"model_not_found\"\n }\n}\n```\n\n### Error Codes\n\n| Status | Code | Action |\n|--------|------|--------|\n| `401` | Unauthorized | Check API key format and header |\n| `403` | Forbidden | Key lacks permission for this resource |\n| `404` | Not found | Model unavailable — refresh `/v1/models` |\n| `429` | Rate limited | Backoff with jitter; check `Retry-After` |\n| `500` | Server error | Retry with exponential backoff |\n\n::callout{type=\"warning\" icon=\"lucide:alert-triangle\"}\n**Retry logic:** Retry on `429` and `500` with exponential backoff. Never retry `401`, `403`, or `404` without fixing inputs.\n::\n\n## SDK Compatibility\n\nBluesMinds is compatible with any OpenAI SDK by setting `base_url`:\n\n::tabs{variant=\"card\"}\n ::div{label=\"Python\" icon=\"lucide:code\"}\n ```python\n from openai import OpenAI\n client = OpenAI(\n api_key=\"sk-...\",\n base_url=\"https://api.bluesminds.com/v1\"\n )\n ```\n ::\n\n ::div{label=\"Node.js\" icon=\"lucide:file-code\"}\n ```javascript\n import OpenAI from \"openai\";\n const client = new OpenAI({\n apiKey: \"sk-...\",\n baseURL: \"https://api.bluesminds.com/v1\",\n });\n ```\n ::\n\n ::div{label=\"cURL\" icon=\"lucide:terminal\"}\n ```bash\n curl https://api.bluesminds.com/v1/chat/completions \\\n -H \"Authorization: Bearer sk-...\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"model\":\"gpt-4o\",\"messages\":[{\"role\":\"user\",\"content\":\"Hi\"}]}'\n ```\n ::\n::\n\n::callout{type=\"info\" icon=\"lucide:info\"}\n**No embeddings:** Embedding endpoints are not currently available through BluesMinds.\n::\n"}}}} |