FAQs

Common questions and answers about BlueNexus AI.

General Questions

What is BlueNexus AI?

BlueNexus AI is a developer platform that makes it easier for builders of AI applications. We provide secure, scalable infrastructure and tools including data management, AI services, connection management, and MCP integration.

How is BlueNexus AI different from other platforms?

• TEE Infrastructure: All operations run on secure Trusted Execution Environment infrastructure

• Comprehensive AI Services: Access to multiple LLM providers through a unified API

• Easy Integration: Simple RESTful API with official SDKs for popular languages

• Security First: Built-in security with hardware-level protection

What programming languages are supported?

We provide official SDKs for:

• Python

• JavaScript/Node.js

• Go

• Ruby

Community libraries are available for:

• PHP

• Java

• C#

• And more

Is there a free tier?

Yes! Our free tier includes:

• 10,000 API calls per month

• 1 GB data storage

• 5 connections

• 100,000 LLM tokens per month

Account and Billing

How do I create an account?

1. Visit app.bluenexus.ai

2. Click "Sign Up"

3. Enter your email address

4. Verify your email

5. Complete your profile

How do I get my API key?

1. Log into your BlueNexus AI dashboard

2. Navigate to Settings → API Keys

3. Click Create New API Key

4. Give your key a descriptive name

5. Copy the generated key (you won't see it again!)

How does billing work?

• Free Tier: No credit card required

• Pro Plan: Monthly or annual billing

• Enterprise: Custom pricing and billing

Can I change my plan?

Yes, you can upgrade or downgrade your plan at any time. Changes take effect immediately, and billing is prorated.

What payment methods do you accept?

We accept all major credit cards, PayPal, and bank transfers for enterprise customers.

API and Development

How do I make my first API call?

curl -X GET "https://api.bluenexus.ai/api/v1/accounts/me" \
  -H "Authorization: Bearer YOUR_API_KEY"

What is the API rate limit?

Rate limits vary by plan:

• Free: 100 requests/minute

• Pro: 1,000 requests/minute

• Enterprise: 10,000 requests/minute

How do I handle rate limits?

Implement exponential backoff:

async function makeRequestWithBackoff(url, options) {
  try {
    const response = await fetch(url, options);
    
    if (response.status === 429) {
      const error = await response.json();
      const retryAfter = error.error.details.retry_after;
      await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
      return makeRequestWithBackoff(url, options);
    }
    
    return response;
  } catch (error) {
    throw error;
  }
}

Can I use the API without an SDK?

Yes! The API is RESTful and can be used with any HTTP client. However, our SDKs provide additional features like automatic retry logic and type safety.

Data Management

How do I store data?

Use the Data API to create collections and store records:

curl -X POST "https://api.bluenexus.ai/api/v1/data/users" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "John Doe", "email": "[email protected]"}'

What data types are supported?

We support all JSON data types:

• Strings, numbers, booleans

• Arrays and objects

• Nested structures

• Binary data (base64 encoded)

How do I query my data?

Use filters in your GET requests:

curl -X GET "https://api.bluenexus.ai/api/v1/data/users?filter={\"age\":{\"$gte\":18}}" \
  -H "Authorization: Bearer YOUR_API_KEY"

Is my data encrypted?

Yes! All data is encrypted:

• At rest: AES-256 encryption

• In transit: TLS 1.3 encryption

• In memory: TEE memory encryption

AI Services

What AI models are available?

We support models from multiple providers:

• OpenAI: GPT-4, GPT-3.5-turbo

• Anthropic: Claude-3-opus, Claude-3-sonnet

• Meta: Llama-2-70b

• Mistral: Mistral-7b

How do I use AI models?

curl -X POST "https://api.bluenexus.ai/api/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

How are AI costs calculated?

Costs are based on token usage:

• Input tokens: Text you send to the model

• Output tokens: Text the model generates

• Pricing: Varies by model (see our pricing page)

Can I stream AI responses?

Yes! Set "stream": true in your request:

{
  "model": "gpt-3.5-turbo",
  "messages": [{"role": "user", "content": "Hello!"}],
  "stream": true
}

Connections and Integrations

What services can I connect to?

We support OAuth integration with:

• Productivity: Google Workspace, Microsoft 365, Slack

• Development: GitHub, GitLab, Jira

• Analytics: Google Analytics, Mixpanel

• Communication: Discord, Telegram

• Storage: Dropbox, Google Drive

• CRM: Salesforce, HubSpot

How do I set up OAuth?

1. Create a connection using the Connections API

2. Redirect users to the authorization URL

3. Handle the callback with the authorization code

4. Exchange the code for access tokens

How do I refresh expired tokens?

Use the refresh endpoint:

curl -X PUT "https://api.bluenexus.ai/api/v1/connections/{connectionId}/refresh" \
  -H "Authorization: Bearer YOUR_API_KEY"

Security

How secure is BlueNexus AI?

Very secure! We use:

• TEE Infrastructure: Hardware-level security

• Encryption: AES-256 at rest, TLS 1.3 in transit

• Compliance: SOC 2, ISO 27001, GDPR, CCPA

• Audits: Regular third-party security audits

Where is my data stored?

Data is stored in secure, encrypted databases in multiple regions. You can choose your preferred region during setup.

Can I export my data?

Yes! You can export all your data at any time through the API or dashboard.

How do I delete my data?

You can delete individual records or entire collections through the API. For complete account deletion, contact support.

MCP Servers

What is MCP?

MCP (Model Context Protocol) is a standard for connecting AI models to external tools and data sources.

How do I use MCP servers?

curl -X POST "https://api.bluenexus.ai/api/v1/mcps/server_123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

Can I create custom MCP servers?

Yes! You can create custom MCP servers and connect them to BlueNexus AI. See our MCP development guide for details.

Troubleshooting

I'm getting a 401 Unauthorized error

Check:

1. Your API key is correct

2. You're using Bearer in the Authorization header

3. Your API key hasn't expired

4. You have the required permissions

I'm getting a 429 Rate Limit error

This means you've exceeded your rate limit. Implement exponential backoff or upgrade your plan.

My AI requests are slow

AI model response times vary by:

• Model complexity

• Input length

• Current load

• Your location

Try using a faster model or implementing caching.

I can't connect to external services

Check:

1. Your OAuth configuration

2. The service is not down

3. Your connection tokens are valid

4. You have the required scopes

Getting Help

Where can I get help?

• Documentation: Comprehensive guides and references

• Community Forum: community.bluenexus.ai

• GitHub: github.com/bluenexus

• Email Support: [email protected]

How do I report a bug?

1. Check if it's already reported on GitHub

2. Create a new issue with:

   • Clear description

   • Steps to reproduce

   • Expected vs actual behavior

   • Error messages and logs

How do I request a feature?

1. Check existing feature requests

2. Create a new issue with:

   • Clear description

   • Use case and benefits

   • Implementation suggestions

   • Community support

Related Documentation

• Getting Started - Platform setup

• API Reference - Complete API documentation

• Contact Support - Get help from our team

• Community Guidelines - Community participation