bluenexus.ai Get API Key

Pricing and Credits

BlueNexus uses a credit-based billing system for LLM and tool usage.

Credits

  • 1 credit = $0.0001 USD
  • New accounts start with 100,000 credits ($10.00) — enough to explore the platform and build your first integrations
  • Credits are consumed by LLM completions, MCP tool calls, and agent tool executions

Credit Consumption

LLM Chat Completions

Credits are calculated based on token usage and model pricing tier:

credits = ceil((prompt_tokens * prompt_rate + completion_tokens * completion_rate) / 1,000,000)

Pricing varies by model tier (budget to flagship).

MCP Tool Calls

MCP requests (POST /mcp with tools/call) consume credits based on the underlying LLM token usage required to process your request.

Agent Tool Execution

Custom tools run in sandboxes with per-second billing:

Tool Type Rate
Default tools 2 credits/second
E2B sandbox tools 4 credits/second

Minimum charge: 1 second.

External API Pass-Through

Pricing for external API pass-through is variable depending on the third-party service being accessed.

Credit Headers

All credit-consuming endpoints return these response headers:

Header Description
X-Credits-Consumed Credits used for this request
X-Credits-Remaining Account balance after this request

Credit Exhaustion

When credits reach zero, credit-guarded endpoints return 402 Payment Required:

{
  "error": "CreditsExhaustedError",
  "message": "Insufficient credit balance",
  "statusCode": 402
}

Credit-guarded endpoints:

  • POST /mcp
  • POST /v1/agents/:id/chat/completions
  • POST /v1/chat/completions

Checking Balance

Your current balance is available via:

  • The X-Credits-Remaining response header on any credit-consuming request
  • GET /v1/accounts/me — includes creditBalance field

Transaction History

curl https://api.bluenexus.ai/api/v1/credit-transactions \
  -H "Authorization: Bearer $TOKEN"

Returns a paginated list of credit charges and additions.

Getting More Credits

During the alpha period, contact the BlueNexus team to request additional credits if you hit your limit.