Ariha AI API Documentation

Overview

The Ariha AI API provides access to advanced language model capabilities through a simple REST API endpoint. The API supports multiple roles and languages, allowing for customized AI interactions.

Base URL

https://ariha-api.ariha.ai

Endpoints

POST /api

Generate AI responses based on user queries with role and language preferences.

Authentication

• Required: API key in format email:api_key
• Passed in request body as api_key parameter

Request Format

• Method: POST
• Content-Type: application/json

Request Parameters

Supported Roles

• Assistant
• Personal Coach
• Companion
• Tutor

Supported Languages

• English (default)
• Spanish
• French
• German
• Hindi
• Bengali
• Chinese

Example Request Bodies

Example 1

{
    "api_key": "email@example.com:your_api_key_here",
    "query": "Tell me about artificial intelligence",
    "role": "Tutor",
    "language": "English"
}

Example 2

{
    "api_key": "email@example.com:your_api_key_here",
    "query": "Tell me about artificial intelligence"
}

Response Formats

Success Response

{
    "status": "success",
    "message": "Response generated successfully",
    "response": "AI-generated response text here"
}

Error Response

{
    "status": "error",
    "message": "Error description here"
}

Rate Limits

• Maximum 10 requests per 30 seconds per IP
• Maximum request size: 32KB
• 5 rate limit violations result in a 30-minute ban

Code Examples

cURL

curl -X POST https://ariha-api.ariha.ai/api \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "email@example.com:your_api_key_here",
    "query": "Tell me about artificial intelligence",
    "role": "Tutor",
    "language": "English"
  }'

Python

import requests

url = "https://ariha-api.ariha.ai/api"
payload = {
    "api_key": "email@example.com:your_api_key_here",
    "query": "Tell me about artificial intelligence",
    "role": "Tutor",
    "language": "English"
}

response = requests.post(url, json=payload)
result = response.json()

if result["status"] == "success":
    print(result["response"])
else:
    print(f"Error: {result['message']}")

JavaScript (Fetch)

const url = 'https://ariha-api.ariha.ai/api';
const data = {
    api_key: 'email@example.com:your_api_key_here',
    query: 'Tell me about artificial intelligence',
    role: 'Tutor',
    language: 'English'
};

fetch(url, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
    },
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
    if (result.status === 'success') {
        console.log(result.response);
    } else {
        console.error('Error:', result.message);
    }
})
.catch(error => console.error('Error:', error));

Node.js (Axios)

const axios = require('axios');

const url = 'https://ariha-api.ariha.ai/api';
const data = {
    api_key: 'email@example.com:your_api_key_here',
    query: 'Tell me about artificial intelligence',
    role: 'Tutor',
    language: 'English'
};

axios.post(url, data)
    .then(response => {
        if (response.data.status === 'success') {
            console.log(response.data.response);
        } else {
            console.error('Error:', response.data.message);
        }
    })
    .catch(error => console.error('Error:', error));