Build with xuss.ai

Seamlessly integrate the world's most advanced Large Language Models directly into your applications. Our API is designed to be incredibly simple to implement while offering unmatched power and speed.

You can obtain and buy API tokens from telegram bot t.me/ZTHSBot

Available Models

xuss-pro Pro

The flagship model designed for complex reasoning tasks. Optimized for safety and high accuracy.

CTX: 256k

Safety: Standard

xuss-unc Uncensored

An unrestricted, raw model specifically designed for security research and creative writing.

CTX: 256k

Safety: None

Get Models List

GET /v1/models

<?php
$url = "https://api.xuss.us/v1/models";
$apiKey = "GET_FROM_@ZTHSBOT";
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer $apiKey"]
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

import requests
url = "https://api.xuss.us/v1/models"
headers = {"Authorization": "Bearer GET_FROM_@ZTHSBOT"}
response = requests.get(url, headers=headers)
print(response.json())

const apiKey = "GET_FROM_@ZTHSBOT";
fetch("https://api.xuss.us/v1/models", {
    method: "GET",
    headers: { "Authorization": `Bearer ${apiKey}` }
})
.then(response => response.json())
.then(data => console.log(data));

curl https://api.xuss.us/v1/models \
  -H "Authorization: Bearer GET_FROM_@ZTHSBOT"

Chat Completion

POST /v1/chat/completions

<?php
$url = "https://api.xuss.us/v1/chat/completions";
$apiKey = "GET_FROM_@ZTHSBOT";
$data = [
    "model" => "xuss-pro",
    "messages" => [
        ["role" => "system", "content" => "You are a helpful assistant."],
        ["role" => "user", "content" => "Explain how a buffer overflow works."]
    ],
    "temperature" => 0.7
];
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Content-Type: application/json", "Authorization: Bearer $apiKey"],
    CURLOPT_POSTFIELDS => json_encode($data)
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

import requests
url = "https://api.xuss.us/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer GET_FROM_@ZTHSBOT"
}
data = {
    "model": "xuss-unc",
    "messages": [
        {"role": "system", "content": "You are a cybersecurity expert."},
        {"role": "user", "content": "Generate a penetration test report template."}
    ],
    "temperature": 0.7
}
response = requests.post(url, headers=headers, json=data)
print(response.json())

const url = "https://api.xuss.us/v1/chat/completions";
const apiKey = "GET_FROM_@ZTHSBOT";
const data = {
    model: "xuss-pro",
    messages: [
        { role: "system", content: "You are a helpful assistant." },
        { role: "user", content: "Explain how a buffer overflow works." }
    ],
    temperature: 0.7
};
fetch(url, {
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        "Authorization": `Bearer ${apiKey}`
    },
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));

curl -X POST https://api.xuss.us/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer GET_FROM_@ZTHSBOT" \
  -d '{
    "model": "xuss-pro",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Write a poem about code."}
    ]
  }'

Streaming

stream: true

<?php
$url = "https://api.xuss.us/v1/chat/completions";
$apiKey = "GET_FROM_@ZTHSBOT";
$data = [
    "model" => "xuss-pro",
    "messages" => [["role" => "user", "content" => "Count to 10."]],
    "stream" => true
];
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ["Content-Type: application/json", "Authorization: Bearer $apiKey"],
    CURLOPT_POSTFIELDS => json_encode($data),
    CURLOPT_WRITEFUNCTION => function($ch, $chunk) {
        echo $chunk; // Output immediately
        flush();
        return strlen($chunk);
    }
]);
curl_exec($ch);
curl_close($ch);
?>

import requests
import json
url = "https://api.xuss.us/v1/chat/completions"
headers = {"Authorization": "Bearer GET_FROM_@ZTHSBOT"}
data = {
    "model": "xuss-pro",
    "messages": [{"role": "user", "content": "Count to 10."}],
    "stream": True
}
with requests.post(url, headers=headers, json=data, stream=True) as r:
    for line in r.iter_lines():
        if line:
            print(line.decode('utf-8'))

const https = require('https');
const data = JSON.stringify({
    model: "xuss-pro",
    messages: [{ role: "user", content: "Count to 10." }],
    stream: true
});
const options = {
    hostname: 'api.xuss.us',
    path: '/v1/chat/completions',
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': 'Bearer GET_FROM_@ZTHSBOT'
    }
};
const req = https.request(options, (res) => {
    res.on('data', (chunk) => {
        process.stdout.write(chunk); // Stream output
    });
});
req.write(data);
req.end();

curl -N -X POST https://api.xuss.us/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer GET_FROM_@ZTHSBOT" \
  -d '{
    "model": "xuss-pro",
    "messages": [{"role": "user", "content": "Count to 10."}],
    "stream": true
  }'

JSON Mode

<?php
$url = "https://api.xuss.us/v1/chat/completions";
$apiKey = "GET_FROM_@ZTHSBOT";
$data = [
    "model" => "xuss-pro",
    "messages" => [
        [
            "role" => "user",
            "content" => "What is the best cheese? Return product and location in JSON format."
        ]
    ],
    // Enforce JSON object response
    "response_format" => ["type" => "json_object"]
];
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Content-Type: application/json", "Authorization: Bearer $apiKey"],
    CURLOPT_POSTFIELDS => json_encode($data)
]);
echo curl_exec($ch);
curl_close($ch);
?>

import requests
url = "https://api.xuss.us/v1/chat/completions"
headers = {"Authorization": "Bearer GET_FROM_@ZTHSBOT"}
data = {
    "model": "xuss-pro",
    "messages": [
        {
            "role": "user",
            "content": "What is the best cheese? Return product and location in JSON format."
        }
    ],
    "response_format": {"type": "json_object"}
}
response = requests.post(url, headers=headers, json=data)
print(response.json())

const url = "https://api.xuss.us/v1/chat/completions";
const apiKey = "GET_FROM_@ZTHSBOT";
const data = {
    model: "xuss-pro",
    messages: [{
        role: "user",
        content: "What is the best cheese? Return product and location in JSON format."
    }],
    response_format: { type: "json_object" }
};
fetch(url, {
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        "Authorization": `Bearer ${apiKey}`
    },
    body: JSON.stringify(data)
})
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));

curl --location "https://api.xuss.us/v1/chat/completions" \
     --header 'Content-Type: application/json' \
     --header 'Accept: application/json' \
     --header "Authorization: Bearer GET_FROM_@ZTHSBOT" \
     --data '{
    "model": "xuss-pro",
    "messages": [
     {
        "role": "user",
        "content": "What is the best cheese? Return product and location in JSON format."
      }
    ],
    "response_format": {"type": "json_object"}
  }'

Vision (Multimodal)

<?php
// 1. Prepare Image
$imgData = base64_encode(file_get_contents('image.jpg'));
$base64 = "data:image/jpeg;base64," . $imgData;
// 2. Setup Request
$url = "https://api.xuss.us/v1/chat/completions";
$apiKey = "GET_FROM_@ZTHSBOT";
$data = [
    "model" => "xuss-pro",
    "messages" => [[
        "role" => "user",
        "content" => [
            ["type" => "text", "text" => "What's in this image?"],
            ["type" => "image_url", "image_url" => ["url" => $base64]]
        ]
    ]]
];
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Content-Type: application/json", "Authorization: Bearer $apiKey"],
    CURLOPT_POSTFIELDS => json_encode($data)
]);
echo curl_exec($ch);
curl_close($ch);
?>

<?php
$url = "https://api.xuss.us/v1/chat/completions";
$apiKey = "GET_FROM_@ZTHSBOT";
$imageUrl = "https://upload.wikimedia.org/wikipedia/commons/5/54/Wiki%2C_wiki%2C_wiki%2C_wiki_logo.jpg";
$data = [
    "model" => "xuss-pro",
    "messages" => [[
        "role" => "user",
        "content" => [
            ["type" => "text", "text" => "What's in this image?"],
            ["type" => "image_url", "image_url" => ["url" => $imageUrl]]
        ]
    ]]
];
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Content-Type: application/json", "Authorization: Bearer $apiKey"],
    CURLOPT_POSTFIELDS => json_encode($data)
]);
echo curl_exec($ch);
curl_close($ch);
?>

import base64
import requests
# 1. Prepare Image
with open("image.jpg", "rb") as f:
    b64 = base64.b64encode(f.read()).decode('utf-8')
url = "https://api.xuss.us/v1/chat/completions"
headers = {
    "Authorization": "Bearer GET_FROM_@ZTHSBOT",
    "Content-Type": "application/json"
}
data = {
    "model": "xuss-pro",
    "messages": [{
        "role": "user",
        "content": [
            {"type": "text", "text": "What's in this image?"},
            {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{b64}"}}
        ]
    }]
}
response = requests.post(url, headers=headers, json=data)
print(response.json())

import requests
url = "https://api.xuss.us/v1/chat/completions"
headers = {
    "Authorization": "Bearer GET_FROM_@ZTHSBOT",
    "Content-Type": "application/json"
}
image_url = "https://upload.wikimedia.org/wikipedia/commons/5/54/Wiki%2C_wiki%2C_wiki%2C_wiki_logo.jpg"
data = {
    "model": "xuss-pro",
    "messages": [{
        "role": "user",
        "content": [
            {"type": "text", "text": "Describe this picture."},
            {"type": "image_url", "image_url": {"url": image_url}}
        ]
    }]
}
response = requests.post(url, headers=headers, json=data)
print(response.json())

const url = "https://api.xuss.us/v1/chat/completions";
const apiKey = "GET_FROM_@ZTHSBOT";
const img = "https://upload.wikimedia.org/wikipedia/commons/5/54/Wiki%2C_wiki%2C_wiki%2C_wiki_logo.jpg";
const data = {
    model: "xuss-pro",
    messages: [{
        role: "user",
        content: [
            { type: "text", text: "Describe this picture." },
            { type: "image_url", image_url: { url: img } }
        ]
    }]
};
fetch(url, {
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        "Authorization": `Bearer ${apiKey}`
    },
    body: JSON.stringify(data)
})
.then(res => res.json())
.then(data => console.log(data));

# 1. Encode image to variable (Linux/Mac)
IMAGE_DATA=$(base64 -i image.jpg)
# 2. Send Request
curl -X POST https://api.xuss.us/v1/chat/completions \
  -H "Authorization: Bearer GET_FROM_@ZTHSBOT" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"xuss-pro\",
    \"messages\": [
      {
        \"role\": \"user\",
        \"content\": [
          {\"type\": \"text\", \"text\": \"What is this?\"},
          {\"type\": \"image_url\", \"image_url\": {\"url\": \"data:image/jpeg;base64,${IMAGE_DATA}\"}}
        ]
      }
    ]
  }"

curl -X POST https://api.xuss.us/v1/chat/completions \
  -H "Authorization: Bearer GET_FROM_@ZTHSBOT" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "xuss-pro",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "Describe this."},
          {"type": "image_url", "image_url": {"url": "https://upload.wikimedia.org/wikipedia/commons/5/54/Wiki%2C_wiki%2C_wiki%2C_wiki_logo.jpg"}}
        ]
      }
    ]
  }'

Function Calling

<?php
// CONFIGURATION
$url = "https://api.xuss.us/v1/chat/completions";
$apiKey = "GET_FROM_@ZTHSBOT";
// 1. DEFINE TOOLS AND MESSAGES
$tools = [
    [
        "type" => "function",
        "function" => [
            "name" => "get_stock_price",
            "description" => "Get current stock price",
            "parameters" => [
                "type" => "object",
                "properties" => ["ticker" => ["type" => "string"]],
                "required" => ["ticker"]
            ]
        ]
    ]
];
$messages = [
    ["role" => "user", "content" => "What is the price of Apple stock?"]
];
// 2. SEND FIRST REQUEST (Ask AI what it needs)
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Content-Type: application/json", "Authorization: Bearer $apiKey"],
    CURLOPT_POSTFIELDS => json_encode([
        "model" => "xuss-pro",
        "messages" => $messages,
        "tools" => $tools
    ])
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
$aiMessage = $response['choices'][0]['message'];
// 3. CHECK IF AI WANTS TO USE A TOOL
if (isset($aiMessage['tool_calls'])) {
    // Add AI's request to our history
    $messages[] = $aiMessage;
    // Loop through the tools the AI wants to call
    foreach ($aiMessage['tool_calls'] as $toolCall) {
        $functionName = $toolCall['function']['name'];
        $arguments = json_decode($toolCall['function']['arguments'], true);
        // --- EXECUTE YOUR LOGIC HERE ---
        // (In a real app, you would query a database or API here)
        $price = "150.00";
        // --------------------------------
        // Add the RESULT to history
        $messages[] = [
            "role" => "tool",
            "tool_call_id" => $toolCall['id'],
            "name" => $functionName,
            "content" => $price
        ];
    }
    // 4. SEND FINAL REQUEST (With the tool results)
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => ["Content-Type: application/json", "Authorization: Bearer $apiKey"],
        CURLOPT_POSTFIELDS => json_encode([
            "model" => "xuss-pro",
            "messages" => $messages,
            "tools" => $tools
        ])
    ]);
    $finalResponse = json_decode(curl_exec($ch), true);
    curl_close($ch);
    // OUTPUT: "The current price of Apple is $150.00."
    echo $finalResponse['choices'][0]['message']['content'];
}
?>

import requests
import json
URL = "https://api.xuss.us/v1/chat/completions"
HEADERS = {
    "Authorization": "Bearer GET_FROM_@ZTHSBOT",
    "Content-Type": "application/json"
}
# 1. SETUP TOOLS & MESSAGES
tools = [{
    "type": "function",
    "function": {
        "name": "get_stock_price",
        "description": "Get current stock price",
        "parameters": {
            "type": "object",
            "properties": {"ticker": {"type": "string"}},
            "required": ["ticker"]
        }
    }
}]
messages = [{"role": "user", "content": "How much is Apple stock?"}]
# 2. SEND FIRST REQUEST
data = {
    "model": "xuss-pro",
    "messages": messages,
    "tools": tools
}
response = requests.post(URL, headers=HEADERS, json=data).json()
ai_message = response['choices'][0]['message']
# 3. CHECK FOR TOOL CALLS
if ai_message.get('tool_calls'):
    # Add AI's request to history
    messages.append(ai_message)
    for tool_call in ai_message['tool_calls']:
        fn_name = tool_call['function']['name']
        args = json.loads(tool_call['function']['arguments'])
        # --- EXECUTE LOCAL LOGIC ---
        print(f"Executing {fn_name} with {args}...")
        result = "150.00"
        # ---------------------------
        # Add result to history
        messages.append({
            "role": "tool",
            "tool_call_id": tool_call['id'],
            "name": fn_name,
            "content": result
        })
    # 4. SEND FINAL REQUEST
    final_data = {
        "model": "xuss-pro",
        "messages": messages,
        "tools": tools
    }
    final_response = requests.post(URL, headers=HEADERS, json=final_data).json()
    print("AI Answer:", final_response['choices'][0]['message']['content'])

const url = "https://api.xuss.us/v1/chat/completions";
const headers = { "Content-Type": "application/json", "Authorization": "Bearer GET_FROM_@ZTHSBOT" };
const tools = [{
  type: "function",
  function: {
    name: "get_stock_price",
    description: "Get stock price",
    parameters: {
      type: "object",
      properties: { ticker: { type: "string" } },
      required: ["ticker"]
    }
  }
}];
let messages = [{ role: "user", content: "How much is Apple stock?" }];
// 1. First Call
fetch(url, {
  method: "POST", headers,
  body: JSON.stringify({ model: "xuss-pro", messages, tools })
})
.then(r => r.json())
.then(data => {
  const aiMsg = data.choices[0].message;
  if (aiMsg.tool_calls) {
    messages.push(aiMsg);
    // 2. Process Tools
    aiMsg.tool_calls.forEach(tool => {
      // Execute logic...
      const result = "150.00";
      messages.push({
        role: "tool",
        tool_call_id: tool.id,
        name: tool.function.name,
        content: result
      });
    });
    // 3. Final Call
    return fetch(url, {
      method: "POST", headers,
      body: JSON.stringify({ model: "xuss-pro", messages, tools })
    });
  }
})
.then(r => r ? r.json() : null)
.then(final => {
  if (final) console.log(final.choices[0].message.content);
});

Code	Meaning
200	OK. Request successful.
401	Unauthorized. Check your API Key.
429	Rate limit exceeded. Slow down.

AI Code Assistant