API Documentation

Introduction

Modexia gives you access to 100+ AI models through one API. No juggling multiple API keys, no complex billing. Just make calls and pay per request.

Key Features

• ✨ 100+ AI Models - One API for everything
• 💳 Simple Payment - Use your credit card, we handle the rest
• 🛡️ Automatic Limits - Set budgets that can't be exceeded
• 📊 Cost Transparency - See exact costs before each call
• 🔍 Complete History - Track every request and payment

Quick Start

Get started in 3 steps:

1. Sign Up

Create your account at Modexia Dashboard. Get 10 free API calls to test.

2. Add Your Credit Card

Add your payment method. We handle the crypto conversion automatically.

3. Get Your API Key

Generate your API key from the dashboard and start making calls:

import requests

response = requests.post('https://api.modexia.ai/v1/request', 
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'provider': 'openai',
        'model': 'gpt-4',
        'prompt': 'Hello, world!',
        'max_tokens': 100
    }
)

print(response.json())

Authentication

Every API request needs your API key in the header.

Get Your API Key

1. Open your Modexia Dashboard
2. Go to Settings → API Keys
3. Click "Generate New Key"
4. Copy it somewhere safe

Making Requests

curl -X POST https://api.modexia.ai/v1/request \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "openai",
    "model": "gpt-4",
    "prompt": "Hello!"
  }'

Making Requests

The Modexia API accepts JSON-formatted requests with the following structure:

Request Parameters

Example Request

const response = await fetch('https://api.modexia.ai/v1/request', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    provider: 'openai',
    model: 'gpt-4',
    prompt: 'Explain quantum computing in simple terms',
    max_tokens: 500,
    temperature: 0.7,
    agent_id: 'my_research_agent'
  })
});

const data = await response.json();
console.log(data);

Response Format

Modexia returns structured JSON responses with detailed information about the request processing.

Success Response

{
  "status": "success",
  "decision": "approved",
  "confidence": 95,
  "agent_tier": "FLASH",
  "response": {
    "text": "Quantum computing uses quantum mechanics...",
    "tokens_used": 156,
    "finish_reason": "stop"
  },
  "cost": {
    "amount": 0.0078,
    "currency": "USD",
    "breakdown": {
      "input_tokens": 12,
      "output_tokens": 156
    }
  },
  "processing_time_ms": 892,
  "request_id": "req_abc123xyz"
}

Response Fields

Supported Models

Modexia provides access to 100+ AI models across multiple providers.

OpenAI

• gpt-4 - Most capable model
• gpt-4-turbo - Faster GPT-4 variant
• gpt-3.5-turbo - Fast and cost-effective

Anthropic

• claude-3-opus - Most powerful Claude
• claude-3-sonnet - Balanced performance
• claude-3-haiku - Fast and affordable

Google

• gemini-pro - Advanced reasoning
• gemini-flash - Speed optimized

Payments

Add your credit card to start making API calls. We handle everything else automatically.

How It Works

1. Add your credit card in the dashboard
2. Each API request charges the exact cost + 5% fee
3. View your spending history in real-time
4. Set budget limits to control costs

Why It's Simple

• 💳 Credit card only - No crypto knowledge needed
• ⚡ Instant payments - Start using APIs immediately
• 🔍 Full transparency - See every transaction in your dashboard
• 🌍 Global access - Works with any major credit card