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.