علم جو بنياد / ترقی ڪندڙ

چیٽ، جواب ۽ پیغام

ماڊل کان ڪجھ پڇڻ جا ٽی طریقا، ٽن فارمن ۾ گراہڪ اڳ ۾ ئی ڳالہائیندا آھن، سڀ ہڪ ئی ماڊل تی ھلندا آھن ۽ ساڳئی طریقی سان بل ڪندا آھن

هي صفحو سهولت لاءِ مشين سان ترجمو ٿيل آهي. انگريزي اصل نسخو آهي جيڪو لاڳو ٿئي ٿو.

چادر کي ختم ڪرڻ

اوپنآئی چیٽ فارمیٽ، ۽ اھو تقریبن ہر اوزار سپورٽ ڪری ٿو گفتگو موڪلیو اڃا تائین ۽ ایندڙ پیغام واپس حاصل ڪریو

POST https://nymbot.ai/api/v1/chat/completions - ھڪ API ڪنجی جی ضرورت آھی

بس۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔ model ۽ messages ضرورت آھی۔ ہڪ نمونی جو پیمانو جیڪو چونڊیل ماڊل نٿو وٺی بغیر غلطی جی ڊراپ ڪیو ویو آھی، تنہنڪری ہڪ درخواست جسم ماڊلز ۾ ڪم ڪری ٿو ماڊل لسٽ ہر ماڊل کی ڏئی ٿی supported_parametersجنہن کی ڊراپ ڪرڻ جی بدران انڪار ڪیو ویو آھی اھو ڪجھ آھی جیڪو ماڊل بلڪل نٿو ڪری سگہی: تصویرن لاء ماڊل جیڪو ڏسی نٿو سگہی، اوزار ماڊل لاء جیڪی انھن کی ڪال نٿا ڪری سگہن

جواب ھڪ عام آھی chat.completionقیمت سان گڏ usage.cost $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ nymbot آبجیکٹ model اھو حل ٿیل ماڊل ID آھی، تنہنڪری ہڪ مختصر نالو پورو نالو طئور واپس اچی ٿو 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 يا هڪ منطقي نموني. هڪ درخواست جيڪو نه سوتم ڪيو ويو آهي، جواب پوري ٿيڻ تائين ڪجھ به نه موڪليندو آهي. ۽ توهان ۽ Nymbot جي وچ ۾ هڪ بيٺل رابطي کي 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 سیڪنڊن ۾ موڪلیا ویا آھن جڏھن ماڊل سوچی رھیو آھی SSE گراہڪ انھن کی ڇڏی ڏیو
• گھرجاء۔ "stream_options": {"include_usage": true} مٿی جو آخری حصو حاصل ڪرڻ لاء، ہڪ خالی سان choices، ٽوڪن جی ڳڻپ، قیمت ۽ nymbot آبجیکٹ
• وہڪرو ختم ٿیڻ کان پوء چارج ٺیڪ ٿی ویندو آھی۔ جیڪڏھن توہان ڪنیڪشن کی جلدی بند ڪیو ٿا، ماڊل بند نہ ڪیو ویندو آھی Nymbot فراہم ڪندڙ جی باقی وہڪرو کی پڙھندو آھی، 25 سیڪنڊن تائین، ان جی ٽوڪن جی ڳڻپ حاصل ڪرڻ لاء، ۽ توہان ادا ڪیو ٿا جیڪو مہیا ڪندڙ رپورٽ ڪری ٿو
• پہرین حصی کان اڳ ہڪ غلطی، جہڙوڪ 401 یا 402، پنھنجی حالت ڪوڊ سان گڏ عام JSON طئور واپس اچی ٿو نہ تہ وہڪرو جی طئور تی۔ وہڪرو شروع ٿیڻ کان پوء ھڪ غلطی آخری طئور تی اچی ٿی data: {"error": {…}} واقعا، ۽ وہڪرو بغیر ختم ٿئی ٿو [DONE].
• اوزار سان گڏ درخواستون، ۽ ماڊل اوپنائی جی جوابن جی نقل و حمل تی، فراہم ڪندڙ کان وہڪرو نہ ڪندا آھن اہی اڃا تائین ہڪ صحیح وہڪرو سان جواب ڏیندا آھن، ہڪ ڀیرو جواب مڪمل ٿیڻ تی موڪلیو ویندو آھی

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، ۽ وری گفتگو موڪلیو۔ Nymbot ڪڏھن بہ توہان جی ڪمن کی نہ ھلائیندو آھی اھو ماڊل جی درخواست توہان ڏانہن واپس ڪری ٿو

tool_choice وٺی ٿو "auto", "none", "required" یا {"type": "function", "function": {"name": "…"}}ماڊل لسٽ نشان لڳائیندی آھی تہ ڪہڙا ماڊل اوزار کی ڪال ڪری سگہن ٿا (capabilities.tools) اوزار سان انڪار ڪیو ویندو آھی 400 unsupported_tool تی nymbot/auto ۽ ڪجھ فہرست ماڊلز تی جیڪی اوپنائی جی جوابن جی نقل و حمل تی ھلندا آھن، جن کی نیمبوٽ اوزار منتقل نٿو ڪری سگہی

هن سان "stream": true، هڪ وسيلن جي درخواست هڪ حصي ۾ ڪم ڪري ٿو ۽ اُن کانپوءِ هڪ معمولي حصي جي سلسلي طور موڪليو ويندو: رول، هڪ حصي هر وسيلن کي انڊز، ID، اسم ۽ معيارن ۽ ختم حصي سان ڪري ٿو.

جواب، جزوی طئور تی

"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, یو آر ایل۔ ہر درخواست تی 20 تصویرن تائین۔ SVG تصویرن کی رد ڪیو ویندو آھی ۽ اھڙی طرح 4, 096 اکرن کان مٿی جی لنڪ یا ان ۾ استعمال ڪندڙ نالی یا پاسورڊ سان (400 invalid_image_urlهڪ اختياري detail آھی auto, low یا high.

هن سان nymbot/autoھن ۾ ھڪ تصویر سان گڏ ھڪ درخواست کی ھڪ معیاری ماڊل ڏانہن موڪلیو ویندو آھی جیڪو ڏسی سگہی ٿو capabilities.vision تصویرن سان انڪار ڪیو 400 unsupported_contentتصویرن کی صرف استعمال ڪندڙ پیغام ۾ ٿی سگہی ٿو۔ ہڪ لنڪ کی عوامی میزبان ڏانہن اشارو ڪرڻ گھرجی ؛ Nymbot تصویر ماڊل جی فراہم ڪندڙ ڏانہن منتقل ڪری ٿو ۽ ان کی نٿو رکی

ہڪ تصویر کی چارج ڪیو ویندو آھی جیئن ان پٽ ٽوڪن مہیا ڪندڙ ان لاء شمار ڪری ٿو، باقی درخواست وانگر

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 جڏھن وہڪرو ڪیو ویندو آھی، جواب ۾ ڪڏھن بہ نہ ملایو ویندو آھی۔ استدلال آئوٽ آھی ۽ چارج ڪیو ویندو آھی جیئن، اندر 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);

نموني نموني

ماڊل جی نالی تی ھڪ لاحاصل تبدیل ڪری ٿو تہ درخواست ڪیئن ھینڊل ڪئی وئی آھی، بغیر ڪنھن فیلڊ جی اہی مڪمل IDs ۽ مختصر نالن تی ڪم ڪن ٿا، جیئن anthropic/claude-sonnet-5:online.

هر ٻيو ٻيهر نظر نه ايندي آهي. سڀني نامن کي اڳي تجربو ڪيو وڃي ٿو، پوءِ هڪ نموني جيڪو ان نموني ۾ اصل طور تي ڪولون شامل آهي ته به ڪم ڪري ٿو. اگر نه ڪيو وڃي ته، ٻيهر کي هڪ وقت تائين ختم ٿي وڃي ٿو جيستائين هڪ نموني گڏجي. 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);

ویب ڳولا

ڪو بہ چیٽ ماڊل لائیو ویب مان جواب ڏئی سگہی ٿو۔ نیمبوٽ آخری استعمال ڪندڙ پیغام (ان جی پہرین 2, 000 اکرن) جی ڳولا ڪری ٿو، بہترین صفحی کی پڙھندو آھی ۽ انھن کی ماڊل کی سوال سان ڏئی ٿو، نشان لڳل مواد ماڊل کی ہدایتون نہ وٺڻ گہرجن

• سدائین ڳولھیو: "plugins": [{"id": "web", "max_results": 5}]، یا ای :online ماڊل تی لاٿا
• ڳولھیو جڏھن اھو مدد ڪری ٿو: "tools": [{"type": "web_search", "parameters": {"max_results": 5}}]، جی روپ ۾ بہ قبول ڪیو ویو web_search_preview یا openrouter:web_searchNymbot صرف ان وقت ڳولیندو آھی جڏھن سوال ڏسڻ ۾ اچی ٿو تہ ان کی موجودہ معلومات جی ضرورت آھی سا ئی ٽیسٽ ایپ استعمال ڪری ٿی

max_results 5 کان 10 کان 10 کان 10 کان 10 کان 10 کان 10 کان 10 کان 10 کان 10 کان 10 کان 10 کان 10 کان 10 کان 10 کان 10 کان 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);

جواب ۾ API

اوپنآئی جو نئون فارمیٽ، اوپنآئی ایجنٽس SDK ۽ ڪوڊڪس پاران استعمال ڪیو ویندو آھی اھو ساڳیو ماڊل، بلنگ ۽ فیچرز تی ھلندو آھی جیئن چیٽ مڪمل

POST https://nymbot.ai/api/v1/responses - ھڪ API ڪنجی جی ضرورت آھی

جواب ڏیو

{
  "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);

antropological پيغام

اینٿروپڪ فارمیٽ، اینٿروپڪ SDKs ۽ ڪلائوڊ ڪوڊ لاء اھو فہرست ۾ ہر ماڊل سان ڪم ڪری ٿو، نہ رڳو ڪلائوڊ: درخواست ترجمو ڪئی وئی آھی، ساڳئی پائپ لائن ذریعی ہلائی، ۽ واپس ترجمو ڪیو ویو آھی

POST https://nymbot.ai/api/v1/messages - ھڪ API ڪنجی جی ضرورت آھی، جیئن x-api-key یا Authorization: Bearer.

دی-دی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی-ڊی - anthropic-version ۽ anthropic-beta ہیڊر قبول ڪیا ویا آھن ۽ نظر انداز ڪیا ویا آھن اینٿروپڪ ماڊل جا نالا فہرست سان ملن ٿا، تنہنڪری ڪلائوڊ ڪوڊ ۽ SDKs انھن نالن سان ڪم ڪن ٿا جیڪی اھی اڳ ۾ ئی استعمال ڪن ٿا

• ہڪ نالو فہرست ڄاڻی ٿو، جہڙوڪ 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_stopA. A ping ماڊل جی ڪم ڪرڻ جی دئوران ہر 15 سیڪنڊ ۾ بہ موڪلیو ویندو آھی۔ اوزار ڪال متن کان پوء ایندا آھن، ہر ھڪ جی طئور تی tool_use ھڪ ۾ پنھنجی سموری ان پٽ سان بلاڪ ڪریو input_json_delta.

اهو خطا هن Endpoint تي Anthropic جي فارم استعمال ڪري ٿو: {"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 توهان کي هڪ API Key ضروري آهي.

جسم جي طور تي برابر آهي. پيغام، بغیر 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);

نموني نموني

هر نموني ۽ جنوري API کي قبول ڪري ٿو، جيڪي ان جو خرچ ٿئي ٿو.

GET https://nymbot.ai/api/v1/models ڪابه ضرورت نه آهي. 5 منٽن تائين ڳولڻ.

GET /api/v1/models/{id} موٽڻ لاء هڪ داخل.

قیمتون آھن جیڪی توہان ادا ڪندا آہیو، فیس ۽ مارجن سان اڳ ۾ ئی، ڊالر ۾ ۽ موجودہ بٽڪوائن جی قیمت تی سیٽ ۾ balance اهو چوي ٿو ته نموني استعمال ڪري ٿو. nymbot_key ایپ ۾ ماڊل جو مختصر نالو آھی created اهو هميشه 0 آهي، جنهن ڪري ڪاليج ۾ هڪ نموني شامل نه ڪيو ويو آهي. per_request بدران.

nymbot/auto اهو سڀ کان اول آهي، جيڪو variableA سان گڏ 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 ان کان علاوه، ان جي قيمت 1 ڪلاڪن کان وڌيڪ آهي.

نشان لڳل قیمتون "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);