uxo/ Cortex-1
Cortex-1 API Documentation

Build with intelligence.
Scale with confidence.

Cortex-1 is a premium AI model powering the uxo platform. Access advanced web intelligence, content generation, research tools, and more through our comprehensive API.

Start building in seconds

Simple, powerful API calls to unlock advanced AI capabilities

import requests

client = requests.Session()
client.headers.update({
    "X-API-Key": "your_api_key_here",
    "Content-Type": "application/json"
})

response = client.post(
    "https://api.chatuxo.com/brain",
    json={
        "message": "Analyze the latest AI trends",
        "context": "Focus on generative AI"
    }
)

print(response.json())
const response = await fetch("https://api.chatuxo.com/brain", {
  method: "POST",
  headers: {
    "X-API-Key": "your_api_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    message: "Analyze the latest AI trends",
    context: "Focus on generative AI"
  })
});

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

import (
    "bytes"
    "encoding/json"
    "net/http"
)

func main() {
    payload := map[string]string{
        "message": "Analyze the latest AI trends",
        "context": "Focus on generative AI",
    }
    
    body, _ := json.Marshal(payload)
    
    req, _ := http.NewRequest("POST", 
        "https://api.chatuxo.com/brain", 
        bytes.NewBuffer(body))
    
    req.Header.Set("X-API-Key", "your_api_key_here")
    req.Header.Set("Content-Type", "application/json")
    
    client := &http.Client{}
    resp, _ := client.Do(req)
}
curl -X POST https://api.chatuxo.com/brain \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Analyze the latest AI trends",
    "context": "Focus on generative AI"
  }'
# Install the uxo CLI
npm install -g @uxo/cli

# Configure your API key
uxo config set api-key your_api_key_here

# Make a request
uxo brain "Analyze the latest AI trends" \
  --context "Focus on generative AI"

Everything you need to build intelligent applications

Cortex-1 provides a comprehensive suite of AI-powered tools through a simple, unified API.

Conversational AI

Advanced chat and brain endpoints with multi-provider fallback for reliability. Natural language understanding with context-aware responses.

Web Intelligence

Multi-source search integration including Brave, Bing, Tavily, and more. Website audits, prospect research, and competitive analysis.

Content Generation

Generate complete websites, multipage applications, emails, and social content. Built-in design blueprints for professional results.

Business Tools

Business intelligence, SEO tools, brand analysis, and development utilities. Everything you need for modern web operations.

Analytics & Insights

Lead scoring, prospect research, and comprehensive analytics. Real-time data processing with intelligent insights.

High Performance

Built on Cloudflare Workers for global edge deployment. Circuit breakers, rate limiting, and automatic failover.

Ready to scale?

Get in touch with our sales team to discuss enterprise plans, custom integrations, and dedicated support for your organization.

sales@chatuxo.com

API Reference

The Cortex-1 API provides programmatic access to advanced AI capabilities, web intelligence, and content generation tools. All endpoints are RESTful and return JSON responses.

Overview

The Cortex-1 API is built on Cloudflare Workers, providing global edge deployment with low latency and high availability. The API uses a fallback chain across multiple AI providers (Groq, Gemini, Mistral, Cerebras, Cloudflare AI) to ensure reliability.

Base URL
All API requests should be made to: https://api.chatuxo.com/

Key Features

  • Multi-provider AI fallback for 99.9% uptime
  • Global edge deployment via Cloudflare Workers
  • Circuit breaker pattern for fault tolerance
  • Rate limiting and request throttling
  • CORS support for browser applications
  • Comprehensive error handling and logging

Authentication

The API uses API keys for authentication. Include your API key in the request headers using either X-API-Key or X-Cortex-Key.

curl https://api.chatuxo.com/brain \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello, Cortex!"}'
Security
Never expose your API keys in client-side code. Always make API calls from your backend to protect your credentials.

Getting an API Key

To obtain an API key, contact our sales team at sales@chatuxo.com or use the /api/keys/apply endpoint to submit an application.

Rate Limits

Rate limits are enforced per IP address and API key to ensure fair usage and system stability.

Search Limits (Daily)

brave: 64 requests
bing: 33 requests
tavily: 33 requests
exa: 33 requests
yandex: 33 requests
serper: 3 requests
duckduckgo, jina, wikipedia: Unlimited

If you exceed the rate limit, you'll receive a 429 Too Many Requests response. Contact sales for increased limits.

Brain & Chat

The brain and chat endpoints provide conversational AI capabilities with context awareness and multi-turn conversations.

POST /api/brain

Primary conversational AI endpoint with advanced reasoning and web search capabilities.

Request Parameters
message (required)
The user's message or query to the AI
context (optional)
Additional context or conversation history
POST /api/chat

Lightweight chat endpoint for simple conversational interactions without advanced features.

Content Generation

Generate complete websites, applications, emails, and social content with built-in design systems.

POST /api/generate/website

Generate complete single-page websites with professional design and responsive layouts.

Request Parameters
prompt (required)
Description of the website to generate
blueprint (optional)
Design blueprint: agency, saas, dark_premium, or startup
POST /api/generate/multipage

Generate multi-page websites with navigation and consistent design system.

POST /api/generate/content

Generate various types of content including articles, copy, and documentation.

POST /api/generate/email

Generate professional email templates with HTML formatting.

POST /api/generate/social

Generate social media content optimized for different platforms.

Business Tools

Specialized tools for business intelligence, SEO, branding, and development workflows.

POST /api/tools/business

Business intelligence tools for market research and competitive analysis.

POST /api/tools/seo

SEO analysis, keyword research, and optimization recommendations.

POST /api/tools/brand

Brand analysis, positioning, and identity tools.

POST /api/tools/dev

Development utilities including code analysis and optimization.

Utilities

Additional utility endpoints for common tasks and data processing.

GET /api/time

Get current time and timezone information.

POST /api/weather

Weather information and forecasts for any location.

POST /api/currency

Currency conversion and exchange rates.

POST /api/define

Dictionary and word definitions.

POST /api/translate

Text translation between languages.

POST /api/image/analyse

Image analysis and description using computer vision.

Need more information?

Our sales team can provide detailed technical documentation, custom integration support, and enterprise solutions tailored to your needs.

sales@chatuxo.com

Quickstart Guide

Get started with the Cortex-1 API in minutes. This guide will walk you through authentication, making your first request, and building your first application.

1. Get Your API Key

To use the Cortex-1 API, you'll need an API key. Contact our sales team to get started:

Request Access
Email sales@chatuxo.com with your use case and we'll provision an API key for you within 24 hours.

2. Make Your First Request

Once you have your API key, you can start making requests. Here's a simple example using cURL:

curl -X POST https://api.chatuxo.com/brain \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "message": "What is the capital of France?"
  }'

Response:

{
  "response": "The capital of France is Paris.",
  "model": "groq",
  "timestamp": "2024-01-15T10:30:00Z"
}

3. Try Different Endpoints

Explore the various capabilities of the API:

Web Search

curl -X POST https://api.chatuxo.com/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "query": "latest AI developments",
    "sources": ["brave", "bing"]
  }'

Generate Website

curl -X POST https://api.chatuxo.com/generate/website \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "prompt": "Create a landing page for a SaaS product",
    "blueprint": "saas"
  }'

Business Tools

curl -X POST https://api.chatuxo.com/tools/seo \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "url": "https://example.com",
    "action": "audit"
  }'

4. Error Handling

The API uses standard HTTP status codes. Here are the most common responses:

  • 200 OK - Request successful
  • 400 Bad Request - Invalid request parameters
  • 401 Unauthorized - Invalid or missing API key
  • 429 Too Many Requests - Rate limit exceeded
  • 500 Internal Server Error - Server error

Next Steps

Now that you've made your first requests, explore the full API documentation to discover all available endpoints and capabilities.

Guides & Tutorials

Learn how to build powerful applications with Cortex-1 through detailed guides and examples.

Building a Conversational Chatbot

Create an intelligent chatbot with context awareness, conversation memory, and multi-turn interactions.

Prerequisites

  • uxo API key
  • Basic knowledge of JavaScript or Python
  • Node.js or Python 3.7+ installed

Step 1: Basic Chat Implementation

Start with a simple chat function that sends messages to the brain endpoint:

// JavaScript Example
async function chat(message, conversationHistory = []) {
  const response = await fetch('https://api.chatuxo.com/brain', {
    method: 'POST',
    headers: {
      'X-API-Key': 'your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      message: message,
      context: conversationHistory.join('\n')
    })
  });
  
  const data = await response.json();
  return data.response;
}

Step 2: Maintain Conversation Context

Store conversation history to maintain context across multiple turns:

class Chatbot {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.history = [];
  }
  
  async send(userMessage) {
    // Add user message to history
    this.history.push(`User: ${userMessage}`);
    
    // Send to API with context
    const response = await fetch('https://api.chatuxo.com/brain', {
      method: 'POST',
      headers: {
        'X-API-Key': this.apiKey,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        message: userMessage,
        context: this.history.slice(-10).join('\n') // Last 10 messages
      })
    });
    
    const data = await response.json();
    
    // Add bot response to history
    this.history.push(`Assistant: ${data.response}`);
    
    return data.response;
  }
  
  clearHistory() {
    this.history = [];
  }
}

Step 3: Add Web Interface

Create a simple HTML interface for your chatbot:

<div class="chat-container">
  <div id="messages"></div>
  <input id="user-input" placeholder="Type a message...">
  <button onclick="sendMessage()">Send</button>
</div>

<script>
const bot = new Chatbot('your_api_key_here');

async function sendMessage() {
  const input = document.getElementById('user-input');
  const message = input.value;
  
  // Display user message
  addMessage('user', message);
  
  // Get bot response
  const response = await bot.send(message);
  
  // Display bot response
  addMessage('bot', response);
  
  input.value = '';
}

function addMessage(sender, text) {
  const messagesDiv = document.getElementById('messages');
  const messageEl = document.createElement('div');
  messageEl.className = `message ${sender}`;
  messageEl.textContent = text;
  messagesDiv.appendChild(messageEl);
}
</script>

Best Practices

  • Limit context to last 10-15 messages to avoid token limits
  • Implement typing indicators for better UX
  • Add error handling for API failures
  • Store conversation history in localStorage for persistence
  • Implement rate limiting on the client side

Web Research Automation

Automate comprehensive web research using multiple search sources and AI-powered analysis.

Step 1: Multi-Source Search

Query multiple search engines simultaneously for comprehensive results:

async function researchTopic(topic) {
  const response = await fetch('https://api.chatuxo.com/search', {
    method: 'POST',
    headers: {
      'X-API-Key': 'your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      query: topic,
      sources: ['brave', 'bing', 'tavily', 'duckduckgo']
    })
  });
  
  const results = await response.json();
  return results;
}

Step 2: Competitor Analysis

Use the audit endpoint to analyze competitor websites:

async function analyzeCompetitor(url) {
  const response = await fetch('https://api.chatuxo.com/audit', {
    method: 'POST',
    headers: {
      'X-API-Key': 'your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      url: url,
      checks: ['seo', 'performance', 'accessibility', 'content']
    })
  });
  
  return await response.json();
}

// Analyze multiple competitors
const competitors = [
  'https://competitor1.com',
  'https://competitor2.com',
  'https://competitor3.com'
];

const analyses = await Promise.all(
  competitors.map(url => analyzeCompetitor(url))
);

console.log('Competitor Analysis:', analyses);

Step 3: Prospect Research

Deep dive into prospect companies using the prospect endpoint:

async function researchProspect(companyName) {
  const response = await fetch('https://api.chatuxo.com/prospect', {
    method: 'POST',
    headers: {
      'X-API-Key': 'your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      company: companyName,
      depth: 'comprehensive'
    })
  });
  
  const data = await response.json();
  
  return {
    company: data.company_info,
    financials: data.financial_data,
    news: data.recent_news,
    employees: data.key_employees,
    technologies: data.tech_stack
  };
}

Step 4: Generate Research Report

Combine all research into a comprehensive report:

async function generateResearchReport(topic) {
  // 1. Search for information
  const searchResults = await researchTopic(topic);
  
  // 2. Analyze key websites
  const topUrls = searchResults.results.slice(0, 3).map(r => r.url);
  const audits = await Promise.all(topUrls.map(analyzeCompetitor));
  
  // 3. Generate summary with brain
  const response = await fetch('https://api.chatuxo.com/brain', {
    method: 'POST',
    headers: {
      'X-API-Key': 'your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      message: `Create a comprehensive research report on: ${topic}`,
      context: JSON.stringify({
        search_results: searchResults,
        website_audits: audits
      })
    })
  });
  
  return await response.json();
}

Automated Content Creation

Build content pipelines that generate websites, emails, and social media posts at scale.

Step 1: Generate Landing Pages

Create professional landing pages programmatically:

async function createLandingPage(productName, description) {
  const response = await fetch('https://api.chatuxo.com/generate/website', {
    method: 'POST',
    headers: {
      'X-API-Key': 'your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      prompt: `Create a SaaS landing page for ${productName}: ${description}`,
      blueprint: 'saas',
      sections: ['hero', 'features', 'pricing', 'testimonials', 'cta']
    })
  });
  
  const data = await response.json();
  
  // Save to file
  const fs = require('fs');
  fs.writeFileSync(`${productName}-landing.html`, data.html);
  
  return data;
}

Step 2: Email Campaign Generator

Generate personalized email campaigns:

async function generateEmailCampaign(campaign) {
  const emails = [];
  
  for (const recipient of campaign.recipients) {
    const response = await fetch('https://api.chatuxo.com/generate/email', {
      method: 'POST',
      headers: {
        'X-API-Key': 'your_api_key_here',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        type: campaign.type, // 'promotional', 'newsletter', 'follow-up'
        recipient_name: recipient.name,
        recipient_company: recipient.company,
        personalization: recipient.metadata,
        tone: 'professional',
        include_html: true
      })
    });
    
    const email = await response.json();
    emails.push({
      to: recipient.email,
      subject: email.subject,
      html: email.html_body,
      text: email.text_body
    });
  }
  
  return emails;
}

Step 3: Social Media Content Pipeline

Create a multi-platform social media content generator:

async function createSocialContent(topic, platforms) {
  const content = {};
  
  for (const platform of platforms) {
    const response = await fetch('https://api.chatuxo.com/generate/social', {
      method: 'POST',
      headers: {
        'X-API-Key': 'your_api_key_here',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        platform: platform, // 'twitter', 'linkedin', 'instagram'
        topic: topic,
        tone: platform === 'linkedin' ? 'professional' : 'casual',
        include_hashtags: true,
        include_image_suggestions: true
      })
    });
    
    content[platform] = await response.json();
  }
  
  return content;
}

// Example usage
const socialPosts = await createSocialContent(
  'Launch of our new AI feature',
  ['twitter', 'linkedin', 'instagram']
);

console.log('Twitter:', socialPosts.twitter.post);
console.log('LinkedIn:', socialPosts.linkedin.post);
console.log('Instagram:', socialPosts.instagram.caption);

Step 4: Content Calendar Automation

Build a complete content calendar generator:

async function generateContentCalendar(month, topics) {
  const calendar = [];
  const daysInMonth = 30;
  
  for (let day = 1; day <= daysInMonth; day++) {
    const topic = topics[day % topics.length];
    
    // Generate content for each platform
    const content = await createSocialContent(topic, [
      'twitter', 'linkedin', 'instagram'
    ]);
    
    calendar.push({
      date: `2024-${month}-${day.toString().padStart(2, '0')}`,
      topic: topic,
      content: content
    });
    
    // Rate limiting
    await new Promise(resolve => setTimeout(resolve, 1000));
  }
  
  return calendar;
}

Lead Generation & Scoring System

Build an automated system to find, qualify, and score potential leads.

Step 1: Lead Discovery

Find potential leads using search and prospect research:

async function findLeads(criteria) {
  // Search for companies matching criteria
  const searchQuery = `${criteria.industry} companies in ${criteria.location}`;
  
  const response = await fetch('https://api.chatuxo.com/search', {
    method: 'POST',
    headers: {
      'X-API-Key': 'your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      query: searchQuery,
      sources: ['brave', 'bing']
    })
  });
  
  const results = await response.json();
  
  // Extract company websites
  const companies = results.results
    .filter(r => r.url && !r.url.includes('linkedin'))
    .slice(0, 20);
  
  return companies;
}

Step 2: Lead Enrichment

Enrich leads with detailed company information:

async function enrichLead(companyUrl) {
  const prospectData = await fetch('https://api.chatuxo.com/prospect', {
    method: 'POST',
    headers: {
      'X-API-Key': 'your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      url: companyUrl,
      depth: 'comprehensive'
    })
  });
  
  const data = await prospectData.json();
  
  return {
    company_name: data.company_name,
    industry: data.industry,
    employee_count: data.employee_count,
    revenue_estimate: data.revenue,
    technologies: data.tech_stack,
    decision_makers: data.key_employees,
    recent_activity: data.recent_news,
    contact_info: data.contact_information
  };
}

Step 3: Lead Scoring

Score leads based on multiple criteria:

async function scoreLead(lead) {
  const response = await fetch('https://api.chatuxo.com/score', {
    method: 'POST',
    headers: {
      'X-API-Key': 'your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      lead_data: lead,
      criteria: {
        industry_match: 0.3,
        company_size: 0.2,
        technology_fit: 0.25,
        budget_signals: 0.15,
        engagement: 0.1
      }
    })
  });
  
  const score = await response.json();
  
  return {
    total_score: score.total,
    grade: score.grade, // A, B, C, D
    breakdown: score.breakdown,
    recommendation: score.action_recommendation
  };
}

Step 4: Complete Lead Pipeline

Put it all together into an automated pipeline:

async function runLeadPipeline(criteria) {
  console.log('Finding leads...');
  const rawLeads = await findLeads(criteria);
  
  console.log('Enriching leads...');
  const enrichedLeads = [];
  for (const lead of rawLeads) {
    try {
      const enriched = await enrichLead(lead.url);
      enrichedLeads.push(enriched);
      
      // Rate limiting
      await new Promise(r => setTimeout(r, 2000));
    } catch (error) {
      console.error(`Failed to enrich ${lead.url}:`, error);
    }
  }
  
  console.log('Scoring leads...');
  const scoredLeads = [];
  for (const lead of enrichedLeads) {
    const score = await scoreLead(lead);
    scoredLeads.push({
      ...lead,
      score: score
    });
  }
  
  // Sort by score
  scoredLeads.sort((a, b) => b.score.total - a.score.total);
  
  // Filter high-quality leads (A and B grade)
  const qualifiedLeads = scoredLeads.filter(
    lead => ['A', 'B'].includes(lead.score.grade)
  );
  
  console.log(`Found ${qualifiedLeads.length} qualified leads`);
  return qualifiedLeads;
}

// Run the pipeline
const leads = await runLeadPipeline({
  industry: 'SaaS',
  location: 'United States',
  size: 'mid-market'
});

// Export to CSV
exportToCSV(leads, 'qualified-leads.csv');

SEO Automation & Optimization

Automate SEO audits, keyword research, and content optimization.

Step 1: Website SEO Audit

Run comprehensive SEO audits on any website:

async function seoAudit(url) {
  const response = await fetch('https://api.chatuxo.com/tools/seo', {
    method: 'POST',
    headers: {
      'X-API-Key': 'your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      url: url,
      action: 'audit',
      checks: [
        'meta_tags',
        'headings',
        'content_quality',
        'internal_links',
        'mobile_friendly',
        'page_speed',
        'structured_data'
      ]
    })
  });
  
  const audit = await response.json();
  
  return {
    score: audit.overall_score,
    issues: audit.issues,
    recommendations: audit.recommendations,
    opportunities: audit.opportunities
  };
}

Step 2: Keyword Research

Discover high-value keywords for your content:

async function keywordResearch(topic) {
  const response = await fetch('https://api.chatuxo.com/tools/seo', {
    method: 'POST',
    headers: {
      'X-API-Key': 'your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      action: 'keyword_research',
      topic: topic,
      intent: 'commercial' // or 'informational', 'transactional'
    })
  });
  
  const keywords = await response.json();
  
  return keywords.map(kw => ({
    keyword: kw.term,
    search_volume: kw.volume,
    difficulty: kw.difficulty,
    cpc: kw.cpc,
    related_terms: kw.related
  }));
}

Step 3: Content Optimization

Optimize existing content for target keywords:

async function optimizeContent(content, targetKeyword) {
  const response = await fetch('https://api.chatuxo.com/brain', {
    method: 'POST',
    headers: {
      'X-API-Key': 'your_api_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      message: `Optimize this content for SEO targeting "${targetKeyword}"`,
      context: content
    })
  });
  
  const optimized = await response.json();
  
  return {
    optimized_content: optimized.response,
    keyword_density: calculateKeywordDensity(optimized.response, targetKeyword),
    meta_title: generateMetaTitle(targetKeyword),
    meta_description: generateMetaDescription(optimized.response)
  };
}

function calculateKeywordDensity(content, keyword) {
  const words = content.toLowerCase().split(/\s+/);
  const keywordCount = words.filter(w => w.includes(keyword.toLowerCase())).length;
  return ((keywordCount / words.length) * 100).toFixed(2);
}

Best Practices

  • Run audits weekly to track improvement
  • Focus on low-competition, high-value keywords
  • Optimize for user intent, not just keyword density
  • Monitor competitors' SEO strategies
  • Keep content fresh with regular updates

Need custom guidance?

Our team can help you build custom integrations and workflows tailored to your specific use case.

sales@chatuxo.com