ނޮލެޖް ބޭސް / ޑިވެލޮޕަރުން

ޗެޓް، ރަސްކާރީގެޖަވާބުތަކާއި މެސެޖުތައް

މޮޑެލަކަށް ކަންކަމެއް પૂछުމުގެ ތިން ގޮތެއް، ކްލައިންޓުން މިހާރުވެސް ބޭނުންކުރާ ތިން ފޯމެޓުންނާއި، އެ ހުރިހާ ކަމެއްވެސް އެއްވަރު މޮޑެލްތަކެއްގައި ހުއްޓާއި، އެކަންތައް އެއްވަރު ގޮތަކަށް ބިލުކުރެވޭނެއެވެ.

މި ޞަފްޙާއަކީ ފަސޭހަ ކަމުގެ ގޮތުން މެޝިނުން ތަރުޖަމާކޮށްފައިވާ ޞަފްޙާއެކެވެ. އިނގިރޭސި އޮރިޖިނަލް އަކީ އެއަށް އަމަލުކުރާ ވަރޝަން އެވެ.

ޗެޓް ކޮމްޕްލީޝަންސް

OpenAI ޗެޓް ފޯމެޓާއި، تقریباً ހުރިހާ އެޕްލިކޭޝަނެއްތަކުން އެއްބާރުލުން ދޭ ފޯމެޓެވެ. މިހާތަނަށް ކުރިދާރު ކުރި މަޝްވަރާ ފޮނުވާލުމުން، އަންނަން އޮތް މެސެޖް ހުރިހާ ގޮތަކުން ފޮނުވާލައިދޭނެއެވެ.

POST https://nymbot.ai/api/v1/chat/completions — އޭޕީއައި ކީއެއް (API key) ބޭނުންވެއެވެ.

އޮންލީ model އަދި messages އަޅުގަނޑުމެން ބޭނުންވަނީ. ސެމްޕްލިންގް ޕެރާމީޓަރެއް ބޭނުންކުރަން ނުކުރަން، އިޚްތިޔާރުކުރާ މޮޑެލްއިން އެ ޕެރާމީޓަރެއް ނުގަނެނަމުން އޮތްނަމަ އެއީ ކޮއެއްވެސް އޭރަރެއް ނޫނެވެ، އެހެންކަމުން އެއް ރިކުއެސްޓް ބޮޑީއެއް ބޭނުންކޮށްގެން ހުރިހާ މޮޑެލްތަކެއްގައި މަސައްކަތް ކުރެވިދާނެއެވެ. މޮޑެލް ລިސްޓުން ކޮ Each މޮޑެލްގެ supported_parametersދޫކޮށްލާނެ ކަމަކަށްވުރެ، ငြާސްކުރާނީ އެ މޮޑެލަށް އަސްލުވެސް ކުރެވިދާނެ ކަމެއް ނުވާ އެއްޗެހިތަކެވެ: ފެންނަން ނުލިބޭ މޮޑެލަކަށް ފޮޓޯ ދިނުމަކީ ނުވަތަ ބޭނުންކުރަން ނުލިބޭ މޮޑެލަކަށް ޓޫލްސް ދިނުމަކީ އެފަދަ ކަމެކެވެ.

ޖަވާބަކީ އާންމު ކަމެއްގެ ގޮތުގައި chat.completion، ހިނގާ ޚަރަދާ ގުޅިގެން usage.cost (ޑޮލަރުން) އަދި އެއީ nymbot އެއްޗެއް. model މިއީ ރިޒޯލްވުނު މޮޑެލް އައިޑީއެވެ، އޭގެ ސަބަބުން ކުރު ނަމެއްގެ બદలుగా ފުރިހަމަ ނަމެއް ލިބިގެންދެއެވެ. މޮޑެލް އިންނަންތެރޭގައި އަންނަން ކުރިން ފިކުރުކޮށްފައ 있다면، އޭގެ reasoned ވާހަކަތައް އެއީ 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 މިއީ ޕްRoVIDEDER ކުންފުނިތަކުން ތަފާތު ގޮތ들에 ބަހާލައި ރިޕޯޓްކުރާތީ، އަޔާ އައިސްވި މައުލޫމާތުންނަށް ބނަލައި ނެރުއްވާފައިވާ އެއްޗެކެވެ: tool_calls މޮޑެލް އިން ތޫލްސް (tools) އެދިއްޔަ، length ޖަވާބު ދިނުމަށް ބޭނުންކުރಬಹುದafހ ކޮންމެ ޓޯކަނެއްވެސް ބޭނުންކޮށްލާފައިވާ ހާލަތު (ނުވަތަ މޮޑަލް އިން ސާބިތުކުރުމަށް ހުރި ހުރި އެކަން ބޭނުންކޮށްލާފައި، އެއްވެސް ޖަވާބެއް ނުލިޔެފައިވާ ހާލަތު)، content_filter މަރުކަޒުން ငြާވަޅު އެކުceptކުރިއެއް ނުކުރިއެއް، އަދި stop ނޫ่นަމަ. usage.completion_tokens_details.reasoning_tokens އާންމުކޮށް 0: ފިލާވަޅުގައެވެ reasons tokens ଗުނާލަމެވެ، އަދި ފައިސާ ނުވަތަ ޚަރަދު ކުރަމެވެ، އޭގައި 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 މޮޑެލް އޭގައި ލިޔަަމުންދާއިރު، Jawāb ބޭނުންވަނީ server-sent events އަކުންނެވެ. ކޮ Each event އަކީ chat.completion.chunk އެއްޗެއްގެ މަތީގައި data: ލައިން، އަދި ސްޓްރީމް ނިމުމަކަށްp data: [DONE]reasoned reasoning arrives in delta.reasoning_content, Jawabu ah delta.content.

ތަފާތު އެއްޗެއް، އަކީ ދިގު ސުވާލެއް ނުވަތަ ބޮޑު އެއްޗެއް ފަދަ، 100 ސިކުންތަށްވުރެ ގިނަ ވަގުތު ނᱟގާނެ ކޮންމެ އެއްޗެއްވެސް ސްޓްރީމް ކުރޭށެވެ. max_tokens އިތުރުކޮށް ރީޒަނިންގ މޮޑެލެއް. ސްޓްރީމް ނުކުރެވޭ އެއްވެސް ރިކުއެސްޓަކަކުން، Jawāb އެ ފުރިހަމަވާދެން އެއްވެސް އެއްޗެއް ފޮނުވާނީ ނޫން، އަދި ކަލާޅުތަކާއި Nymbot އާ ދެމެދުގައިވާ ނެޓްވޯކަކީ އެއްވެސް މަސައްކަތެއް ނުވަތަ އައިޑްލް ކޮންނެކްޝަނެއް 100 ސިކުންތަފަހު ވަނީ ބަންދުވެފައެވެ; މޮޑެލަކީ އެކަން ނިންމާލާނެއެވެ އަދި އޭނާ ލިޔެފައިވާ ދެން އެކަން އެކައުންޓުން ކެޓޭނެ، ނަމަވެސް Jawāb އެp ބެލެވިފައިވާނެއެވެ. ސްޓްރީމަކީ ކީޕް-އައިލައިވްސް ފޮނުވާ އެއްޗެއް، އެހެންކަމުން މޮޑެލުން ލިޔަމުންދާ ހިނދާ ހަމައަކަށް އެ ކޮންނެކްޝަން ބެލެހެއްޓޭނެއެވެ.

ސްޓްރީމް

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 ސިކުންތަކ마다 keep-alive ކޮމަންޓްތައް ފޮނުވާނެއެވެ. SSE ކްލައިންޓްތަކުން އެ ކޮމަންޓްތައް ފުރިހަމައަށް ދޫކޮށްލާނެއެވެ.
• އެދިލުން "stream_options": {"include_usage": true} މަތީގައިވާ އެންމެ ފަހު ބައި ހޯދަން، খালী އޮތް choices, ޓޯކަން ކައުންޓްތައް، ހިދުމަތުގެ އަގު އަދި nymbot އެއްޗެއް.
• ސްޓްރީމް ނިމުނު ފަހު ކުލި ދައްކަންޖެހޭނެއެވެ. ކޮneކްޝަން ވަންތަނު ބާއްވާނަމަ، މޮޑަލް ނުހުއްޓޭނެއެވެ: Nymbot އިން ޕްރޮވައިޑަރގެ ސްޓްރީމްގެ ބާކީ parts، ގިނަވަތަކަށް 25 ސިކުންތަކާ ހަމައަށް ކިޔައި، ޓޯކަން ކައުންޓް ހުރަގެންނެރެއެވެ. އެއަށްފަހު ޕްރޮވައިޑަރު ރިޕޯޓުކުރާ މިން amounts ދައްކަންޖެހޭނެއެވެ. އެ ކައުންޓް ނުލިބިއްޖެނަމަ، ކުލި ދައްކަންޖެހޭނީ ތިބާ އޮތް އިންޕުޓް އާއި ލިޔެވިފައިވާ ކަންތައްތަކުގެ މައްޗަށް ބިނާކޮށް ކުރެވޭ ]އަސުމާންތަކުންނެވެ. އަދި reasoned model တစ်ခုގެ ފުރިހަމަ އައުޓްޕުޓް އެލަވަންސްވެސް އެއިން ހިމެނޭނެއެވެ.
• ފުރަތަމަ ބާކީގެ ކުރިން އަންނަ ކޮންމެ މައްސަލައެއް، އަކީ 401 ނުވަތަ 402, އޭގެ ސްޓޭޓަސް ކޯޑުތާ އެކު އާދައިގެ JSON އަކަށް ይመጣނީ، ސްޓްރީމެއްގެ ގޮތުގައި ނޫން. ސްޓްރީމް ފެށުމަށްފަހު އަންނަ މައްސަލައެއް އެންމެ ފަހަތުން އަންނާނީ data: {"error": {…}} ދިވެހިބަހުން ކިޔައިދޭ ކަމެއް، އަދި އެ މައުލޫމާތު ފޯރުކޮށްދޭ ވަގުތު ނިމިގެންދަނީ އެއްޗެއް ނެތި | [DONE].
• ޓޫލްތަކާއެކު ކުރާ ރިކުއެސްޓްތަކާއި، OpenAI ގެ Responses ޓްރާންސްޕޯޓްގައިވާ މޮޑެލްތަކުން، އެޕްރޮވައިޑަރުގެ ފަރާތުން ސްޓްރީމް ކުރެއްވުމެއް ނުކުރެއެވެ. އެކަމަކު، އެދޭނެތީ ފުރިހަމަވުމުން، ވަލިޑް ސްޓްރީމެއްގެ ގޮތުގައި އެކަން ފޮނުވާނެއެވެ.

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 އަދި މޮޑެލަށް އެއްޗެއް އަންގާލަން އެދޭނެ ގޮތުގެ މتبދިލަށް، އަމިއްލައަށް Jawāb ދިނުމުގެ ބަދަލުގައި އެކަން ކުރެވިދާނެއެވެ. ތ вас ފަންކްޝަން ރަންކޮށް، އޭގެ ނަތީޖާ އެއްޗެއްގެ ގޮތުގައި އި로ść ކުރެވިދާނެއެވެ. tool ތަᱡުމާ އެއްވަރު ކަމެއްގެ މެސެޖެއް tool_call_id, އަދި ކConversations އަލުން ފޮނުވާށެވެ. Nymbot ބޭނުންކުރާތީ ތިބާގެ functions ލުއިކުރާނީ ނޫން؛ އެއީ މޮޑެލްގެ ރިކުއެސްޓް ތިބާގެ ކައިރިއަށް އަލުން ފޮނުވާނެ ކަމެވެ.

tool_choice ގަނެވޭ "auto", "none", "required" ނުވަތަ {"type": "function", "function": {"name": "…"}}މޮޑެލް ލިސްޓުން ބަޔާންކުރެނީ ކޮން މޮޑެލްތަކުންތޯ _, tools (capabilities.tools). ވަސީލަތްތައް އޮތްގޮތުން އުއްކުންފާލުކުރެވިފައިވަނީ 400 unsupported_tool On nymbot/auto އަދި OpenAI ގެ Responses transport އުނިގަނޑު މަތީގައި ހުއްދަވާ ވަރަށް މަދު ކެޓަލޮގު މޮޑެލްތަކުގައި، Nymbot އަށް ތޫލްސް (tools) ފޯރުކޮށްދެވޭނެ ނުވާނެއެވެ.

އެކު "stream": true, ޓޫލްސް އެކު އެއް ރިކުއެސްޓަކީ އެއްކޮޅުގައުން ހުއްދަވެގެން އަންނަ ކަމެއް، އަދި އޭގެ ފަހު އޭގެ ސިފަގައު ކަށަވަރުކޮށްފައިވާ ނޯމަލް ޗަންކް ސީކުއަންސް އެކަހެން ފޮނުވާލުންނެވެ: ރޯލް، ހުރިހާ ޓޫލް ކޯލްތަކެއް އޭގެ އިންޑެކްސް، އައިޑީ، ނޭމް އަދި އާގިއުމަންޓްތަކާއެކު ހިމެނޭ އެއް ޗަންކެއް، އަދި ފިނިޝް ޗަންކެވެ. ސްޓްރީމްޑް ޓޫލް ކޯލްސް ކարդައިގަންނަ ކްލައިންޓުން އެކަން އާދައިގެ ގޮތުން ކުރިއަށް deしていきます.

ޖަވާބު، ބައެއްގޮތުން

"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, URL. އެކްސްޓްރެކްޝަން (request) އެއްތެރޭގައި 20 ވަる ފަދަ ފޮޓޯ ހި込ޭނެއެވެ. SVG ފޮޓޯތައް مرفޫޟުކުރެވޭނެއެވެ، އަދި 4,096 އަށްވުރެ ބޮޑު ލިންކެއް ނުވަތަ ޔޫޒަރ ނޭމެއް ނުވަތަ ޕާސްވޯޑެއް ހިމެނޭ ލިންކެއްވެސް مرفޫޟުކުރެވޭނެއެވެ (400 invalid_image_url). އިޚްތިޔާރީ ކަމެއް detail ތަޅުއެޅުން/ވެގެންދިއުން auto, low ނުވަތަ high.

އެކު nymbot/auto، ފޮޓޯ އެއް ހިމެނޭ ރިކުއެސްޓެއް، 볼ނެ่ނެ އަދި މިންތާނުކުރެވޭ ކަހަލަ މިންގަނޑު މޮޑެލަކަށް ފޮނުވާލެވޭނެއެވެ. ކޮންމެއަކީވެސް ފޮޓޯ ނުފެނޭ ކެޓަލޮގް މޮޑެލެއް ނެތް capabilities.vision ފޮޓޯ އުއްމީދެއް ނުދޭ 400 unsupported_contentފޮޓޯތައް ބެހެވިދާނީ ޔޫޒަރގެ މެސެޖްތަކުގައި އެކަނިކަންނެވެ. ލިންކެއް އޮންނަންޖެހީ ފަންޑަމަންޓަލީ ޕަބްލިކް ހޯސްޓެއްތަކަށްވާ</em>ނަމަވެސް؛ 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 ސްޓޭންޑާޑް ރޭޒަނިންގ ރޫޓަށް މަގުއ로ލައިގެން ރިކުއެސްޓް ފޮނުވައިދޭއ로.

Anthropic މޮޑެލްތަކުގައި، ބޭނުންވާ މަސައްކަތަކީ ކިނަވަރު de 1,000, 2,000, 8,000 ނުވަތަ 16,000 ޓޯކަންތަކުގެ "thinking budget" އެއް، އެއީ އެއަށްވުރެ ބޮޑުވެގެން ނުވާނެ ކަމެވެ. max_tokens އިޖާޒަތްދޭއ로. ހިތާލުކުރުން ހުއްޓަނީ ކޮންތަނަކުގައか tool_choice ޓޫލެއް ބޭނުންކުރަން މަޖ்பޫރުކުރެއެވެ، އަދި ރިކުއެސްޓް އޭގެފަދައިން ޓޫލް ލޫޕެއް (އޭގެ އެންމެ ފަހުންވާ މެސެޖަކީ ޓޫލް ރިޒަލްޓަކީ) ކުރިއަށް ގެންދިޔުމުން، އެކަން އެހެންވަރު ކުރަންޖެހޭނީ Anthropic އަށް ކުރިން ސައިންކުރެވިފައިވާ ތިނކިންގ (thinking) އަލުން ފެށުމަށް ބޭނުންވާތީއެވެ. އެދެން ފަދައިން ރިސްޕޮންސES އަދި މެސެޖES އެންޑްޕޮއިންޓްތަކުގައިވެސް ކުރަންޖެހޭނެއެވެ.

reasoned reasoning އަންނަނީ އަލުން ފެށިފައެވެ 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);

މޮޑެލް ސަފިކްސަES

މޮޑެލް ނަމުގައި ކުރާ ސަފިކްސެއްގެ ބަދަލަކުން، އެހެން ފީލްޑެއް ނުބޭނުންވ 없이 ރިކުއެސްޓް ހެންދެނޑި ގޮތަށް ބަދަލުވެއެވެ. އެ They ފުލް އައިޑީސް އަދި ޝޯޓް ނޭމްސް ދެމެދުގައި އެކަހެރެއެވެ، މިގޮތުން anthropic/claude-sonnet-5:online.

އިތުރު ސަފިކްސެއް ބަލައިގަނެ่އ로 ނުވާނެ. އެންމެ ފުރަތަމަ ފުރިހަމަ ނަމަ ބަލާނެ، އެހެންކަމުން އައިޑީގައި ކޮލަން (:) ހިމެނޭ މޮޑެލެއްވެސް މަސައްކަތް ކުރާނެ؛ އެކަމަކަމުން އެކަމެއް ނުވީނަމަ، މޮޑެލެއް ފާޅުވާންދެން ނަމުގެ ނި endings އިން އެކަކުނަކު ސަފިކްސުތައް ކެނޑުމަށް މަސައްކަތް ކުރާނެ. މޮޑެލެއްގެ ނަމަކީ އެންމެ ގިނަވެގެން 200 އަކރީކްter އާއި، އެންމެ ގިނަވެގެން 4 ސަފިކްސު ހިމެނޭނެ؛ އޭs de ލ longue ނަމެއް ހިމެނޭނަމަ އެކަމަކީ އަންނަ ސަބަބުން މեր로ކުވައިލެވޭނެ: 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);

ވެބް ސަރޗް

ކޮންމެ ޗެޓް މޮޑެލަކަށްވެސް އާލަމްތަކުން (live web) ޖަވާބުދެވޭނެއެވެ. ނިމްބޮޓް (Nymbot) އިން ކުރާނީ އެންމެ ފަހުން ފޮނުވި ޔޫޒަރުގެ މެސެޖް (މީގައި ފުރަތަމަ ކެރެކްޓަރ 2,000) ހޯދުމެވެ. އެއިން އެންމެ ފާޑު އެއްޗެހި ކިޔަވައި، އެ މައުލޫމާތު ސުވާލު ކުރި މޮޑެލަށް ފޮނުވާނީ އެ ސުވާލުތަކާއެކުގައެވެ. މިއީ މޮޑެލަށް އަމުރުات (instructions) އުފާ ނުކުރަންޖެހޭ ބޭރުގެ މައުލޫމާތެއްގެ ގޮތުގައި ބޭނުންކުރާނެއެވެ. ދެގޮތުގެ މޯޑުތަކެއް އެވެ:

• އެއްވެސް ފަހި ނުކޮށް ހޯދާލައްވާ: "plugins": [{"id": "web", "max_results": 5}], އަދި އޭ :online މޮޑެލްގެ ފަހަތުގައިވާ ސަފިކްސް
• ބޭނުންވާ ވަގުތު ހޯދާލައްވާ: "tools": [{"type": "web_search", "parameters": {"max_results": 5}}], އަދި ...ގެ ގޮތުގައިވެސް ބަލައިގަނެއެވެ web_search_preview ނުވަތަ openrouter:web_search. Nymbot searched ކުރާނީ ސުވާލަކީ މިހާރުގެ މަޢުލޫމާތު ބޭނުންވާ ކަމެއް ފެންނަނީ ހަމައެކަނި ކަމަށެވެ، އެއީ އެޕްލިކޭޝަން އޭގައި ބޭނުންކުރާ އުސޫލު އެއްޗެހި ކަމަށެވެ.

max_results ބައިލޯޑް ކުރާ އަދަދު އާންމުކޮށް 5 ކަމަށް ކަނޑައަ로ފައިވާނަމަ، އެއީ ގިނަވެގެން 10 އެވެ. މައުލޫމާތުތައް ފެންނާނީ nymbot.web_search.sources, އަދި ކޮންމެއަކުވެސް އޭގެ title, snippet އަދި url, އަދި އޭގެހަމަ އެވެ url_citation މެސެޖްގެ މައްޗަށް ކުރާ 注釈 (annotations)

ކޮންމެ ހޯދުމަކީ ޓޯކަންތަކުގެ އިތުރުން، ސެޓްތަކަށް ބަދަލުކުރެވޭ ފަދަ 0.008 ޑޮލަރުގެ ޚަރަދެއް ކުރަންޖެހޭ ކަމެއް ކަމަށާއި، މިއީ ހޯލްޑްގެ ބައިވެރިއެއްވެސް އެވެ. އޭގައި ކިޔާފައިވާ ފަޔިލްތަކަކީވެސް އިންޕުޓް ޓޯކަންތަކެވެ. އެހެންކަމުން، އިންޓަނެޓުން ލިބޭނެ ޖަވާބަކީ އެދާނެ ސުވާލެއް އާންމުކޮށް އަހާލުމުގެ ކިރިތަކަށްވުރެ ގިނަ ޚަރަދެއް ކުރަންޖެހޭ ކަމެކެވެ، ބައެއް ފަހަރު އެއީ އޭގެ ބազմަގަޑި ފަދައެކެވެ.

ޖަވާބު، ބައެއްގޮތުން

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

ރެސްޕޮންސES API

OpenAI އިން އައުކޮށް ތައާރޫފުކޮށްފައިވާ ފޯމެޓް، މިއީ OpenAI Agents SDK އަދި Codex އިން ބޭނުންކުރާ ފޯމެޓެކެވެ. މިއީ Chat Completions އާ އެއްވަ로 މޮޑެލްތަކުން، ބިލިންގުން އަދި ފީޗަރތަކުން ހިނގާ ފޯމެޓެކެވެ.

POST https://nymbot.ai/api/v1/responses — އޭޕީއައި ކީއެއް (API key) ބޭނުންވެއެވެ.

ޖަވާބު

{
  "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; ނަތީޖާ 'a' އަކީ ފޮނުވާލާށެވެ function_call_output ތަދީލް ކުރެވިފައިވާ އެއްވަރުގެ މުދާ call_id. reasoned, އެކަން މޮޑަލުން އެނގޭނަމަ، އެއީ reasoning ތަކެތި އާއެކު reasoning_text މާވަސް، ފުރަތަމަ ފާހަގަކޮށްފައިވާ. status ތަޅުއެޅުން/ވެގެންދިއުން incomplete ޖަވާބު އެކުއްތައިގެން އައިރު max_output_tokens ނުވަތަ ފަރާތުން ငြ拒绝ކުރިއެވެ، އޭގެހިނދެކު incomplete_details.reason ސެޓް ކުރައްވާ max_output_tokens ނުވަތަ content_filterޖަވާބުން ރިކުއެސްޓްގެ ސެޓިންގްސް (temperature, tools, tool choice އަދި އެހެނިހެން) އެކަން އޮޕަން އެއައިގެ ފަދައިން ދައްކައިދޭނެއެވެ، އަދި އޭގައި ހިމެނެނީ nymbot ޚަރަދު ތަކެތި.

ސްޓްރީމް ކުރެވިފައި، ކޮންމެ އީވެންޓަކީ އެއް... event: ލައިނާއި އޭ data: a އޮތް ރީނު 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 ބޭނުންކުރުމާއި ހިނގާޚަރަčުތަކާއެކު. ކޮޅު ކުޑަވެފައިވާ Jawābެއް ނިމުނީ response.incomplete ދަsވެ، އަދި ސްޓްރީމް ފެށުމަށްފަހު ފެއިލްވުން response.failed. ރިޒަނިންގް ސްޓްރީމްސް އަކީ ވަކި މުވާދެއްގެ ގޮތުގައި އެއީ response.reasoning_text.delta އަދި .done. Tool calls މެސެޖްގެ ފަހުން އަންނަނީ، މެސެޖެއްގެ ކޮންމެ އައިޓަމެއްގެ ގޮތުގައި އެކި ކަންފ embodies 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);

އެންތްރޮޕިކް މެސެޖުތައް

އެންތްރޮޕިކްގެ ފޯމެޓް، އެންތްރޮޕިކް SDKs އަދި Claude Code އަށްޓަކައެވެ. މިއީ ކްލޯޑްއަށް ނޫން، ކެޓަލޮގްގައިވާ ކޮންމެ މޮޑެލަކާވެސް މަސައްކަތް ކުރಬަける ފޯމެޓެކެވެ: ރިކުއެސްޓް ތަރުޖަމާކުރެވޭ، އެއްވަރު ހަމަ ޕައިޕްލައިނެއްގެ މެދުވެރިކޮށް ހިންގާލައި، އަދި އަލުން ތަރުޖަމާކުރެވޭނެއެވެ.

POST https://nymbot.ai/api/v1/messages — އޭޕީއައި ކީއެއް (API key) ބޭނުންވެއެވެ، އޭގެ ސަބަބުން x-api-key ނުވަތަ Authorization: Bearer.

އެ anthropic-version އަދި anthropic-beta ހެޑަރ⁨ްތައް އެކceptކުރެވޭނެއާއި އަދި އެކަން އިงނޯރ ކުރެވޭނެއެވެ. Anthropic މޮޑެލް ނަންތައް ކެޓަލޮގްތަކާ އެއްގޮތަށް ދެނެގަނެވޭނެއެވެ، އެހެންކަމުން Claude Code އާއި SDKތައް މިހާރު ބޭނުންކުރަމުންދާ ނަންތަކާއެކު މަސައްކަތް ކުރެވޭނެއެވެ:

• ކަޓަލްގުގައި އެނގޭ ކަމެއްގެ ނަމެއް، މިސާލަކަށް claude-sonnet-5 ނުވަތަ anthropic/claude-opus-5، އެއީ އެހެންގޮތަކަށް ބަދަލުނުކޮށް ބޭނުންކުރާ އެއްޗެކެވެ.
• ނޫންނަމަ ތާރީޚެއް (-20260514), -latest, އޭހާ ކަހަލަ ވަންޝަން ޓެގެއްގައި -v1, ބްރެކެޓް ކުރެވިފައިވާ ޓެގް އެއް ފަދަ [1m] އަދި އެކަން anthropic/ ނުވަތަ anthropic. ޕްރިފިކްސް ވަކިކުރެއެވެ، އަދި ފ的版本ގައިވާ ޑޮޓްތަކާއި ޑޭޝްތައް ދެގޮތުންވެސް ފަހުލުވަތަކަށް ބަލާލުން ކުރެއެވެ (claude-haiku-4-5 ފަންދާތައް claude-haiku-4.5).
• އެހެންނަމަވެސް އެއީ އެއްވެސް އެއްޗަކާ އެއްވެސް ނުގުޅޭނަމަ، ކަޓަލްގޭގެ ވަރުޝަން އެއް ނުވަތަ އެއަށްވުރެ އާ ވަރުޝަނެއް ހުރިހާ ހިނދަކު، އެ އާއިލާ (Opus, Sonnet ނުވަތަ Haiku) ބޭނުންކުރެވޭނެއެވެ.
• އެއްޗަކައޭ އެއްވެސް އެއްޗަކާ ހިލާކުނު އެއްވެސް ނަމެއް ރީޓަރންކުވޭ 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 Hold ކުރެވޭނެއެވެ tool_use ބްލޮކްތަކާއި އެއް thinking ބްލޮކް، ކޮބާވެތަ signature খালী. stop_reason ތަޅުއެޅުން/ވެގެންދިއުން end_turn, max_tokens, tool_use ނުވަތަ refusal, އަދި އެއްވަ로 ނުކުމެފައިވާ finish_reason On ޗެޓް ކޮމްޕްލީޝަންސް; stop_sequence އެންމެންވެސް އަބަދުވެސް އެއްޗެވެ null، އަދި މުއްސިދާ ސީކުއަންސް އެއް ނިމުނުއި에도، އޭގެ ޖަވާބު ނިމުނުއި에도. input_tokens ކައުންޓްސް ފ്രެsh އިންޕުޓް އެކަނި؛ ކޭsh ކުރެވިފައިވާ އިންޕުޓް ބެހެއްޓެހޭ ކޭsh ފީލްޑްތަކުގައި އެcl 있습니다. މާލުވަނީ nymbot ތަކ X-Nymbot-Cost-Sats ހެޑަރ deceptively.

ސްޓްރީމްކުރެވުނު، އެވިންޓްތައް އެންތްރޮޕިކްގެއީ: message_start, content_block_start, ping, content_block_delta (text_delta, input_json_delta ނުވަތަ thinking_delta), content_block_stop, message_delta ހުއްޓުނު ސަބަބާއާއެކު، ބޭނުންކުރި މިން amounts އަދި އެ nymbot ޚަރަދު މަގު, އަދި message_stop. އޭ ping މޮޑެލް މަސައްކަތް ކުރަމުންދާއިރު ކޮން 15 ސިކުންތަކ마다ވެސް ފޮނުވනු ලැබේ. ޓޫލް ކޯލްތަކަކީ ޓެކްސްޓްގެ ފަހު، ކޮންމެކendish އަކީ... tool_use އޭގެp ފުރިހަމަ އިންޕުޓާއެކު ބްލޮކް ކުރެވިއްޖެ 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);

ޓޯކަންތައް ގު计数ކުރުން

މެސެޖެއް ފޮނުވުމަށް ބޭނުންވާ އިންޕުޓް ޓޯކަންތަކުގެ އަދަދު ވަގުތީގޮތުން ހުރަފަތް ކަނޑައެޅުމަށް، އެކަން ފޮނުވުމުގެ ކުރިން ކްލައިންޓަށް ބަލައިލެވޭނެއެވެ. މިއީ ފައިސާ ދެއްކުމުގެ ބޭނުމެއް ނެތް ކަމުގައިも، މީގެ world ބޭނުންކުރުމަށް ކީ (key) އެއް ބޭނުންވެއެވެ.

POST https://nymbot.ai/api/v1/messages/count_tokens — އޭޕީއައި ކީ (API key) އެކްސެސް ކުރަން ބޭނުންވެއެވެ. ފްރީ.

ބަދަ އެދެކު އޮތް ފަދައިން އެއްވަރުވެއެވެ މެސެޖުތައް, ނުވަތަ ބައިނުވެގެން max_tokens; މޮޑެލްގެ ނަމަކުން އެނގޭނެއެވެ. އަދަ 수는 ކިތެއްވަ de ހެދޭނެކަން ވަގުތީގަ ތަހުލީލުކޮށްފައިވާ ކަމެކެވެ: ސިސްޓަމް ޕްރޮމްޕްޓް، މެސެޖްތައް، ޓޫލް ކޯލްތަކާއި ޓޫލް ޑެފިނިޝަންތަކުގެ ކެރެކްޓަރbr ތަކުގެ އަދަދަށް ހަތެއްބައިކޮށް، އޭގެނަށްފަހު ކޮ Each ފޮޓޯއަކަށް 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);

މޮޑެލްތައް ރިސްޓް ކުރަން

އޭޕީއައި އިން ގ୍ରަހުގަންނަ ކޮންމެ މޮޑެލް އަކާއި ޖެނަރޭޓަރަކާއި، އެއިންかかる ޚަރަދާ އެކުވެގެން. މި ލިސްޓް ކարդައިގަންނަނީ އެޕްގެ ޕިކަރާ (picker) އެއްވަރުގެ އަލި ދައްކާ ކަޓަލޮގުންނެވެ، އެހެންކަމުން މިއީ އަބަދުވެސް ސާރވަްރުން ރަންކުރާ އެއްޗެވެ.

GET https://nymbot.ai/api/v1/models — ކީއެއް ނުބޭނުން. ފަހެއް މINUTE އަށް ކެshް ކުރެވިފައި.

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 ގ Each ރެޒޮލިއުޝަނަށް.
• އޯޑިއޯ އެންޓްރީތަކަށް ... އެބަހުއްޓެވެ 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);