UltraXas API's & Keys

Integrate Xro Core into your applications, terminals, and backends.

What Is Xro Core API?

Xro Core is the central reasoning engine powering UltraXas. It processes complex queries, maintains context across conversations, and delivers intelligent responses with nuanced understanding. The API enables developers, businesses, and terminal users to harness this reasoning capability directly.

Whether you're building a web application, backend service, or command-line tool, Xro Core provides the intelligence layer your project needs.

API Key Access

Obtaining Your Key

Users must obtain an API key from their UltraXas account dashboard. Keys are generated securely and tied to your account.

Key Format

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Security

API keys are private credentials. Never share them publicly, commit them to version control, or expose them in client-side code. If a key is leaked, rotate it immediately from your account settings.

Base URL and Endpoints

Base URL

https://server.ultraxas.com

Main Endpoint

POST /xro/chat

Model

xro-core

Request Format

All API requests require authentication via API key. Send it in the request header.

Headers Required

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

cURL Example

curl -X POST https://server.ultraxas.com/xro/chat \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "xro-core",
    "messages": [
      {
        "role": "user",
        "content": "Explain quantum computing"
      }
    ]
  }'

Python Example

import requests

url = "https://server.ultraxas.com/xro/chat"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "model": "xro-core",
    "messages": [
        {"role": "user", "content": "Explain quantum computing"}
    ]
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Node.js Example

const fetch = require('node-fetch');

const url = 'https://server.ultraxas.com/xro/chat';
const options = {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        model: 'xro-core',
        messages: [
            { role: 'user', content: 'Explain quantum computing' }
        ]
    })
};

fetch(url, options)
    .then(res => res.json())
    .then(data => console.log(data));

Response Format

The API returns responses in JSON format with status codes indicating success or error.

Successful Response (200)

{
  "id": "msg-abc123",
  "object": "message",
  "created": 1699564200,
  "model": "xro-core",
  "content": [
    {
      "type": "text",
      "text": "Quantum computing harnesses quantum mechanics principles..."
    }
  ],
  "usage": {
    "input_tokens": 15,
    "output_tokens": 127
  }
}

Rate Limits

Free Tier

100 requests per minute

Pro Tier

500 requests per minute

Enterprise Tier

Custom limits negotiated with support

Authentication

Xro Core API uses Bearer token authentication. Include your API key in the Authorization header with every request.

Header Format

Authorization: Bearer sk-xxxxxxxxxxxxxxxx

Invalid Key Behavior

Requests with invalid or missing keys receive a 401 Unauthorized response.

HTTP Status Codes

200 OK

Request processed successfully.

400 Bad Request

Invalid request syntax or missing required fields.

Error Handling

401 Unauthorized

Invalid or missing API key. Verify your key is correct and properly formatted.

429 Too Many Requests

Rate limit exceeded. Implement exponential backoff and retry logic.

500 Internal Server Error

Server encountered an unexpected error. Retry after a short delay.

Best Practices

Keep Keys Server-Side

Never expose API keys in client-side code or frontend applications.

Use Environment Variables

Store API keys in environment variables or secure vault services.

Implement Retry Logic

Use exponential backoff for network failures or rate limit responses.

Validate Responses

Always validate API responses for errors and expected fields.

Monitor Usage

Track your API calls to stay within rate limits and avoid unexpected bills.

Terminal Usage

The Xro CLI tool allows you to interact with Xro Core directly from your terminal.

$ xro "Explain neural networks"

Processing query through Xro Core...

Neural networks are computational systems inspired by biological
neural networks. They consist of interconnected nodes that learn
patterns through training. Key applications include image recognition,
natural language processing, and predictive analytics.

The learning process involves adjusting weights through backpropagation
to minimize prediction error across training data...

SDK Roadmap

Official SDKs are coming to simplify integration across popular languages and frameworks.

Python SDK

In Development

Node.js SDK

In Development

Go SDK

Planned

PHP SDK

Planned

How the API Works Internally

Input Pipeline

Your request enters the input pipeline where it is validated, authenticated, and formatted for processing.

Tokenizer Stage

Text is tokenized into semantic units and prepared for the reasoning engine.

Xro Reasoning Module

The core Xro engine applies multi-stage reasoning, context analysis, and knowledge synthesis.

Response Composition

Results are formatted, quality-checked, and returned through the output pipeline.

Get Started Today

Ready to integrate Xro Core? Obtain your API key, read the examples above, and start building. For support, contact our developer community.