Maziko a chidziwitso / Opanga mapulogalamu

Makambirano, Mayankho ndi Mauthenga

Njira zitatu zofunsa chinthu kwa model, m'mafomati atatu omwe makasitomala amayankhula kale, zonse zikugwira ntchito pa model zomwezi ndipo zimalipiridwa m'njira imodzi.

Tsambali lamasuliridwa pamakina kuti zikhale zosavuta. Chingelezi choyambirira ndi chomwe chimagwira ntchito.

Kukwaniritsa kwa Zokambirana

Kamodzi ka macheza ka OpenAI, komanso kamodzi komwe zida iliyonse imathandiza kwambiri. Tumizani macheza omwe achitikapo ndipo landirani uthenga watsopano.

POST https://nymbot.ai/api/v1/chat/completions — akusowa API key.

Nokha model ndi messages zofunika. Parameter yosankha yomwe model yosankhidwa siyikuza imasidwa popanda kulengeza laphani, choncho request body imodzi imagwira ntchito pa mndandanda wa mndandanda wa ma model onse. Mndandanda wa model umapereka wa model iliyonse supported_parametersChinthu chimene chimakanidwa m'malo moti chisiye ndicho chilichonse chimene model ikalephera kuchita konse: zithunzi kwa model yomwe sitingathe kuona, zipangizo kwa model yomwe sitingathe kuzigwiritsa ntchito.

Yankho ndi wamba chat.completion, ndi mtengo mwa usage.cost (m’madala) ndipo m’ako nymbot chinthu. model kodi ndiye id ya model yothetsedwa, choncho dzina lachidule limabwera ngati dzina lonse. Ngati modelinayo inaganiza musanakayankhe, maganizo ake ali mu message.reasoning_content, osiyana ndi yankho.

Yankho

{
  "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 ndizochokera ku zomwe zabweranso, chifukwa opereka malipoti amachitcha mosiyana: tool_calls pamene model yapempha zida, length pamene yankho linagwiritsa ntchito malonda onse ololeredwa (kapena model inagwiritsa ntchito malonda onse pa kusinkhasinkha ndipo sinalembe yankho), content_filter pamene wopereka anakana, ndipo stop kapena usage.completion_tokens_details.reasoning_tokens ndimapali 0 nthawi zonse: chinsinsi ma token a nzeru amapimidwa, ndipo amalipiridwa, mu completion_tokens.

Makodi a mmene zinthu zilili omwe endpoint iliyonse imagawana ali m'munsimu zolakwika.

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

Kuwala mwachindunji

Ndi "stream": true yankho limabwera ngati server-sent events pamene model ikulemba it. Chinthu chilichonse cha event ndi a chat.completion.chunk pa a data: mfulu, ndipo ndondomeko imatha ndi data: [DONE]. Nzeru zimafika mu delta.reasoning_content, yankho mwa delta.content.

Tumikizani chilichonse chomwe chingatenga kuposa mayendedwe a ndime 100, monga yankho litali, chinthu chachikulu max_tokens kapena kafupukupuku (reasoning model). Pempho lomwe silitumizidwa mofika pang'onopang'ono (not streamed) silikutumiza chilichonse mpaka yankho latha, ndipo maulendo a intaneti pakati panu ndi Nymbot akhoza kutseka ul kone okwiya kwa ndondomeko ya masekondi 100; model ikupitiriza kumaliza komanso zomwe inayembetsa zimawonongeka m'malipiro, koma yankho limataya. Stream imatumiza zoyang'anira kukhala okonzeka (keep-alives), choncho imakhala yotseguka malinga ndi nthawi yomwe model ikulemba.

Kuyenda mwachangu

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]

• Mizere yoyambira ndi : ndipo mawu okhazikitsa keep-alive, amatumizidwa nthawi zonse pa masikondi 15 pamene model ikuganiza. Makasitomala a SSE amawaikawo.
• Funsa za "stream_options": {"include_usage": true} kuti mupeze gawo lomaliza lili pamwamba, ndithu lili lopanda choices, kuchuluka kwa token, mtengo ndi ndipo nymbot chinthu.
• Malipiro amalipiridwa kutsiriza kudzera m'ndondomeko yomaliza pomwe stream yatha. Ngati mutsimikiza kutseka ul связи mwachangu, model sizimati, Nymbot imawerenga tsala iliyonse ya stream ya provider, kwa nthawi yosapitirira masikondi 25, kuti ipeze chiwerengero cha token zake, ndipo mumalipira zomwe provider walengeza. Popanda chiwerengero chimenecho, malipiro amayang'anidwa pogwiritsa ntchito zomwe mwapereka komanso zomwe zinalembedwa, pamodzi ndi malipiro onse a output ya model yomwe imaganiza.
• Zolakwika musanatsirize gawo loyamba, monga 401 kapena 402, imabwerera ngati JSON yozama ndi kodi yake ya status, osati ngati stream. Zolakwika pambuyo poti stream yayamba zimabwera ngati yomaliza data: {"error": {…}} chochitika, ndipo mtsinje umatha popanda [DONE].
• Zopempha ndi zida, komanso ma model pa OpenAI's Responses transport, sizikutumiza uthenga pang'onopang'ono kuchokera kwa opereka. Amayankha ndi stream yoyenera, yomwe imatumizidwa pomwe yankho latha.

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

Kuitana kwa zida

Fotokozani ntchito mu tools ndipo model mutha kupempha kuti imodzi itchedwe m'malo moti iyankhe. Mumayendetsa function, muwonjezere zotsatira zake ngati tool uthenga ndi chomwecho tool_call_id, ndipo tumizani zokambirana zimenezo kachiwiri. Nymbot sikuyendetsa mafunsi anu; imapereka pempho la modelili kwa inu.

tool_choice amatora "auto", "none", "required" kapena {"type": "function", "function": {"name": "…"}}Mndandanda wa mamodeli akuwonetsa zomwe mamodeli akhoza kugwiritsa ntchito zida (capabilities.tools). Zida zikukanidwa ndi 400 unsupported_tool pali nymbot/auto ndipo pa ma model ochepa a catalog amene amagwira ntchito pa OpenAI's Responses transport, amene Nymbot sangathe kutumiza zida kwa iwo.

Ndi "stream": true, pemphoni lomwe lili ndi zida limayenda m'gawo limodzi ndipo kenako limatumizidwa ngati ndandanda ya mbali zochepa: udindo, mbali imodzi yomwe ili ndi mndandanda wa kuitana kwa chida chilichonse ndi index, id, dzina lake ndi zofunika, ndipo mbali yomaliza. Makasitomala omwe amadera kuitana kwa zida zomwe zikutumizidwa m'magawo amachichita monga mwa nthawi zonse.

Mayankho, mbali imodzi

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

Zithunzi m'pempho

Ma model ndi capabilities.vision tha nditha kuwerenga zithunzi. Onjezani anganu image_url gawo la uthenga wa wogwiritsa ntchito, ndi wogawana kapena wagawo la wogwiritsa ntchito, ndi wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito wagawo la wogwiritsa ntchito w https:// link kapena a data:image/…;base64, URL. Mpaka zithunzi 20 pa pempho lililonse. Zithunzi za SVG zikaididwa, ndipo msempha womwe uli ndi mipulumu kupitirira 4,096 characters kapena uli ndi dzina la munthu kapena password m'chikhalidwe chake (400 invalid_image_url). Kosankhidwa detail ili auto, low kapena high.

Ndi nymbot/auto, pempho lomwe lili ndi chithunzi limatumizidwa ku model ya dzina lakuti standard imene ithaona. Model ya catalog popanda capabilities.vision akana zithunzi ndi 400 unsupported_content. Zithunzi zitha kukhala m'mauthenga a ogwiritsa ntchito okha. Link inayake iyenera kupita ku host yozindikirika kwa aliyense; Nymbot amapereka chithunzi kwa opereka model ndipo sachisunga.

Chithunzi chimalipiridwa ngati ma input tokens omwe opereka amawaŵa chifukwa chake, monga njira zina za pempho limodzi.

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

Kuganiza

Ma model ndi capabilities.reasoning angathe kuganiza asanayankhe. Pemphani zambiri kapena zochepa za zimenezo ndi reasoning_effort ("minimal", "low", "medium" kapena "high") kapena "reasoning": {"effort": "high"}, kapena onjezani :thinking kwa dzina la model, lomwe limatanthauza khama lalikulu. Pa model yopanda reasoning kusinthako sikusamalidwa. Ndi nymbot/auto, :thinking imatumiza pempho ku njira ya standard ya kuganiza.

Pa ma model a Anthropic, khama limakhala bajeti yoganiza ya madata okwana 1,000, 2,000, 8,000 kapena 16,000 tokens, osati kwambiri kuposa max_tokens zolola. Maganizo amasiya wakati tool_choice amakamiza chida, ndipo pamene pempho likupitiriza kukhala m'dongosolo la zida (uthenga wake womaliza ndi zotsatira za chida), chifukwa Anthropic ikufunika kaganizidwe kofunika kowomberatu kakuoneka kale kuti ikupitirize. Chimodzimodzimo chimachitika pa mapulogalamu a Responses ndi Messages.

Kufotokozera kudzabwerera m'kati message.reasoning_content, kapena delta.reasoning_content pomwe mukukonza, musaphatikize mu yankho. Kusanalika ndiko kotsatira ndipo kumawonongedwa monga chomwe chilipo, mkati completion_tokens. Opereka ena sikutumiza ndemanga ya chifukwa chake n’komwe, komanso amachotsa ndalama.

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

Zikutuluka za model

Chidindikizo chomwe chili kumapeto kwa dzina la model chimasintha mmene pempholi limachitira ntchito, popanda kugwiritsa ntchito mbali ina. Zimayenda pa ma id monga amene ali onse komanso mayina achidule, monga kuti anthropic/claude-sonnet-5:online.

Zonse zina za kumapeto zanyozedwa. Dzina lonse limayesedwa kaye poyamba, choncho model yomwe id wakesi ili ndi colon ikugwira ntchito; ngati izi zikulephera, mapeto amachotsedwa m'mbali imodzi ndi imodzi mpaka pamene model yimene ikugwirizana ikapezeka. Dzina la model likhoza kukhala ndi alipo 200 characters ndi mapeto osati 4; imene ili yaitali imakanidwa ndi 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);

Kafukufuku wa pa web

Model iliyonse ya chat ikhoza kuyankha kuchokera pa webusayiti yomwe ili bwino. Nymbot imafufuza uthenga womalizira wa wogwiritsa ntchito (makarakter ake okwanira 2,000 oyambirira), imawerenga mabanja a webusayiti abwino ndipo amapereka kwa model limodzi ndi funso, zomwe zakhazikitsidwa ngati zinthu zakunja zomwe model isatenge malangizo kuchokera mwa izo. Pali njira ziwiri:

• Nthawi zonse fufuzani: "plugins": [{"id": "web", "max_results": 5}], kapena a :online mawu otsatira pa mndandanda.
• Fufuzani pamene kuli kothandiza: "tools": [{"type": "web_search", "parameters": {"max_results": 5}}], komanso zomvezedwa ngati web_search_preview kapena openrouter:web_search. Nymbot imafufuza pokhapokha pamene funso likuoneka kuti likufuna chidziwitso chachintsanje, mayeso omwe app imagwiritsira ntchito amodzi.

max_results ndimodzi ndi 5 ndipo kuchuluka kwake ndi 10. Magulu amabwerera mu nymbot.web_search.sources, aliyense ali ndi a title, snippet ndi url, ndipo monga url_citation mafungidwe pa uthenga.

Kusaka kumene kumayenda kulipiridwa ndalama zokwana $0.008, zosintha kukhala sats, pa tokens zina, ndipo ndi gawo la hold. Masamba amene adawerenga ndi input tokens ndipo, choncho yankho lochokera pa webusi limagula ndalama zambiri kuposa funso lenileni lofunsidwa popanda webusi, nthawi zina ndizambiri kwambiri.

Mayankho, mbali imodzi

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

Mayankho API

Njira yatsopano ya OpenAI, yomwe imagwiritsidwa ntchito ndi OpenAI Agents SDK komanso ndi Codex. Imathandizidwa ndi mamodeli omwe ali ngati Chat Completions, malipiro, komanso zinthu zina.

POST https://nymbot.ai/api/v1/responses — akusowa API key.

Yankho

{
  "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 }
}

Pemphero la chida laonekera mu output monga function_call chinthu ndi call_id, name ndi arguments; tumizani zotsatira m'njira ya a function_call_output chinthu chofanana nacho call_id. Kuganiza, pamene model imachipereka, ndi a reasoning chinthu ndi reasoning_text mfundo, yolembedwa koyamba. status ili incomplete pamene yankho linafika max_output_tokens kapena opereka anakana, ndi incomplete_details.reason samala ku max_output_tokens kapena content_filterMayankho amasonyezanso zofunika za pempholiro (temperature, tools, tool choice ndi zina zotero) monga momwe OpenAI imachitira, ndipo amadza ndi nymbot mtengo object.

Zofalitsidwa, chochitika chilichonse ndi event: mndandanda ndi i data: mndandanda ndi sequence_number, m uncontu umene uliwu: response.created, response.in_progress, response.output_item.added, response.content_part.added, chiwerengero chilichonse cha response.output_text.delta, response.output_text.done, response.content_part.done, response.output_item.done, ndipo pomaliza response.completed mwa kugwiritsa ntchito ndi mtengo. Mayankho omwe adasowa amathera ndi response.incomplete m'malo mwake, komanso kuphulika pambuyo poti stream inayamba ndi response.failed. Mizere ya kuganiza monga chinthu chake ndi response.reasoning_text.delta ndi .done. Kupanga ntchito kumabwera pambuyo pa uthenga, malinga ndi gawo lililonse ndi response.function_call_arguments.delta ndi .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);

Mawu a Anthropic

Njira ya Anthropic, ya Anthropic SDKs komanso Claude Code. Imagwira ntchito ndi muyanjamwe uliwonse wa ma model mu catalog, osati Claude yekha: pemphuyo limamasulidwa, limaperekedwa kudzera mu pipeline yomweyo, ndipo limamasulidwanso kubwerera.

POST https://nymbot.ai/api/v1/messages — akufunika API key, monga x-api-key kapena Authorization: Bearer.

The anthropic-version ndi anthropic-beta maheader amalandiridwa komanso kusamalidwa. Maina a mamodeli a Anthropic amagwirizana ndi katalogi, choncho Claude Code ndi ma SDK amagwira ntchito ndi maina omwe amagwiritsa ntchito kale:

• Dzina limene katalogi imadziwa, monga claude-sonnet-5 kapena anthropic/claude-opus-5, imagwiritsidwa ntchito monga ilili.
• Kapena tsiku (-20260514), -latest, chizindikiro cha version monga kuti -v1, chizindikiro cha m'mabungwe monga [1m] ndipo ndi anthropic/ kapena anthropic. ma prefix amachotsedwa, ndipo ma dot ndi ma dash m'ndetengoyo amayesedwa m'njira zonse ziwiri (claude-haiku-4-5 amapeza claude-haiku-4.5).
• Ngati zimenezo sizikugwirizana ndi chilichonse, banja (Opus, Sonnet kapena Haiku) limagwiritsidwa ntchito, malinga ngati wolemba mndandanda ali ndi vesioni yofanana kapena yatsopano kuposa imene yapemphedwa.
• Dzina limene silugwirizana ndi chilichonse limabwerera 404 not_found_error.

Yankho

{
  "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 itha kukhala ndiwo tool_use mabwalo ndi a thinking block, yemwe ali nawo signature ndilibe chilichonse. stop_reason ili end_turn, max_tokens, tool_use kapena refusal, thagwira ntchito m'njira imodzi ngati finish_reason pali Kukwaniritsa kwa Zokambirana; stop_sequence ili nthawi zonse null, ngakhale nthawi yomwe ndondomeko yomaliza inatsiriza yankho. input_tokens mawerengedwe zinthu zatsopano zokha; zinthu zosungidwa m'cache zili m'magawo awiri a cache. Mtengo uli mu nymbot chinthu ndi » X-Nymbot-Cost-Sats mutu.

Zochitika zomwe zagwiritsidwa ntchito pa stream ndi za Anthropic: message_start, content_block_start, ping, content_block_delta (text_delta, input_json_delta kapena thinking_delta), content_block_stop, message_delta ndi chifukwa chofika mapeto, kagwiritsidwe ntchito ndi ndiye nymbot chinthu chomwe chimapangidwa ndalama, ndipo message_stop. A ping izationso timatumidwa nthawi iliyonse ya masikondi 15 pamene model ikugwira ntchito. Zipempho za zida zimabwera pambuyo pa mawu, chimodzi ndi chimodzi monga tool_use lemba block ndi malinput ake onse m'modzi input_json_delta.

Zolakwika pa endpoint iyi zigwiritsa ntchito njira ya Anthropic: {"type": "error", "error": {"type": "not_found_error", "message": "…"}}. A mbali yochepa ndi 402 billing_error, opereka wozizira kwambiri 503 overloaded_errorKulephera pambuyo pop begunitsa stream kumatumizidwa ngati an error chochitika.

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

Kuwerengera ma token

Kuyerekeza kwa kuchuluka kwa input tokens zomwe pempho la Messages lingagwiritse ntchito, kuti wogwiritsa ntchito athe kuwona isanatumize. Ndi zaulere, koma ikufunika kiyi.

POST https://nymbot.ai/api/v1/messages/count_tokens — ikufunika API key. Ndiulere.

Thupi lili ngati la Mauthenga, popanda max_tokens; dzina la model liyenera kuzindikika. Kuchuluka kuli kulingalira: ma akaunti a system prompt, makalata, tool calls ndi zidziwitso za tool zidadwe kwa mana anayi, kuwonjezera 1,600 pa chithunzi chilichonse. Sikuti ndi tokenizer ya opereka mwachindunji, choncho kuchuluka kwenikweni kungasiyane. Kiyi yofika pamapeto ake ikhoza kupitirizabe kuigwiritsa ntchito.

Yankho

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

Kuwerenga mamodeli

Model ndi generator iliyonse yomwe API imalandira, pamodzi ndi mtengo wake. Mndandawu umawerengedwa kuchokera mu catalog yomwe ili yatsopano monga yomwe imagwiritsidwa ntchito mu app picker, choncho nthawi zonse ndizomwe seva idzagwire ntchito.

GET https://nymbot.ai/api/v1/models — palibe kiyi yofunika. Zasungidwa kwa mphindi zisanu.

GET /api/v1/models/{id} ikutulutsa chinthu chimodzi.

Mitengo ndi zomwe mumalipira, kukuphatikizapo mali ndi margin kale, m'madolala komanso m'sats pamtengo wa Bitcoin womwe ulipo panopa. balance imanu amati ndi ndalama ziti zomwe model ikugwiritsa ntchito. nymbot_key kodi dzina lachidule la modelili m'app. created limakhala 0 nthawi zonse, chifukwa katalogi siyolemba nthawi yomwe model inayikidwa. Model yopanda mitengo ya token yozindikira imalipiridwa per_request m'malo mwake.

nymbot/auto ndimachamba nthawi zonse, mtengo wake ndi variable, ndi routes ndandanda yopereka mitengo ya njira iliyonse ya muyeso. Imatchula masomphenya ndi nzeru zoganizira, koma osati zida.

GET /api/v1/models/{id} imalandira mayina komanso dzina lina lililonse ofanana ndi amene amapemphedwa, ndipo imabweretsa cholemba cha modelemu imene mayina amenewa amasonyeza.

Yankho

{
  "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"
    }
  ]
}

Mitundu ina:

• Chithunzi zolembedwa ali na capabilities (accepts_image_url, requires_image_url, edit) ndi mtengo per_generation.
• Vidiyo zolembedwa ali na max_duration_seconds ndi resolutions, ndipo mtengo per_second ndithu kwa resolução iliyonse.
• Phokoso zolembedwa ali na audio_type speech kapena transcription, mtengo wake uli per_1k_chars kapena per_minute.
• Kuphatikiza zolembedwa ali na dimensions, context_length, max_inputs ndipo mtengo wa ma tokeni a mamiliyoni awiri omwe amaperekedwa.

Mitengo yolembedwa "estimated": true ndi ndondomeko ya pulogalamu ya jenereta yomwe mtengo wake sanuphatikizidwa. Zosadziwika type Kubwerera 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);