गिन्यानाचो आदार / विकसक

चॅट, प्रतिसाद आनी मेसेज

मॉडेलाक कितेंय विचारपाचे तीन मार्ग, तीन प्रकारांत गिरायक पयलींच उलयतात, सगळे एकाच मॉडेलाचेर चलतात आनी तेच तरेन बिल दितात.

हें पान सोयी खातीर मशीनांतल्यान अणकारीत केलां. इंग्लीश मूळ ही आवृत्ती लागू जाता.

चॅट कॉम्प्लिशन्स

ओपनएआय चॅट फॉरमॅट, आनी चड करून सगळें साधन ताका आदार दिता. आतां मेरेन संवाद धाड आनी फुडलो संदेश परत मेळय.

POST https://nymbot.ai/api/v1/chat/completions - एक ए. पी. आय. किल्ली जाय.

फकत model आनी messages गरज आसा. निवडिल्ल्या मॉडेलान घेवंक नाशिल्लें सॅम्पलिंग पॅरामीटर त्रुटी नासतना सोडटात, देखून एक विनंती बॉडी सगळ्या मॉडेलांचेर काम करता. मॉडेल वळेरी दरेका मॉडेलाचे नमुने दिता. supported_parametersजें न्हय तें सोडपा परस नाकारप म्हणल्यार, तें हें सगळेच जे मॉडेल कतयच करूंक शकना: पळोवंक शकनासेल्ल्या मॉडेल खातीर चित्रां, आनी वळखूंक शकनासेल्ल्या मॉडेल खातीर टूल्स.

जाप एक सामान्य आसा chat.completion, खर्चा वांगडा usage.cost (डॉलरांत) आनी nymbot ऑब्जेक्ट. model समाधान केल्लें मॉडेल आयडी आसा, देखून एक ल्हान नांव पुराय म्हणून परत येता. मॉडेलान जाप दिवचे पयलीं तर्क केला जाल्यार ताचो तर्क हातूंत आसा message.reasoning_content, उत्तरा पसून वेगळें.

प्रतिसाद

{
  "id": "chatcmpl-5f1c0a9e27d84b3c",
  "object": "chat.completion",
  "created": 1790726400,
  "model": "anthropic/claude-sonnet-5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "A Lightning invoice is a one-time payment request..."
      },
      "logprobs": null,
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 1240,
    "completion_tokens": 380,
    "total_tokens": 1620,
    "prompt_tokens_details": { "cached_tokens": 0 },
    "completion_tokens_details": { "reasoning_tokens": 0 },
    "cost": 0.01895
  },
  "nymbot": {
    "balance": "pro",
    "charged_credits": 0.162,
    "charged_sats": 16.2,
    "balance_credits": 412.425,
    "balance_sats": 41242.5
  }
}

finish_reason परत आयिल्ल्या गजालींतल्यान सोदून काडटात, कारण पुरवणदार ताचो वेगळो अहवाल दितातः tool_calls जेदोन मॉडेलान टूल्स मागले, length जेन्ना उतरांत परवानगी दिवपी दरेक टोकन वापरताले (वा मॉडेलान तांचो सगळो तर्क खर्च केलो आनी जाप बरोवंक नाशिल्ली), content_filter जेन्ना पुरवणदारान न्हयकार दिलो, आनी stop नाजाल्यार. usage.completion_tokens_details.reasoning_tokens सदांच 0 आसताः लिपिल्ले तर्क टोकन मेजतात, आनी तातूंत चार्ज करतात completion_tokens.

दरेक एन्डपॉईंट शेअर स्थिती कोड सकयल वळेरीत केल्यात चुकीं..

cURL

curl https://nymbot.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-5",
    "messages": [
      {"role": "system", "content": "Answer in one short paragraph."},
      {"role": "user", "content": "What is a Lightning invoice?"}
    ],
    "max_tokens": 400
  }'

Python

import os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

reply = client.chat.completions.create(
    model="anthropic/claude-sonnet-5",
    messages=[
        {"role": "system", "content": "Answer in one short paragraph."},
        {"role": "user", "content": "What is a Lightning invoice?"},
    ],
    max_tokens=400,
)
print(reply.choices[0].message.content)
print(reply.usage.cost)

JavaScript

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const reply = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-5",
  messages: [
    { role: "system", content: "Answer in one short paragraph." },
    { role: "user", content: "What is a Lightning invoice?" },
  ],
  max_tokens: 400,
});
console.log(reply.choices[0].message.content);
console.log(reply.usage.cost);

स्ट्रीमींग

वांगडा "stream": true मॉडेल बरयतना सर्वरान धाडिल्ले इव्हेंट म्हणून जाप मेळटा. दर एक इव्हेंट एक chat.completion.chunk एकाचेर data: वाक, आनी प्रवाह सोंपता data: [DONE]तर्क येता. delta.reasoning_content, हातूंत जाप delta.content.

सुमार 100 सेकंदां परस चड वेळ लागपी खंयचीय गजाल प्रवाहित करात, देखीक लांब जाप, व्हडलो प्रतिसाद max_tokens वा तर्क मॉडेल. प्रवाहांत हाडूंक नाशिल्ल्या विनंत्यान जाप पुराय जाय मेरेन कांयच धाडना, आनी तुजें आनी निम्बॉट हांचे मदलें जाळें सुमार 100 सेकंदां उपरांत एक निष्क्रिय जोडणी बंद करूंक शकता; मॉडेल अजूनय सोंपता आनी ताणें जें बरयलां तें चार्ज जाता, पूण जाप ना जाता. एक प्रवाह कीप-अलायव्ह धाडटा, देखून मॉडेल बरोव मेरेन तो उक्तो उरता.

प्रवाह

data: {"id":"chatcmpl-5f1c0a9e27d84b3c","object":"chat.completion.chunk","created":1790726400,"model":"anthropic/claude-sonnet-5","choices":[{"index":0,"delta":{"role":"assistant","content":""},"finish_reason":null}]}

data: {"id":"chatcmpl-5f1c0a9e27d84b3c","object":"chat.completion.chunk","created":1790726400,"model":"anthropic/claude-sonnet-5","choices":[{"index":0,"delta":{"content":"A Lightning invoice"},"finish_reason":null}]}

: keep-alive

data: {"id":"chatcmpl-5f1c0a9e27d84b3c","object":"chat.completion.chunk","created":1790726400,"model":"anthropic/claude-sonnet-5","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: {"id":"chatcmpl-5f1c0a9e27d84b3c","object":"chat.completion.chunk","created":1790726400,"model":"anthropic/claude-sonnet-5","choices":[],"usage":{"prompt_tokens":1240,"completion_tokens":380,"total_tokens":1620,"cost":0.01895},"nymbot":{"balance":"pro","charged_credits":0.162,"charged_sats":16.2,"balance_credits":412.425,"balance_sats":41242.5}}

data: [DONE]

• सुरू जावपी रांक : कीप-अलायव्ह कॉमेंट आसतात, मॉडेल विचार करतना दर 15 सेकंदांनी धाडटात. एस. एस. ई. गिरायक तीं सोडटात.
• माग. "stream_options": {"include_usage": true} वयलो निमाणो भाग मेळोवपा खातीर, एक रिकामो भाग घेवन choices, टोकन मेजतात, खर्च आनी nymbot ऑब्जेक्ट.
• प्रवाह सोंपतकच शुल्क थारता. तुमी जोडणी बेगीन बंद केल्यार, मॉडेल बंद जायनाः निंबॉट प्रदात्याचो उरिल्लो प्रवाह वाचता, 25 सेकंदां मेरेन, ताचो टोकन आंकडो मेळोवपा खातीर, आनी प्रदातो कितें अहवाल दिता तें तूं फारीक करता. ते गणीत नासतना तुमच्या इनपुट आनी कितें बरयलां हाचे वयल्यान शुल्काचो अदमास काडटात, तशेंच त्या कारणाक लागून मॉडेला खातीर पुराय उत्पादन भत्ता.
• पयल्या चंक पयलीं एक त्रुटी, देखीक 401 अतवी 402, स्थिती कोड घेवन सामान्य जे. एस. ओ. एन. म्हुणून परत येता, प्रवाह म्हुणून न्हय. प्रवाह सुरू जाले उपरांत एक त्रुटी निमाण्या म्हुणून येता. data: {"error": {…}} घटना, आनी स्ट्रीम विणेंच सुटता [DONE].
• Tools आनी OpenAI च्या Responses transport वरी चलपी models आनी requests, provider कडून स्ट्रीम करिनाचें. ते परत खूब वैध स्ट्रीमान उत्तर दितात, जे उत्तर पुराय जावचे उपरांत मेळटा.

cURL

curl -N https://nymbot.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nymbot/auto",
    "stream": true,
    "stream_options": {"include_usage": true},
    "messages": [{"role": "user", "content": "Write a haiku about sats."}]
  }'

Python

import os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

stream = client.chat.completions.create(
    model="nymbot/auto",
    stream=True,
    stream_options={"include_usage": True},
    messages=[{"role": "user", "content": "Write a haiku about sats."}],
)
for chunk in stream:
    if chunk.choices:
        print(chunk.choices[0].delta.content or "", end="", flush=True)
    elif chunk.usage:
        print("\ncost:", chunk.usage.cost)

JavaScript

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const stream = await client.chat.completions.create({
  model: "nymbot/auto",
  stream: true,
  stream_options: { include_usage: true },
  messages: [{ role: "user", content: "Write a haiku about sats." }],
});
for await (const chunk of stream) {
  if (chunk.choices.length) process.stdout.write(chunk.choices[0].delta.content || "");
  else if (chunk.usage) console.log("\ncost:", chunk.usage.cost);
}

टूल कॉल

हातूंत फंक्शनाचें वर्णन कर tools आनी मॉडेल जाप दिवचे बदला एकाक फोन करपाक विचारूंक शकता. तुमी कार्य चलयतात, ताचो परिणाम म्हणून जोडो tool तोच संदेश tool_call_id, आनी परत उलोवप धाड. निमबॉट केन्नाच तुजी कार्यावळ चलयता ना; ती मॉडेलाची विनंती तुजेकडेन परत पावयता.

tool_choice घेता. "auto", "none", "required" अतवी {"type": "function", "function": {"name": "…"}}मॉडेल वळेरेंत खंयच्या मॉडेलांक साधनां म्हणपाक शकतात (capabilities.tools). साधनां न्हयकारतात 400 unsupported_tool ताचेर nymbot/auto आनी ओपनएआयच्या प्रतिसाद येरादारीचेर चलपी कांय कॅटलॉग मॉडेलांचेर, जांकां निम्बॉट साधनां पास करूंक शकना.

वांगडा "stream": true, साधनां सयत एक विनंती एका भागांत चलता आनी मागीर ती सामान्य चंक क्रम म्हणून धाडटातः भुमिका, अनुक्रमणिका, आयडी, नांव आनी आर्ग्युमेंट आनी फिनिश चंक आशिल्लो दरेक टूल कॉल आशिल्लो एक चंक. प्रवाहित टूल कॉल वाचपी गिरायक सदचे भशेन हाताळतात.

प्रतिसाद, कांय प्रमाणांत

"choices": [
  {
    "index": 0,
    "message": {
      "role": "assistant",
      "content": null,
      "tool_calls": [
        {
          "id": "call_7d2e",
          "type": "function",
          "function": { "name": "get_invoice_status", "arguments": "{\"invoice_id\":\"a41f\"}" }
        }
      ]
    },
    "finish_reason": "tool_calls"
  }
]

cURL

curl https://nymbot.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-5",
    "messages": [{"role": "user", "content": "Has invoice a41f been paid?"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "get_invoice_status",
        "description": "Look up whether an invoice is paid.",
        "parameters": {
          "type": "object",
          "properties": {"invoice_id": {"type": "string"}},
          "required": ["invoice_id"]
        }
      }
    }]
  }'

Python

import json, os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

tools = [{
    "type": "function",
    "function": {
        "name": "get_invoice_status",
        "description": "Look up whether an invoice is paid.",
        "parameters": {
            "type": "object",
            "properties": {"invoice_id": {"type": "string"}},
            "required": ["invoice_id"],
        },
    },
}]
messages = [{"role": "user", "content": "Has invoice a41f been paid?"}]

reply = client.chat.completions.create(model="anthropic/claude-sonnet-5", messages=messages, tools=tools)
call = reply.choices[0].message.tool_calls[0]
args = json.loads(call.function.arguments)

messages.append(reply.choices[0].message)
messages.append({"role": "tool", "tool_call_id": call.id, "content": json.dumps({"paid": True})})

final = client.chat.completions.create(model="anthropic/claude-sonnet-5", messages=messages, tools=tools)
print(final.choices[0].message.content)

JavaScript

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const tools = [{
  type: "function",
  function: {
    name: "get_invoice_status",
    description: "Look up whether an invoice is paid.",
    parameters: {
      type: "object",
      properties: { invoice_id: { type: "string" } },
      required: ["invoice_id"],
    },
  },
}];
const messages = [{ role: "user", content: "Has invoice a41f been paid?" }];

const reply = await client.chat.completions.create({ model: "anthropic/claude-sonnet-5", messages, tools });
const call = reply.choices[0].message.tool_calls[0];
const args = JSON.parse(call.function.arguments);

messages.push(reply.choices[0].message);
messages.push({ role: "tool", tool_call_id: call.id, content: JSON.stringify({ paid: true }) });

const final = await client.chat.completions.create({ model: "anthropic/claude-sonnet-5", messages, tools });
console.log(final.choices[0].message.content);

विनंती करतना चित्रां

ताचे वांगडा मॉडल्स capabilities.vision चित्रां वाचपाक शकतात. एक जोडपाक शकतात image_url वापरप्याच्या संदेशाचो भाग, एक तर भौशीक https:// लिंक वा ए data:image/…;base64, यू. आर. एल...................................................................................................................................................................................................400 invalid_image_url). Ek voichik detail आसा auto, low अतवी high.

वांगडा nymbot/auto, तातूंत एक चित्र आशिल्ली विनंती पळोवंक मेळपी मानक मॉडेलाचेर धाडटात. ताचे बगर एक कॅटलॉग मॉडेल capabilities.vision ताचे वांगडा फोटो काडपाक न्हयकार दिता 400 unsupported_contentचित्रां फकत वापरप्याच्या संदेशांत आसूं येतात. लिंक भौशीक होस्टाक दाखोवपाक जाय; निम्बॉट चित्र मॉडेलाच्या प्रदात्याक पावयता आनी तें दवरना.

बाकीच्या विनंत्या भशेन, प्रदात्यान ताचे खातीर मेजिल्ले इनपुट टोकन म्हणून एक चित्र आकारतात.

cURL

curl https://nymbot.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-5",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "What is in this picture?"},
        {"type": "image_url", "image_url": {"url": "https://example.com/receipt.jpg"}}
      ]
    }]
  }'

Python

import base64, os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

with open("receipt.jpg", "rb") as f:
    data_url = "data:image/jpeg;base64," + base64.b64encode(f.read()).decode()

reply = client.chat.completions.create(
    model="anthropic/claude-sonnet-5",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "What is in this picture?"},
            {"type": "image_url", "image_url": {"url": data_url}},
        ],
    }],
)
print(reply.choices[0].message.content)

JavaScript

import { readFile } from "node:fs/promises";
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const dataUrl = "data:image/jpeg;base64," + (await readFile("receipt.jpg")).toString("base64");

const reply = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-5",
  messages: [{
    role: "user",
    content: [
      { type: "text", text: "What is in this picture?" },
      { type: "image_url", image_url: { url: dataUrl } },
    ],
  }],
});
console.log(reply.choices[0].message.content);

तर्क करप

ताचे वांगडा मॉडल्स capabilities.reasoning ते जाप दिवचे पयलीं विचार करूंक शकतात. ताचे विशीं चड वा उणें ताचेकडेन मागात reasoning_effort ("minimal", "low", "medium" अतवी "high") वा "reasoning": {"effort": "high"}, वा जोडो :thinking मॉडेलाच्या नांवाक, जाचो अर्थ चड यत्न असो जाता. मॉडेलाचेर तर्क करिनासतना मांडणी कडेन दुर्लक्ष करतात. nymbot/auto, :thinking विनंती प्रमाणीत तर्क मार्गाक धाडटा.

एंथ्रोपीक मॉडेलांचेर यत्न सुमार 1,000,2,000,8,000 वा 16,000 टोकनांचो विचार अर्थसंकल्प जाता, केन्नाच ताचे परस चड न्हय max_tokens परवानगी दिता. विचार केन्नाय सोडटात tool_choice साधन सक्तीचें करता, आनी जेन्ना विनंती टूल लूप चालू दवरता (ताचो निमाणो संदेश टूल रिझल्ट आसता), कारण एंथ्रोपिकाक तें परतून सुरू करपा खातीर आदीं स्वाक्षरी केल्ल्या विचाराची गरज आसता. तेच प्रतिसाद आनी संदेश निमाण्या बिंदूंचेर लागू जाता.

तर्क परत येता message.reasoning_content, वा delta.reasoning_content स्ट्रीमिंग करताना, उत्तरान मेळोवनाचें. रिझनिंग (Reasoning) आउटपुट आसा आनी ताचो दर लावप आसता, भितर completion_tokens. कांय प्रोवाइडेर्स रीजनिंग टेक्स्ट विनाच दितात, आनी तरीय तें चार्ज केल्लें वता.

cURL

curl https://nymbot.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-5",
    "reasoning_effort": "high",
    "messages": [{"role": "user", "content": "Is 2^61 - 1 prime? Show why."}]
  }'

Python

import os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

reply = client.chat.completions.create(
    model="anthropic/claude-sonnet-5",
    reasoning_effort="high",
    messages=[{"role": "user", "content": "Is 2^61 - 1 prime? Show why."}],
)
message = reply.choices[0].message
print(getattr(message, "reasoning_content", None))
print(message.content)

JavaScript

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const reply = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-5",
  reasoning_effort: "high",
  messages: [{ role: "user", content: "Is 2^61 - 1 prime? Show why." }],
});
console.log(reply.choices[0].message.reasoning_content);
console.log(reply.choices[0].message.content);

प्रतिकृती प्रतिकृती

मॉडेलाच्या नांवाचेर एक प्रत्यय विनंती कशी हाताळटात तें बदलता, दुसरे क्षेत्रा बगर. ते पुराय आयडी आनी ल्हान नांवांचेर सारकेच काम करतात, जशें हातूंत आसा. anthropic/claude-sonnet-5:online.

हेर खंयच्याय प्रत्ययाक दुर्लक्ष करतात. पुराय नांव पयलीं वापरून पळयतात, देखून जाचे आयडीचेर खरेंच कोलोन आसता तो मॉडेल अजूनय काम करता; अशें जावंक नाशिल्ल्यान, मॉडेल जुळटा मेरेन प्रत्यय एका वेळार निमाणें एक काडून उडयतात. एका मॉडेलाचें नांव चडांत चड 200 अक्षरां लांब आसूं येता आनी तातूंत चडांत चड 4 प्रत्यय आसूं येतात; चडांत चड लांब म्हटल्यार न्हयकारतात 400 invalid_value.

cURL

curl https://nymbot.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-5:thinking",
    "messages": [{"role": "user", "content": "Plan a three-day trip to Lisbon."}]
  }'

Python

import os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

reply = client.chat.completions.create(
    model="anthropic/claude-sonnet-5:thinking",
    messages=[{"role": "user", "content": "Plan a three-day trip to Lisbon."}],
)
print(reply.choices[0].message.content)

JavaScript

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const reply = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-5:thinking",
  messages: [{ role: "user", content: "Plan a three-day trip to Lisbon." }],
});
console.log(reply.choices[0].message.content);

वॅब सोद

कोणचेंय चॅट मॉडेल लाईव्ह वेब थामून उत्तर दिवपाक शकता. नymbॉट (Nymbot) शेवटच्या युझरच्या मेसेजक (त्याचे पयलीं २,००० अक्षरां) वटयता, सगळ्यांत बरया पानां वाचता आनी तांकां प्रस्ना वांगडा मॉडेलक दिता, जाका 'बाहेरचें आशय' (outside content) म्हूण चिन्हांकित केलां जेणेकरून मॉडेलान तातूंतल्यान खंयच्याच सूचना घेवंक जायना. हातूंत दोन मोड (modes) आसात:

• सगळ्या वेळार शोधपाक जावपें: "plugins": [{"id": "web", "max_results": 5}], वा अ :online मॉडेलचे प्रत्यय.
• मदत जाता तेन्ना सोद: "tools": [{"type": "web_search", "parameters": {"max_results": 5}}], तशेंच स्वीकारिल्ले अशा रूपान web_search_preview अतवी openrouter:web_searchनम्बोट फकत तेन्नाच सर्च करता जेन्ना प्रश्नान नवी माहितीची गरज आसल्याचे दिसता, तेच टेस्ट जो ऐप वापरता.

max_results पूर्वनिर्धारीतपणान 5 आनी चडांत चड 10 आसा. स्त्रोत परत येतात nymbot.web_search.sources, दरेका वांगडा अ title, snippet आनी url, आनी जशें url_citation संदेशाचेर टिप्पणी.

प्रत्येक चलपी वळख $0.008 खर्च करता, जें टोकन्स फाटल्यान सॅट्स (sats) हें रूपांतरित जावन, आनी तें होल्डचो भाग आसा. तीं वाचिल्लीं पानां तितलीच इनपुट टोकन्स आसात, देखून वेब कडून मेळपी जाप टोकन्स फाटल्यान विचारिल्ल्या सद्याच्या जाप परस चड खर्चायता, केन्ना तरी कित्येक फावटी चड.

प्रतिसाद, कांय प्रमाणांत

"nymbot": {
  "balance": "pro",
  "charged_credits": 0.431,
  "charged_sats": 43.1,
  "balance_credits": 411.994,
  "balance_sats": 41199.4,
  "web_search": {
    "sources": [
      { "title": "Lightning Network - Wikipedia", "snippet": "The Lightning Network is a payment protocol...", "url": "https://en.wikipedia.org/wiki/Lightning_Network" }
    ]
  }
}

cURL

curl https://nymbot.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-5",
    "plugins": [{"id": "web", "max_results": 5}],
    "messages": [{"role": "user", "content": "What changed in the latest Bitcoin Core release?"}]
  }'

Python

import os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

reply = client.chat.completions.create(
    model="anthropic/claude-sonnet-5",
    messages=[{"role": "user", "content": "What changed in the latest Bitcoin Core release?"}],
    extra_body={"plugins": [{"id": "web", "max_results": 5}]},
)
print(reply.choices[0].message.content)
for source in reply.model_extra["nymbot"]["web_search"]["sources"]:
    print(source["url"])

JavaScript

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const reply = await client.chat.completions.create({
  model: "anthropic/claude-sonnet-5",
  plugins: [{ id: "web", max_results: 5 }],
  messages: [{ role: "user", content: "What changed in the latest Bitcoin Core release?" }],
});
console.log(reply.choices[0].message.content);
for (const source of reply.nymbot.web_search.sources) console.log(source.url);

प्रतिसाद एपीआय

ओपनएआय एजंट्स एसडीके आनी कोडेक्स हांणी वापरिल्लें ओपनएआयचें नवें स्वरूप. ते चॅट कम्प्लीशन सारकेच मॉडेल, बिलिंग आनी वैशिष्ट्यांचेर चलता.

POST https://nymbot.ai/api/v1/responses - एक ए. पी. आय. किल्ली जाय.

प्रतिसाद

{
  "id": "resp_8c1e4b0f9a2d4e61",
  "object": "response",
  "created_at": 1790726400,
  "status": "completed",
  "model": "anthropic/claude-sonnet-5",
  "output": [
    {
      "type": "message",
      "id": "msg_2b7f",
      "role": "assistant",
      "status": "completed",
      "content": [{ "type": "output_text", "text": "A Lightning invoice is...", "annotations": [] }]
    }
  ],
  "output_text": "A Lightning invoice is...",
  "usage": {
    "input_tokens": 1240,
    "input_tokens_details": { "cached_tokens": 0 },
    "output_tokens": 380,
    "output_tokens_details": { "reasoning_tokens": 0 },
    "total_tokens": 1620
  },
  "incomplete_details": null,
  "error": null,
  "instructions": null,
  "store": false,
  "previous_response_id": null,
  "metadata": {},
  "nymbot": { "balance": "pro", "charged_credits": 0.162, "charged_sats": 16.2, "balance_credits": 412.425, "balance_sats": 41242.5 }
}

एक साधन विनंती दाखयता output अ म्हुणून function_call वस्तू वांगडा call_id, name आनी arguments; परिणाम परत एक म्हुणून धाड function_call_output तीच वस्तू call_idतर्क करप, जेन्ना मॉडेल तें परत करता, तें एक reasoning वस्तू वांगडा reasoning_text सामुग्री, पयलीं वळेरीत केल्ली. status आसा incomplete जेन्ना जाप आयली max_output_tokens वा पुरवणदारान न्हयकार दिलो, वांगडा incomplete_details.reason अशें सेट केल्लें max_output_tokens अतवी content_filter. प्रतिसादय सुद्धा विनंतीच्या सेटिंग्सक (तापमान, टूल्स, टूल चॉइस आनी तसोच कितेंय) OpenAI प्रमाणेंच प्रतिबिंबित करता, आनी तो... nymbot खर्चाची वस्तू.

स्ट्रीम्ड, दर एक इव्हेंट एक आसा event: लायन आनी अ data: अ वांगडा लायनी sequence_numberह्या क्रमानः response.created, response.in_progress, response.output_item.added, response.content_part.added, खंयचीय संख्या response.output_text.delta, response.output_text.done, response.content_part.done, response.output_item.done, आनी निमाणें response.completed वापर आनी खर्च हांचे वांगडा. उतर कापून ल्हान केल्याचो शेवट अशे तरेन जाता response.incomplete ताचे बदला, आनी प्रवाह सुरू जाले उपरांत एक अपेस response.failedतर्काक स्वताचो आयटम म्हुणून प्रवाह करप response.reasoning_text.delta आनी .doneसंदेशा उपरांत टूल कॉल येतात, दरेका कडेन एक आयटम आसता. response.function_call_arguments.delta आनी .done.

cURL

curl https://nymbot.ai/api/v1/responses \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-5",
    "instructions": "Answer in one short paragraph.",
    "input": "What is a Lightning invoice?"
  }'

Python

import os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

response = client.responses.create(
    model="anthropic/claude-sonnet-5",
    instructions="Answer in one short paragraph.",
    input="What is a Lightning invoice?",
)
print(response.output_text)

JavaScript

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const response = await client.responses.create({
  model: "anthropic/claude-sonnet-5",
  instructions: "Answer in one short paragraph.",
  input: "What is a Lightning invoice?",
});
console.log(response.output_text);

मानवशास्त्रीय संदेश

एंथ्रोपीक एस. डी. के. आनी क्लॉड कोड हांचे खातीर एंथ्रोपीकाचें स्वरूप. कॅटलॉगांतल्या दर एका मॉडेला वांगडा काम करता, फकत क्लॉड न्हयः विनंती भाषांतरीत केल्या, त्याच पाईपलाईनांतल्यान चलयतात, आनी परत भाषांतरीत करतात.

POST https://nymbot.ai/api/v1/messages - ए. पी. आय. किल्ली जाय, जशें x-api-key अतवी Authorization: Bearer.

द. anthropic-version आनी anthropic-beta हेडर स्विकारतात आनी दुर्लक्ष करतात. एंथ्रोपिक मॉडेल नांवां कॅटलॉगाक जुळटात, देखून क्लॉड कोड आनी एसडीके तांणी पयलींच वापरिल्ल्या नांवां वांगडा काम करतातः

• कॅटलॉगाक एक नांव खबर आसा, देखीक claude-sonnet-5 अतवी anthropic/claude-opus-5, जशें आसा तशे वापरतात.
• नाजाल्यार तारीख (-20260514), -latest, एक आवृत्ती टॅग जशें -v1, अशे ब्रॅकेटेड टॅग [1m] आनी एक anthropic/ अतवी anthropic. उपसर्ग काडून उडयतात, आनी आवृत्तींतले ठिपके आनी डॅश दोनूय तरांनी वापरून पळयतात (claude-haiku-4-5 सोदता claude-haiku-4.5).
• तें अजून कांयच मेळना जाल्यार, कुटुंब (ओपस, सॉनेट वा हाइकू) वापरतात, जो मेरेन कॅटलॉगची आवृत्ती मागल्या परस तीच वा नवी आसता.
• कांयच मेळना तें नांव परत येता 404 not_found_error.

प्रतिसाद

{
  "id": "msg_01c7a2f93e5b4d08",
  "type": "message",
  "role": "assistant",
  "model": "anthropic/claude-sonnet-5",
  "content": [{ "type": "text", "text": "A Lightning invoice is..." }],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 1240,
    "output_tokens": 380,
    "cache_read_input_tokens": 0,
    "cache_creation_input_tokens": 0
  },
  "nymbot": { "balance": "pro", "charged_credits": 0.162, "charged_sats": 16.2, "balance_credits": 412.425, "balance_sats": 41242.5 }
}

content धरून लेगीत दवरूं येता. tool_use ब्लॉक आनी अ thinking ब्लॉक, जाचें signature रिकामे आसा. stop_reason आसा end_turn, max_tokens, tool_use अतवी refusal, अशे तरेन काम केलें finish_reason ताचेर चॅट कॉम्प्लिशन्स; stop_sequence सदांच आसा null, स्टॉप सिक्वेन्स सोंपता तेन्ना लेगीत जाप मेळटा. input_tokens फकत ताजें इनपुट मेजतात; कॅशे केल्लें इनपुट दोन कॅशे क्षेत्रांनी आसा. किंमत हातूंत आसा nymbot ऑब्जेक्ट आनी X-Nymbot-Cost-Sats हेडर.

प्रवाहान भरिल्ल्यो ह्यो घडणुको एंथ्रोपीकच्यो आसातः message_start, content_block_start, ping, content_block_delta (text_delta, input_json_delta अतवी thinking_delta), content_block_stop, message_delta थांबोवपाचें कारण, वापर आनी nymbot खर्चाची वस्तू, आनी message_stopअ. ping मॉडेल काम करतना दर 15 सेकंदांनीय धाडटात. मजकूरा उपरांत टूल कॉल येतात, दर एक tool_use एकांत पुराय इनपुट दिवन ब्लॉक कर input_json_delta.

ह्या निमाण्या बिंदूचेर त्रुटी एंथ्रोपीकाचें स्वरूप वापरतातः {"type": "error", "error": {"type": "not_found_error", "message": "…"}}एक ल्हान शिल्लक आसा 402 billing_error, एक चड भार आशिल्लो पुरवणदार 503 overloaded_errorप्रवाह सुरू जाले उपरांत अपेस आयल्यार एक म्हुणून धाडटात error घडणूक.

cURL

curl https://nymbot.ai/api/v1/messages \
  -H "x-api-key: $NYMBOT_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "What is a Lightning invoice?"}]
  }'

Python

import os
import anthropic

client = anthropic.Anthropic(base_url="https://nymbot.ai/api", api_key=os.environ["NYMBOT_API_KEY"])

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "What is a Lightning invoice?"}],
)
print(message.content[0].text)

JavaScript

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({ baseURL: "https://nymbot.ai/api", apiKey: process.env.NYMBOT_API_KEY });

const message = await client.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "What is a Lightning invoice?" }],
});
console.log(message.content[0].text);

टोकन मेजप

संदेश विनंती कितले इनपुट टोकन वापरतले हाचो अदमास, जाका लागून क्लायंट धाडचे पयलीं तपासूंक शकता. तें फुकट आसा, पूण तरी लेगीत किल्लीची गरज आसा.

POST https://nymbot.ai/api/v1/messages/count_tokens - एक ए. पी. आय. किल्ली जाय. फुकट.

कूड ताचे सारकीच आसा संदेश, नासतना max_tokensमॉडेल नांवाचें निराकरण करचें पडटा. गणना हो एक अदमास आसाः प्रणाली प्रॉम्प्टाचीं अक्षरां, संदेश, टूल कॉल आनी साधनाच्यो व्याख्या चारांनी विभागिल्ल्यो, तशेंच दर एका चित्राक 1,600. हो प्रदात्याचो स्वताचो टोकनायझर न्हय, देखून खरी संख्या वेगवेगळी आसूं येता. आपल्या कॅपाक पाविल्ली किल्ली अजूनय ती वापरूंक शकता.

प्रतिसाद

{ "input_tokens": 318 }

cURL

curl https://nymbot.ai/api/v1/messages/count_tokens \
  -H "x-api-key: $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "What is a Lightning invoice?"}]
  }'

Python

import os
import anthropic

client = anthropic.Anthropic(base_url="https://nymbot.ai/api", api_key=os.environ["NYMBOT_API_KEY"])

count = client.messages.count_tokens(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "What is a Lightning invoice?"}],
)
print(count.input_tokens)

JavaScript

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({ baseURL: "https://nymbot.ai/api", apiKey: process.env.NYMBOT_API_KEY });

const count = await client.messages.countTokens({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "What is a Lightning invoice?" }],
});
console.log(count.input_tokens);

मॉडेलची यादी करून दाखवप

दरेक मॉडेल आनी जनरेटर ए. पी. आय. स्विकार करता, ताचो खर्च कितलो आसा. वळेरी एपच्या पिकराच्या त्याच थेट कॅटलॉगांतल्यान वाचतात, देखून सर्वर सदांच तेच चलयतलो.

GET https://nymbot.ai/api/v1/models - चावीची गरज ना. पांच मिण्टां खातीर कॅशे केल्लें.

GET /api/v1/models/{id} एक नोंद परत करता.

तुमी फारीक करतात तें दर, शुल्क आनी मार्जिन पयलींच, डॉलरांत आनी सॅटांत सद्याच्या बिटक्वॉइन किंमतीचेर. balance मॉडेल खंयच्या संतुलनाचेर खर्च करता तें सांगता. nymbot_key ऍप्लिकेशनांत मॉडेलाचें ल्हान नांव आसा. created मॉडेल केन्ना जोडिल्लें तें कॅटलॉग नोंद करूंक नाशिल्ल्यान सदांच 0 आसता. प्रकाशीत टोकन दर नाशिल्ल्या मॉडेलाची किंमत आसता per_request तेपरस.

nymbot/auto सदांच पयलीं आसता, म्हारग आसता variable, एका हुन routes दरेका प्रमाणीत मार्गाचे दर सांगपी वळेरी. तातूंत नदर आनी तर्क दाखयतात, पूण साधनां न्हय.

GET /api/v1/models/{id} विनंती म्हुणून तीच नांवां आनी उपनामां स्विकारतात, आनी तांणी थारायिल्ल्या मॉडेलाची नोंद परत करतात.

प्रतिसाद

{
  "object": "list",
  "data": [
    {
      "id": "anthropic/claude-sonnet-5",
      "object": "model",
      "type": "chat",
      "owned_by": "anthropic",
      "name": "Claude Sonnet 5",
      "created": 0,
      "context_length": 1000000,
      "max_output_tokens": 64000,
      "architecture": { "input_modalities": ["text", "image"], "output_modalities": ["text"] },
      "supported_parameters": ["max_tokens", "temperature", "tools", "tool_choice", "reasoning", "response_format", "stop"],
      "capabilities": { "vision": true, "video": false, "tools": true, "reasoning": true, "web_search": true },
      "balance": "pro",
      "pricing": {
        "type": "per_token",
        "currency": "USD",
        "input_per_1M_tokens": 4.725,
        "output_per_1M_tokens": 23.625,
        "cache_read_per_1M_tokens": 0.4725,
        "sats_input_per_1M_tokens": 4038,
        "sats_output_per_1M_tokens": 20192
      },
      "description": "...",
      "nymbot_key": "claude-sonnet"
    }
  ]
}

दुसरे प्रकार:

• चित्र प्रवेश आसात capabilities (accepts_image_url, requires_image_url, edit) आनी किंमत per_generation.
• व्हिडियो प्रवेश आसात max_duration_seconds आनी resolutions, आनी किंमत per_second दर एका संकल्पा खातीर.
• ऑडियो प्रवेश आसात audio_type speech अतवी transcription, किंमत per_1k_chars अतवी per_minute.
• घुसपागोंदळ करप प्रवेश आसात dimensions, context_length, max_inputs आनी दर लाख इनपुट टोकनांची किंमत.

थाराविल्ले दर "estimated": true ज्या जनरेटराक किंमत जाहीर जावंक ना ताचे खातीर ऍप्लिकेशनाचो अदमास आसा. एक अज्ञात type परत येतां 400.

cURL

curl "https://nymbot.ai/api/v1/models?type=chat"

Python

import requests

models = requests.get("https://nymbot.ai/api/v1/models", params={"type": "chat"}).json()["data"]
for m in models:
    print(m["id"], m["balance"], m["pricing"].get("input_per_1M_tokens"))

JavaScript

const res = await fetch("https://nymbot.ai/api/v1/models?type=chat");
const { data } = await res.json();
for (const m of data) console.log(m.id, m.balance, m.pricing.input_per_1M_tokens);