Integration Via SDK npm install aisool-sdk|pnpm add aisool-sdk|yarn add aisool-sdk https://www.npmjs.com/package/aisool-sdk Via endpoint See on github javascript react python nodejs php flutter c++ c# Use this to show your api key in the code box example_integration // Using Fetch in React / React Native / Expo const fetchData = async () => { try { const res = await fetch('https://aisool-max-v2.hf.space/v1/chat/completions', { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_API_KEY' }, body: JSON.stringify({ model: 'sool-max', messages: [{ role: 'user', content: 'Hello AI!' }] }) }); if (!res.ok) throw new Error('API request failed'); const data = await res.json(); const message = data.choices?.[0]?.message; console.log('Role:', message?.role); console.log('Content:', message?.content); console.log('Finish Reason:', data.choices?.[0]?.finish_reason); console.log('Usage:', data.usage); return data; } catch (err) { console.error(err); } }; Test your api here OUTPUT Enter your API Token and your message below. API TOKEN Paste your token here... MESSAGE Ask Sool something... Send API Documentation Chat Bot Assistant The Chat endpoint is your main interface for AI conversations. How to Use: 1. Send a POST request to 'https://api.openai.com/v1/chat/completions' 2. Include your API key in the 'Authorization' header as: Bearer YOUR_API_KEY (keep this secret!) 3. Send your message in the request body as JSON: { "model": "sool-max", "messages": [ { "role": "user", "content": "Your question here" } ] } 4. The API responds immediately with a complete answer (unless streaming is enabled) Response Structure: - 'choices[0].message.role': Typically "assistant" - identifies the AI response - 'choices[0].message.content': The actual AI-generated text answer - 'choices[0].finish_reason': Indicates completion status (typically "stop" when successful) - 'usage': Token usage is unlimited, Requests is unlimited Important Notes: - The response is synchronous by default - you get the full answer in one go - Parse the entire JSON response to access all fields - Display 'choices[0].message.content' directly in your UI - Store responses for conversation history by saving both user messages and assistant 'content' javascript // Chat API - Complete Example (OpenAI-compatible format) const sendMessage = async (userMessage) => { try { const response = await fetch('https://aisool-max-v2.hf.space/v1/chat/completions', { method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY_HERE" }, body: JSON.stringify({ model: "sool-max", messages: [ { role: "user", content: userMessage } ] }) }); if (!response.ok) { throw new Error(`API error: ${response.status}`); } const data = await response.json(); console.log('AI Role:', data.choices[0].message.role); // "assistant" console.log('AI Answer:', data.choices[0].message.content); // The actual response text console.log('Status:', data.choices[0].finish_reason); // "stop" = completed console.log('Tokens Used:', data.usage); // { prompt_tokens, completion_tokens, total_tokens } return data.choices[0].message.content; } catch (error) { console.error('Error calling AI:', error); return null; } }; // Usage: sendMessage("What is the weather like?"); react // React Chat Component - Full Implementation (OpenAI format) import React, { useState } from 'react'; const ChatComponent = () => { const [message, setMessage] = useState(''); const [response, setResponse] = useState(null); const [loading, setLoading] = useState(false); const [error, setError] = useState(null); const sendMessage = async () => { setLoading(true); setError(null); try { const res = await fetch('https://aisool-max-v2.hf.space/v1/chat/completions', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model: "sool-max", messages: [{ role: "user", content: message }] }) }); if (!res.ok) throw new Error('API request failed'); const data = await res.json(); setResponse(data); } catch (err) { setError(err.message); } finally { setLoading(false); } }; return (

<input value={message} onChange={(e) => setMessage(e.target.value)} placeholder="Ask anything..." /> <button onClick={sendMessage} disabled={loading}> {loading ? 'Sending...' : 'Send'} </button> {error &&

Error: {error}

} {response && (

AI Response:

{response.choices?.[0]?.message?.content || 'No response'}

Status: {response.choices?.[0]?.finish_reason || 'unknown'} | Tokens: {response.usage?.total_tokens || 'N/A'}

)}

); }; python # Python Chat API - Complete Example (OpenAI format) import requests import json def send_message(user_message): """ Send a message using OpenAI-compatible format """ url = "https://aisool-max-v2.hf.space/v1/chat/completions" headers = { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" } payload = { "model": "sool-max", "messages": [{"role": "user", "content": user_message}] } try: response = requests.post(url, json=payload, headers=headers) response.raise_for_status() data = response.json() print(f"Role: {data['choices'][0]['message']['role']}") print(f"Content: {data['choices'][0]['message']['content']}") print(f"Finish Reason: {data['choices'][0]['finish_reason']}") print(f"Usage: {data.get('usage')}") return data except requests.exceptions.RequestException as e: print(f"Error: {e}") return None # Example usage if __name__ == "__main__": result = send_message("Explain quantum computing") if result: print(f"\nAI says: {result['choices'][0]['message']['content']}") dart // Flutter/Dart Chat API - OpenAI-compatible import 'dart:convert'; import 'package:http/http.dart' as http; Future<Map<String, dynamic>?> sendMessage(String userMessage) async { final url = Uri.parse('https://aisool-max-v2.hf.space/v1/chat/completions'); final headers = { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }; final body = jsonEncode({ 'model': 'sool-max', 'messages': [ {'role': 'user', 'content': userMessage} ] }); try { final response = await http.post(url, headers: headers, body: body); if (response.statusCode != 200) { print('API Error: ${response.statusCode}'); return null; } final data = jsonDecode(response.body) as Map<String, dynamic>; print('Role: ${data['choices'][0]['message']['role']}'); print('Content: ${data['choices'][0]['message']['content']}'); print('Status: ${data['choices'][0]['finish_reason']}'); print('Usage: ${data['usage']}'); return data; } catch (e) { print('Error: $e'); return null; } } // Usage example void main() async { final response = await sendMessage('What is machine learning?'); if (response != null) { print('AI Response: ${response['choices'][0]['message']['content']}'); } } c# // C# Chat API - OpenAI-compatible using System; using System.Net.Http; using System.Text; using System.Text.Json; using System.Threading.Tasks; public class ChatApiClient { private readonly HttpClient _client; private const string ApiUrl = "https://aisool-max-v2.hf.space/v1/chat/completions"; private const string ApiKey = "YOUR_API_KEY"; public ChatApiClient() { _client = new HttpClient(); _client.DefaultRequestHeaders.Add("Authorization", $"Bearer {ApiKey}"); } public async Task<ChatResponse> SendMessageAsync(string userMessage) { try { var payload = new { model = "sool-max", messages = new[] { new { role = "user", content = userMessage } } }; var jsonContent = JsonSerializer.Serialize(payload); var content = new StringContent(jsonContent, Encoding.UTF8, "application/json"); var response = await _client.PostAsync(ApiUrl, content); response.EnsureSuccessStatusCode(); var responseBody = await response.Content.ReadAsStringAsync(); var data = JsonSerializer.Deserialize<JsonElement>(responseBody); var choice = data.GetProperty("choices")[0]; var message = choice.GetProperty("message"); var chatResponse = new ChatResponse { Role = message.GetProperty("role").GetString(), Content = message.GetProperty("content").GetString(), FinishReason = choice.GetProperty("finish_reason").GetString(), Usage = data.TryGetProperty("usage", out var usage) ? usage.ToString() : null }; Console.WriteLine($"Role: {chatResponse.Role}"); Console.WriteLine($"Content: {chatResponse.Content}"); Console.WriteLine($"Status: {chatResponse.FinishReason}"); Console.WriteLine($"Usage: {chatResponse.Usage}"); return chatResponse; } catch (Exception ex) { Console.WriteLine($"Error: {ex.Message}"); return null; } } } public class ChatResponse { public string Role { get; set; } public string Content { get; set; } public string FinishReason { get; set; } public string Usage { get; set; } } // Usage class Program { static async Task Main() { var client = new ChatApiClient(); var response = await client.SendMessageAsync("Explain APIs"); if (response != null) { Console.WriteLine($"\nAI Response: {response.Content}"); } } }