Noxyai API Documentation

Navigation

Introduction

Noxyai is an intelligent API platform that automatically detects your intent and responds accordingly. Whether it's web search, weather lookup, crypto prices, or general Q&A, Noxyai handles it all.

Base URL: https://dev.noxyai.com/v1/chat/completions

Single Endpoint: All requests go to the same endpoint. The AI understands your intent and responds accordingly.

Authentication

API Key Authentication

Include your API key in the Authorization header

Authorization: Bearer nox_xxxxxxxx

All requests require this header. Generate API keys from the dashboard.

Chat Completion

POST /chat/completions

Intelligent AI endpoint that auto-detects intent and performs actions

Request Parameters

Parameter	Description	Default
model	API model identifier	supernoxy.v1
messages	Array with role and content	Required

cURL

curl -X POST https://dev.noxyai.com/v1/chat/completions \
  -H "Authorization: Bearer nox_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "supernoxy.v1",
    "messages": [
      {
        "role": "user",
        "content": "What is the weather in London?"
      }
    ]
  }'

Python

import requests

response = requests.post(
  "https://dev.noxyai.com/v1/chat/completions",
  headers={
    "Authorization": "Bearer nox_YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  json={
    "model": "supernoxy.v1",
    "messages": [
      {
        "role": "user",
        "content": "What's the weather in London?"
      }
    ]
  }
)

print(response.json())

JavaScript/Node.js

const response = await fetch(
  "https://dev.noxyai.com/v1/chat/completions",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer nox_YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      model: "supernoxy.v1",
      messages: [
        { role: "user", content: "What's the weather in London?" }
      ]
    })
  }
);

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

Response

{
  "model": "supernoxy.v1",
  "id": "nox-1731398462",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "London currently has a temperature of 8°C with overcast skies..."
      },
      "finish_reason": "stop"
    }
  ],
  "sources": ["wttr.in"],
  "summary": true
}

Code Examples

Python Example

import requests

def ask_noxyai(question):
    response = requests.post(
        "https://dev.noxyai.com/v1/chat/completions",
        headers={
            "Authorization": "Bearer nox_YOUR_API_KEY",
            "Content-Type": "application/json"
        },
        json={
            "model": "supernoxy.v1",
            "messages": [
                {"role": "user", "content": question}
            ]
        }
    )
    return response.json()

# Usage
result = ask_noxyai("What's the weather in London?")
print(result['choices'][0]['message']['content'])

Next.js / JavaScript Example

// API route: pages/api/chat.js (Next.js)
export default async function handler(req, res) {
  if (req.method === 'POST') {
    try {
      const response = await fetch('https://dev.noxyai.com/v1/chat/completions', {
        method: 'POST',
        headers: {
          'Authorization': 'Bearer nox_YOUR_API_KEY',
          'Content-Type': 'application/json',
        },
        body: JSON.stringify({
          model: 'supernoxy.v1',
          messages: [
            { role: 'user', content: req.body.message }
          ]
        })
      });
      
      const data = await response.json();
      res.status(200).json(data);
    } catch (error) {
      res.status(500).json({ error: 'Internal server error' });
    }
  }
}

// Client-side usage (React component)
async function sendMessage(message) {
  const response = await fetch('/api/chat', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ message })
  });
  
  const data = await response.json();
  return data.choices[0].message.content;
}

cURL Example

curl -X POST https://dev.noxyai.com/v1/chat/completions \
  -H "Authorization: Bearer nox_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "supernoxy.v1",
    "messages": [
      {
        "role": "user",
        "content": "What is the weather in London?"
      }
    ]
  }'

AI Capabilities

The AI automatically detects your intent and performs the appropriate action:

Web Search

"What's the latest news about AI?" - Searches and summarizes news

Weather

"Weather in Tokyo?" - Gets current weather and temperature

Cryptocurrency

"Bitcoin price" - Fetches latest crypto prices

Time & Location

"What time is it in Dubai?" - Gets current time and location info

Rate Limits & Credits

Important: Credits System

All new users receive 5 free credits for testing. Each API call consumes 0.10 credits.

Free Trial: 5 credits (approximately 50 API calls)
Pro Plan: Custom credit packages available

Note: 1 API call = 0.10 credits. Monitor your usage in the dashboard to avoid service interruption.