API Documentation

OpenAI-compatible API. One key, every major AI model. Drop-in replacement for OpenAI, Anthropic, Google, and more.

โšก Quick Start

Botstrapp.ai is fully OpenAI-compatible. Use any OpenAI SDK โ€” just change the base URL and API key.

Python

python
from openai import OpenAI

client = OpenAI(
    base_url="https://botstrapp.ai/v1",
    api_key="bst_your_api_key_here",
)

response = client.chat.completions.create(
    model="gemini/gemini-2.5-flash",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)

JavaScript / Node.js

javascript
import OpenAI from 'openai';

const client = new OpenAI({
    baseURL: 'https://botstrapp.ai/v1',
    apiKey: 'bst_your_api_key_here',
});

const response = await client.chat.completions.create({
    model: 'gpt-4o',
    messages: [{ role: 'user', content: 'Hello!' }],
});
console.log(response.choices[0].message.content);

cURL

bash
curl https://botstrapp.ai/v1/chat/completions \
  -H "Authorization: Bearer bst_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
๐Ÿ’ก Getting an API Key Create a free account at botstrapp.ai/chat โ€” you'll receive 1,000 ICO credits instantly. Your API key is generated automatically and available in your account settings.

๐Ÿค– Available Models

Access models from 10+ providers through a single API. Use GET /v1/catalog for the live list.

TierCost per messageExample Models
Budget9 ICO (~$0.009)Gemini Flash, GPT-5 Mini, Llama 3.3, Claude Haiku, Qwen 3 30B, DeepSeek V3, Phi-4
Standard19 ICO (~$0.019)GPT-5, Claude Sonnet 4.6, Gemini Pro, Grok 3, Qwen 3 235B, Moonshot Kimi K2
Premium49 ICO (~$0.049)Claude Opus 4.6, GPT-5 Turbo, DeepSeek R1, Grok 3 Reasoning
๐Ÿ“ก Live Model List Fetch available models programmatically: GET /v1/models or GET /v1/catalog for detailed info including providers and availability status. The catalog is the single source of truth โ€” it powers the Chat UI and Pricing page dynamically.

๐ŸŽฏ Three Modes

Botstrapp.ai offers three interaction modes:

Modemodel valueDescription
๐Ÿ“ก ConnectorAny model IDYou pick the model. Direct connection to the provider.
๐Ÿ”€ Router"strap"Context-aware routing โ€” picks the best model based on your conversation history.
โšก Strap"strap"Smart routing โ€” we pick the best model for your message automatically.
๐ŸŽญ LCM"lcm"Large Character Model โ€” AI with persistent personality and memory.

๐Ÿ“ก API Endpoints

Chat

POST /v1/chat/completions

Send a chat message and get a response. Supports streaming.

ParameterTypeDescription
model requiredstringModel ID, "strap" for smart routing, or "lcm" for character mode
messages requiredarrayArray of message objects: {"role": "user"|"assistant"|"system", "content": "..."}
streambooleanEnable SSE streaming (default: false)
temperaturenumberSampling temperature 0-2 (default: model-specific)
max_tokensintegerMaximum output tokens

Models & Catalog

GET/v1/models

List available models (OpenAI-compatible format).

GET/v1/catalog

Rich model catalog with providers, tiers, availability. Add ?show_all=true for all models.

Auth

POST/v1/auth/register

Create account. Body: {"email", "password", "birth_year"}. Returns API key + 1,000 ICO bonus.

POST/v1/auth/login

Login. Body: {"email", "password"}. Returns API key + balance.

GET/v1/auth/me

Get current user profile and balance.

Billing & Credits

GET/v1/billing/balance

Get ICO balance, tier, and unlimited status.

POST/v1/billing/unlimited

Toggle unlimited mode. Body: {"enabled": true}. Removes rate limits; credits still apply. Auto-deactivates when balance < 1,000 ICO.

POST/v1/billing/checkout

Create Stripe checkout. Body: {"package_id": "starter"|"plus"|"pro"|"ultra"}.

GET/v1/billing/model-costs

Get ICO cost per model (pattern matching rules).

Partner Integration

GET/api/ico/rates

Public ICO pricing โ€” single source of truth for partner platforms (e.g., Gamind.net). Returns packages, exchange rate, and bonus tiers.

GET/v1/costs/estimate

Estimate cost before sending. Params: ?model=gpt-5&input_tokens=1000&output_tokens=500

๐Ÿ” Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer bst_your_api_key_here

Your API key starts with bst_ and is generated when you create an account. Keep it secret โ€” it controls access to your ICO credits.

๐Ÿ’Ž ICO Credits

Every API call costs ICO credits. 1 ICO = $0.001. New accounts receive 1,000 ICO free.

Buy more credits at botstrapp.ai/pricing or via the checkout API.

Unlimited Mode

Toggle unlimited mode via POST /v1/billing/unlimited or the โˆž checkbox in Chat. When active:

Designed for batch operations, character training, and heavy API usage.

๐Ÿ”ง Integration Example

Replace your existing OpenAI calls with Botstrapp.ai in 2 lines:

python
# Before (OpenAI only)
client = OpenAI(api_key="sk-...")

# After (Botstrapp.ai โ€” access ALL models)
client = OpenAI(
    base_url="https://botstrapp.ai/v1",
    api_key="bst_...",
)

# Now you can use any model โ€” same syntax:
client.chat.completions.create(model="gpt-4o", ...)
client.chat.completions.create(model="claude-sonnet-4-20250514", ...)
client.chat.completions.create(model="gemini/gemini-2.5-pro", ...)
client.chat.completions.create(model="groq/llama-3.3-70b-versatile", ...)
โšก Rate Limits Free tier: 10 requests/minute, 3 requests/minute for premium models. Activate unlimited mode or purchase ICO credits to remove limits. Rate limit headers are included in every response.

๐Ÿ“ฆ Response Format

Responses follow the standard OpenAI format:

json
{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "gpt-4o",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "Hello! How can I help you today?"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 9,
    "total_tokens": 21
  }
}

โŒ Error Codes

CodeMeaning
401Invalid or missing API key
402Insufficient ICO credits
429Rate limit exceeded (activate unlimited mode to bypass)
400Bad request (missing model or messages)
503Model temporarily unavailable

Need help? support@botstrapp.ai

Home ยท Pricing ยท Chat