Models API {#models-api}

The models API allows you to list and retrieve information about the available models in HelpingAI. This is useful for discovering model capabilities and selecting the right model for your use case.

GET/v1/models

List all available models

List Models {#list-models}

Retrieve a list of all available models.

Examples {#examples}

Python (using requests) {#python-using-requests}

Python

import requests

url = "https://api.helpingai.co/v1/models"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

Python (using OpenAI SDK) {#python-using-openai-sdk}

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.helpingai.co/v1",
    api_key="YOUR_API_KEY"
)

models = client.models.list()
for model in models.data:
    print(f"Model: {model.id}")
    print(f"Created: {model.created}")
    print(f"Owned by: {model.owned_by}")
    print("---")

Python (using HelpingAI SDK) {#python-using-helpingai-sdk}

Python

from helpingai import HelpingAI

client = HelpingAI(api_key="YOUR_API_KEY")

models = client.models.list()
for model in models.data:
    print(f"Model: {model.id}")
    print(f"Created: {model.created}")
    print(f"Owned by: {model.owned_by}")
    print("---")

JavaScript (using axios) {#javascript-using-axios}

JavaScript

const axios = require('axios');

(async () => {
  const response = await axios.get(
    'https://api.helpingai.co/v1/models',
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    }
  );
  
  console.log(response.data);
})();

JavaScript (using OpenAI package) {#javascript-using-openai-package}

JavaScript

import OpenAI from 'openai';

const openai = new OpenAI({
  baseURL: 'https://api.helpingai.co/v1',
  apiKey: 'YOUR_API_KEY'
});

async function main() {
  const models = await openai.models.list();
  
  for (const model of models.data) {
    console.log(`Model: ${model.id}`);
    console.log(`Created: ${model.created}`);
    console.log(`Owned by: ${model.owned_by}`);
    console.log('---');
  }
}

main();

JavaScript (using HelpingAI SDK) {#javascript-using-helpingai-sdk}

JavaScript

import { HelpingAI } from 'helpingai';

const client = new HelpingAI({
  apiKey: 'YOUR_API_KEY'
});

async function main() {
  const models = await client.models.list();
  
  for (const model of models.data) {
    console.log(`Model: ${model.id}`);
    console.log(`Created: ${model.created}`);
    console.log(`Owned by: ${model.owned_by}`);
    console.log('---');
  }
}

main();

Response Format {#response-format}

JSON

{
  "object": "list",
  "data": [
    {
      "id": "Dhanishtha-2.0-preview",
      "object": "model",
      "created": 1677610602,
      "owned_by": "helpingai",
      "permission": [
        {
          "id": "modelperm-abc123",
          "object": "model_permission",
          "created": 1677610602,
          "allow_create_engine": false,
          "allow_sampling": true,
          "allow_logprobs": false,
          "allow_search_indices": false,
          "allow_view": true,
          "allow_fine_tuning": false,
          "organization": "*",
          "group": null,
          "is_blocking": false
        }
      ],
      "root": "Dhanishtha-2.0-preview",
      "parent": null
    }
  ]
}

Retrieve Model {#retrieve-model}

GET/v1/models/{model_id}

Retrieve information about a specific model

Get detailed information about a specific model.

Path Parameters {#path-parameters}

Parameter	Type	Description
model_id	string	The ID of the model to retrieve

Examples {#examples}

Python (using requests) {#python-using-requests}

Python

import requests

model_id = "Dhanishtha-2.0-preview"
url = f"https://api.helpingai.co/v1/models/{model_id}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

Python (using OpenAI SDK) {#python-using-openai-sdk}

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.helpingai.co/v1",
    api_key="YOUR_API_KEY"
)

model = client.models.retrieve("Dhanishtha-2.0-preview")
print(f"Model ID: {model.id}")
print(f"Created: {model.created}")
print(f"Owned by: {model.owned_by}")

Python (using HelpingAI SDK) {#python-using-helpingai-sdk}

Python

from helpingai import HelpingAI

client = HelpingAI(api_key="YOUR_API_KEY")

model = client.models.retrieve("Dhanishtha-2.0-preview")
print(f"Model ID: {model.id}")
print(f"Created: {model.created}")
print(f"Owned by: {model.owned_by}")

JavaScript (using axios) {#javascript-using-axios}

JavaScript

const axios = require('axios');

(async () => {
  const modelId = 'Dhanishtha-2.0-preview';
  const response = await axios.get(
    `https://api.helpingai.co/v1/models/${modelId}`,
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    }
  );
  
  console.log(response.data);
})();

JavaScript (using OpenAI package) {#javascript-using-openai-package}

JavaScript

import OpenAI from 'openai';

const openai = new OpenAI({
  baseURL: 'https://api.helpingai.co/v1',
  apiKey: 'YOUR_API_KEY'
});

async function main() {
  const model = await openai.models.retrieve('Dhanishtha-2.0-preview');
  
  console.log(`Model ID: ${model.id}`);
  console.log(`Created: ${model.created}`);
  console.log(`Owned by: ${model.owned_by}`);
}

main();

JavaScript (using HelpingAI SDK) {#javascript-using-helpingai-sdk}

JavaScript

import { HelpingAI } from 'helpingai';

const client = new HelpingAI({
  apiKey: 'YOUR_API_KEY'
});

async function main() {
  const model = await client.models.retrieve('Dhanishtha-2.0-preview');
  
  console.log(`Model ID: ${model.id}`);
  console.log(`Created: ${model.created}`);
  console.log(`Owned by: ${model.owned_by}`);
}

main();

Available Models {#available-models}

Dhanishtha-2.0-preview {#dhanishtha-20-preview}

Our flagship model with emotional intelligence and intermediate reasoning capabilities.

Key Features:

Emotional Intelligence: 98 EQ score with natural empathetic responses
Intermediate Reasoning: Thinks during response generation
Token Efficiency: 5x fewer tokens than GPT-4 for similar quality
OpenAI Compatibility: Drop-in replacement for OpenAI API
Tool Calling: Advanced function calling capabilities
Streaming: Real-time response generation

Specifications:

Context Length: 32,768 tokens
Training Data: Up to April 2024
Languages: Optimized for English, supports 50+ languages
Use Cases: General conversation, emotional support, reasoning tasks, creative writing

Pricing:

Input: $0.50 per 1M tokens
Output: $1.50 per 1M tokens

Model Comparison {#model-comparison}

Feature	Dhanishtha-2.0-preview	Traditional Models
Emotional Intelligence	✅ Built-in	❌ Limited
Intermediate Reasoning	✅ Real-time	❌ Pre-processing only
Token Efficiency	✅ 5x better	❌ Standard
Context Length	32K tokens	Varies
Streaming	✅ Yes	✅ Yes
Tool Calling	✅ Advanced	✅ Basic
hideThink Parameter	✅ Unique	❌ Not available

Choosing the Right Model {#choosing-the-right-model}

For Emotional Support Applications {#for-emotional-support-applications}

Recommended: Dhanishtha-2.0-preview
Why: Built-in emotional intelligence and empathetic responses

For Complex Reasoning Tasks {#for-complex-reasoning-tasks}

Recommended: Dhanishtha-2.0-preview with hideThink=false
Why: Intermediate reasoning engine shows thought process

For Cost-Sensitive Applications {#for-cost-sensitive-applications}

Recommended: Dhanishtha-2.0-preview
Why: 5x more token-efficient than comparable models

For Real-time Applications {#for-real-time-applications}

Recommended: Dhanishtha-2.0-preview with streaming
Why: 4x faster inference with streaming support

Next Steps {#next-steps}

Chat Completions API - Use models for conversations
Streaming Guide - Real-time responses
Tool Calling - Function calling with models
Pricing - Detailed pricing information

Docs•API Reference•Pricing

Loading

Models API {#models-api}

List Models {#list-models}

Examples {#examples}

Python (using requests) {#python-using-requests}

Python (using OpenAI SDK) {#python-using-openai-sdk}

Python (using HelpingAI SDK) {#python-using-helpingai-sdk}

JavaScript (using axios) {#javascript-using-axios}

JavaScript (using OpenAI package) {#javascript-using-openai-package}

JavaScript (using HelpingAI SDK) {#javascript-using-helpingai-sdk}

Response Format {#response-format}

Retrieve Model {#retrieve-model}

Path Parameters {#path-parameters}

Examples {#examples}

Python (using requests) {#python-using-requests}

Python (using OpenAI SDK) {#python-using-openai-sdk}

Python (using HelpingAI SDK) {#python-using-helpingai-sdk}

JavaScript (using axios) {#javascript-using-axios}

JavaScript (using OpenAI package) {#javascript-using-openai-package}

JavaScript (using HelpingAI SDK) {#javascript-using-helpingai-sdk}

Available Models {#available-models}

Dhanishtha-2.0-preview {#dhanishtha-20-preview}

Model Comparison {#model-comparison}

Choosing the Right Model {#choosing-the-right-model}

For Emotional Support Applications {#for-emotional-support-applications}

For Complex Reasoning Tasks {#for-complex-reasoning-tasks}

For Cost-Sensitive Applications {#for-cost-sensitive-applications}

For Real-time Applications {#for-real-time-applications}

Next Steps {#next-steps}