शुरू हो जाओ

एपीआई क्विकस्टार्ट

Ninja के API के साथ शुरुआत करें और अपने AI उत्पादों को बेजोड़ गति, स्केलेबिलिटी और विश्वसनीयता के साथ पावर दें।

और जानें

रजिस्ट्रेशन

पर साइन अप करें सुपर. माईनिंजा. एआई हमारे API का उपयोग शुरू करने के लिए।

आप मुफ्त में साइन अप कर सकते हैं या अल्ट्रा या बिज़नेस टियर की सदस्यता ले सकते हैं। अल्ट्रा और बिज़नेस आपको हमारे फ्लैगशिप, रीज़निंग और गहन शोध एलएलएम के साथ प्रयोग करने के लिए खेल के मैदान तक असीमित पहुंच प्रदान करते हैं।*

जब आप खोज से निष्पादन की ओर बढ़ने के लिए तैयार हों, तो AI उत्पादों का निर्माण शुरू करने के लिए क्रेडिट खरीदें और कोडिंग, लेखन और बहुत कुछ के लिए अनुभव करें।

* दुरुपयोग की सीमा के अधीन

क्रेडिट्स खरीदें

  • के लिए साइन अप करने के बाद सुपर. माईनिंजा. एआई, बाएं पैनल पर जाएं और क्लिक करें API आइकन

    Image of user navigating to the api management page
  • फिर यहां जाएं “सदस्यता और क्रेडिट”

    Image of user navigating to the API keys & credits page
  • के अंतर्गत “आपके क्रेडिट,” क्लिक करें “क्रेडिट्स खरीदें”

    Image of the API credits section in Ninja AI
  • में “ऑटो-पे राशि” फ़ील्ड, वह राशि दर्ज करें जिसे आप क्रेडिट के लिए खरीदना चाहते हैं (न्यूनतम $30)

    Image of a user setting their credit amount for their auto-pay agreement in Ninja AI
  • में “ऑटो-पे थ्रेसहोल्ड” फ़ील्ड, सीमा राशि निर्धारित करें कि जब आपकी शेष राशि इस राशि से कम हो जाती है तो हम इसे फिर से लोड करेंगे “ऑटो-पे राशि”। इससे पक्का होता है कि आपके पास क्रेडिट खत्म नहीं होंगे या आपकी API कुंजी काम करना बंद नहीं करेगी। (न्यूनतम $25)

    Image of a user setting their threshold amount for their auto-pay agreement in Ninja AI
  • अपनी पसंदीदा भुगतान विधि चुनें और क्लिक करें “पुष्टि करें और भुगतान करें।” फिर आपको अपना भुगतान पूरा करने के लिए स्ट्राइप बिलिंग स्क्रीन पर रीडायरेक्ट किया जाएगा।

    Image of different payment vendors provided to users when purchasing API credits

API कुंजी जेनरेट करें

  • अपने क्रेडिट खरीदने के बाद, यहां जाएं “अपनी API कुंजियों को प्रबंधित करें” पर अनुभाग API कुंजियाँ और क्रेडिट पेज

    Image of user navigating to the API keys & credits page
  • पर क्लिक करें “नई कुंजी बनाएं” बटन।

    Image of manage your API keys section in Ninja AI
  • में “नाम” फ़ील्ड, अपनी कुंजी के लिए एक नाम दर्ज करें (उदाहरण के लिए, उत्पादन कुंजी) और फिर क्लिक करें “कुंजी बनाएं”

    Image of naming process for an API key generated by Ninja AI
  • एक बार आपकी कुंजी जनरेट हो जाने के बाद, इसे कॉपी करें और इसे कहीं सुरक्षित रूप से सहेजें, क्योंकि एक्सेस वाला कोई भी व्यक्ति इसका उपयोग कर सकता है। यदि आवश्यक हो, तो आप कर सकते हैं सुधारना एक नई कुंजी।

    Image of an API key generated with Ninja AI

निंजा API का उपयोग करना

ओवर व्यू

बेस यूआरएल:
https://api.myninja.ai/v1

प्रमाणीकरण:
सभी अनुरोधों के लिए हेडर में एक API कुंजी पास करने की आवश्यकता होती है, जो इस प्रकार <token-key>है कि आपका ऑथ टोकन कहां है:
प्राधिकरण: बियरर <token-key>

समापन बिंदु:
पोस्ट /च ैट/कम्प्लीशन
यह एंडपॉइंट चैट अनुरोधों को स्वीकार करता है और निर्दिष्ट मॉडल के आधार पर प्रतिक्रियाओं को स्ट्रीम करता है।

मॉडल:
वर्तमान में उपलब्ध मॉडल में शामिल हैं:
निंजा-डीप-रिसर्च
निंजा-सुपर-एजेंट: टर्बो
निंजा-सुपर-एजेंट: एपेक्स
निंजा - सुपर-एजेंट: रीज़निंग

इन मॉडलों को प्रदान करके चुना जा सकता है मॉडल आपके अनुरोध के मुख्य भाग में पैरामीटर।

अनुरोध का फ़ॉर्मेट

निंजा एपीआई इस प्रकार है ओपनएआई एपीआई स्पेक निकट से। अनुरोध JSON ऑब्जेक्ट में शामिल हैं:

मॉडल (स्ट्रिंग):
उपयोग करने के लिए मॉडल पहचानकर्ता (जैसे, “निंजा-डीप-रिसर्च”)।

संदेश (सरणी):
संदेश वस्तुओं की एक सरणी। प्रत्येक ऑब्जेक्ट फ़ॉर्मेट का अनुसरण करता है:

JSON

{ "role": "user", "content": "Your query here." }
  

स्ट्रीम (बूलियन):
पर सेट होने पर सच है, एपीआई स्ट्रीमिंग प्रतिक्रिया के साथ प्रतिक्रिया करता है।

stream_options (ऑब्जेक्ट):
स्ट्रीमिंग के लिए अतिरिक्त विकल्प, जैसे “शामिल_यूसेज”: सच टोकन उपयोग विवरण शामिल करने के लिए।

extra_headers (ऑब्जेक्ट):
निंजा एपीआई द्वारा आवश्यक कोई भी अतिरिक्त शीर्षलेख (इस बिंदु पर कोई नहीं)

अनुरोध का उदाहरण (जेसन)

JSON

{
  "model": "ninja-super-agent:turbo",
  "messages": [
    {
      "role": "user",
      "content": "What is the significance of birefringence in materials science? Can you provide a detailed explanation including its applications and how it is measured?"
    }
  ],
  "stream": true,
  "stream_options": {
    "include_usage": true
  }
}
  

रिस्पांस

API की एक स्ट्रीम लौटाता है चैट कंप्लीशन चंक वस्तुओं। प्रत्येक खंड में ये शामिल हो सकते हैं:

कॉन्टेंट:
पूरा होने का टेक्स्ट, जिसमें एक्सएमएल-रैप्ड रीज़निंग चरण शामिल हो सकते हैं।

उद्धरण:
दिए गए तर्क का समर्थन करने वाले URL की सूची।

उपयोग की जानकारी:
टोकन उपयोग के आंकड़े अगर “शामिल_यूसेज”: सच निर्दिष्ट किया गया था।

क्लाइंट कोड, रिच रिस्पॉन्स दिखाने के लिए इन हिस्सों को प्रोसेस कर सकता है, जिसमें ये चीज़ें शामिल हैं:

रीज़निंग स्टेप्स: XML सेगमेंट से निकाला और फ़ॉर्मेट किया गया।

उद्धरण: क्रमांकित सूची के रूप में प्रदर्शित किया गया।

उपयोग के आंकड़े: इनपुट और आउटपुट टोकन दिखा रहा है।

नमूना कोड उदाहरण

Python

import time
import xml.etree.ElementTree as ET
from uuid import uuid4
from openai import OpenAI, Stream
from openai.types import CompletionUsage
from openai.types.chat import ChatCompletionChunk

# Initialize the OpenAI client with your API key and base URL.
client = OpenAI(api_key="PUT_YOUR_API_KEY_HERE", base_url="https://api.myninja.ai/v1")

def print_reasoning_step(reasoning_step: str):
    step = ET.fromstring(reasoning_step)
    print(f"[{step.find('header').text}]\n{step.find('content').text}\n")

def print_citations(citations: list[str]):
    width = len(str(len(citations)))
    print("[Citations]")
    for n, citation in enumerate(citations, 1):
        print(f"{n:{width}}. {citation}")
    print()

def print_content(content: str):
    print(content, end="", flush=True)

def print_usage(usage: CompletionUsage):
    print(
        f"\n\n| Input tokens: {usage.prompt_tokens:,} "
        f"| Output tokens: {usage.completion_tokens:,} ",
        end="",
        flush=True,
    )

def main():
    query = (
        "I am an advanced snowboarder and want a good all-mountain snowboard and new boots and "
        "I'd like to spend no more than $1000 all in. Also look at trends and reviews and give "
        "me options that are currently trendy and cool and have high reviews."
    )

    start_time = time.time()
    
    response: Stream[ChatCompletionChunk] = client.chat.completions.create(
        model="ninja-deep-research",
        messages=[
            {"role": "user", "content": query},
        ],
        stream=True,
        stream_options={
            "include_usage": True,
        },
    )

    for chunk in response:
        for choice in chunk.choices:
            if content := choice.delta.content:
                if content.startswith("<step>"):
                    print_reasoning_step(content)
                else:
                    print_content(content)

        if citations := chunk.model_extra.get("citations"):
            print_citations(citations)
        elif usage := chunk.usage:
            print_usage(usage)

    elapsed_time = time.time() - start_time
    print(f"| Elapsed: {elapsed_time:.1f} seconds |")

if __name__ == "__main__":
    main()
  
cURL

curl -N https://api.myninja.ai/v1/chat/completions \
  -H "Authorization: Bearer PUT_YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ninja-super-agent:turbo",
    "messages": [
      {
        "role": "user",
        "content": "What is the significance of birefringence in materials science? Can you provide a detailed explanation including its applications and how it is measured?"
      }
    ],
    "stream": true,
    "stream_options": {
      "include_usage": true
    }
  }'
Java

HttpResponse<String> response = Unirest.post("https://api.myninja.ai/v1/chat/completions")
  .header("Authorization", "Bearer PUT_YOUR_API_KEY_HERE")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();
  
JavaScript

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Bearer PUT_YOUR_API_KEY_HERE',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: "ninja-super-agent:turbo",
    messages: [
      {
        role: "user",
        content: "What is the significance of birefringence in materials science? Can you provide a detailed explanation including its applications and how it is measured?"
      }
    ],
    stream: true,
    stream_options: {
      include_usage: true
    }
  })
};

fetch('https://api.myninja.ai/v1/chat/completions', options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));
  
Go

package main

import (
  "bufio"
  "bytes"
  "fmt"
  "io"
  "log"
  "net/http"
)

func main() {
  url := "https://api.myninja.ai/v1/chat/completions"

  jsonStr := ` + "`" + `{
    "model": "ninja-super-agent:turbo",
    "messages": [
      {
        "role": "user",
        "content": "What is the significance of birefringence in materials science? Can you provide a detailed explanation including its applications and how it is measured?"
      }
    ],
    "stream": true,
    "stream_options": {
      "include_usage": true
    }
  }` + "`" + `

  req, err := http.NewRequest("POST", url, bytes.NewBuffer([]byte(jsonStr)))
  if err != nil {
    log.Fatalf("Error creating request: %v", err)
  }

  req.Header.Set("Authorization", "Bearer PUT_YOUR_API_KEY_HERE")
  req.Header.Set("Content-Type", "application/json")

  client := &http.Client{}
  resp, err := client.Do(req)
  if err != nil {
    log.Fatalf("Error sending request: %v", err)
  }
  defer resp.Body.Close()

  if resp.StatusCode != http.StatusOK {
    log.Fatalf("Request failed with status: %s", resp.Status)
  }

  reader := bufio.NewReader(resp.Body)
  for {
    line, err := reader.ReadBytes('\n')
    if err != nil {
      if err == io.EOF {
        break
      }
      log.Fatalf("Error reading response: %v", err)
    }
    fmt.Print(string(line))
  }
}
  
C#

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;

namespace NinjaApiExample
{
  class Program
  {
    static async Task Main(string[] args)
    {
      var url = "https://api.myninja.ai/v1/chat/completions";
      var apiKey = "PUT_YOUR_API_KEY_HERE";

      using var client = new HttpClient();
      client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);
      client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

      var payload = new
      {
        model = "ninja-super-agent:turbo",
        messages = new[]
        {
          new { role = "user", content = "What is the significance of birefringence in materials science? Can you provide a detailed explanation including its applications and how it is measured?" }
        },
        stream = true,
        stream_options = new { include_usage = true }
      };

      var jsonPayload = JsonSerializer.Serialize(payload);
      var content = new StringContent(jsonPayload, Encoding.UTF8, "application/json");

      try
      {
        var response = await client.PostAsync(url, content);
        response.EnsureSuccessStatusCode();

        var responseBody = await response.Content.ReadAsStringAsync();
        Console.WriteLine(responseBody);
      }
      catch (HttpRequestException e)
      {
        Console.WriteLine("Request error: " + e.Message);
      }
    }
  }
}
  

मूल्य निर्धारण

मोड

इनपुट मूल्य/ प्रति एम टोकन

आउटपुट मूल्य/ प्रति एम टोकन

मूल्य/ कार्य

क्वेन 3 कोडर 480B (सेरेब्रस)

निंजा क्लाइन एआई स्टूडियो के लिए डिफ़ॉल्ट

$1.50

मानक मोड

गुणवत्ता और गति के लिए संतुलन
डिफ़ॉल्ट:
ग्लैम 4.6
डीप कोडर:
ग्लैम 4.6

$1.00

कॉम्पलेक्स मोड

जटिल कार्यों के लिए उच्चतम गुणवत्ता वाला एलएलएम
डिफ़ॉल्ट:
सॉनेट 4.5
डीप कोडर
सॉनेट 4.5

$1.50

फ़ास्ट मोड

दुनिया का सबसे तेज जनरल एजेंट
डिफ़ॉल्ट:
ग्लैम 4.6*
गहन शोध:
Qwen Model Logo
क्वेन3—235बी*
डीप कोडर:
ग्लैम 4.6
*सेरेब्रस द्वारा संचालित
Cerebras logo

$1.50

मोड

इनपुट मूल्य/ प्रति एम टोकन

आउटपुट मूल्य/ प्रति एम टोकन

मूल्य/ कार्य

क्वेन 3 कोडर 480B (सेरेब्रस)

निंजा क्लाइन एआई स्टूडियो के लिए डिफ़ॉल्ट

$3.75

$3.75

मानक मोड

गुणवत्ता और गति के लिए संतुलन
डिफ़ॉल्ट:
ग्लैम 4.6
डीप कोडर:
ग्लैम 4.6

$1.50

$1.50

कॉम्पलेक्स मोड

जटिल कार्यों के लिए उच्चतम गुणवत्ता वाला एलएलएम
डिफ़ॉल्ट:
सॉनेट 4.5
डीप कोडर
सॉनेट 4.5

$4.50

$22.50

फ़ास्ट मोड

दुनिया का सबसे तेज जनरल एजेंट
डिफ़ॉल्ट:
ग्लैम 4.6*
गहन शोध:
Qwen Model Logo
क्वेन3—235बी*
डीप कोडर:
ग्लैम 4.6
*सेरेब्रस द्वारा संचालित
Cerebras logo

$3.75

$3.75

मॉडल

इनपुट मूल्य/ प्रति एम टोकन

आउटपुट मूल्य/ प्रति एम टोकन

टर्बो 1.0

$0.11

$0.42

एपेक्स 1.0

$0.88

$7.00

रीज़निंग 2.0

$0.38

$1.53

डीप रिसर्च 2.0

$1.40

$5.60

दर सीमाएँ

निंजा एआई प्रति मॉडल अनुमान अनुरोधों पर दर सीमा लागू करता है ताकि यह सुनिश्चित हो सके कि डेवलपर्स सबसे तेज़ अनुमान का प्रयास करने में सक्षम हैं।

मॉडल

अनुरोध प्रति मिनट (आरपीएम)

टर्बो 1.0

50

एपेक्स 1.0

20

रीज़निंग 2.0

30

डीप रिसर्च 2.0

5

अक्सर पूछे जाने वाले प्रश्न

हमसे जो सबसे अधिक पूछा जाता है, उसके आधार पर आपको निंजा के एपीआई के बारे में जानने की जरूरत है, यहां बताया गया है।

मैं अपनी ऑटो-पे सीमा और राशि को कैसे बढ़ा सकता हूं?

  • निंजा में, बाएं पैनल पर जाएं और क्लिक करें API प्रबंधन आइकन

  • के अंतर्गत “आपके क्रेडिट,” क्लिक करें “क्रेडिट प्रबंधित करें”

  • में “ऑटो-पे राशि” फ़ील्ड, वह राशि दर्ज करें जिसे आप क्रेडिट के लिए बढ़ाना चाहते हैं (न्यूनतम $30)

  • में “ऑटो-पे थ्रेसहोल्ड” फ़ील्ड, थ्रेसहोल्ड राशि को संपादित करें कि जब आपका बैलेंस इस राशि से कम हो जाता है तो हम इसे फिर से लोड करेंगे “ऑटो-पे राशि”। इससे यह पक्का होता है कि आपके क्रेडिट खत्म नहीं होंगे या आपकी API कुंजी काम करना बंद नहीं करेगी (न्यूनतम $25)।

  • क्लिक करें “परिवर्तन सहेजें” पुष्टि करने के लिए।

मैं अपने ऑटो-पेमेंट अनुबंध को कैसे रद्द कर सकता हूं?

  • निंजा में, बाएं पैनल पर जाएं और क्लिक करें API प्रबंधन आइकन

  • चुनें “API कुंजियाँ और क्रेडिट” फिर यहां जाएं “आपके क्रेडिट” अनुभाग।

  • के अंतर्गत “आपके क्रेडिट,” क्लिक करें “और विकल्प”

  • चुनें “क्रेडिट के लिए ऑटो-पे रद्द करें”(न्यूनतम $30)

  • क्लिक करें “ऑटो-पे हटाएं” पुष्टि करने के लिए।

मैं API कुंजी कैसे हटाऊं?

  • निंजा में, बाएं पैनल पर जाएं और क्लिक करें API प्रबंधन आइकन

  • चुनें “API कुंजियाँ और क्रेडिट,” फिर यहां जाएं “API कुंजियाँ”

  • अपनी API कुंजी ढूंढें और दाईं ओर ट्रैश आइकन चुनें।

  • क्लिक करें “API कुंजी हटाएं” पुष्टि करने के लिए।

मैं प्रत्येक API अनुरोध के उपयोग को कैसे देख सकता हूं?

  • निंजा में, बाएं पैनल पर जाएं और क्लिक करें API प्रबंधन आइकन

  • इसके बाद क्लिक करें “API का उपयोग”

  • पर “API का उपयोग” पेज पर, आपको प्रत्येक API के लिए निम्नलिखित विवरण प्रदर्शित करने वाली एक तालिका दिखाई देगी:

    • मुख्य नाम

    • मॉडल

    • इनपुट और आउटपुट टोकन

    • इनपुट और आउटपुट लागत

    • अनुरोध के लिए टाइम स्टैम्प

    • कुल लागत