Yachaypa sapin / Qhapaq ñan kamachikuqkunas

Rimaykuna, kutichikuykuna ima willaykuna pas)

Huk tapuyta huk modeloqa hukmantaqa kinsa ñanwanmi tapuykunayki, chay kinsan ruraykunapi ruraq runakuna rimayninpi, chaymi huklla modelokunawanmi llamkan, chaymantapas hukllapi mikhun.

Kay p'anqaqa makinawan tikrasqa kachkan, allin kananpaq. Inglés simipi original nisqataqmi chaypaq hina.

Chaykunata Tukuy

OpenAI chat ruraynin, hinaspa casi imaymana hampina llaqtakunapas chayta ruran. Kunan kaq rimanakuyta apachiy hinaspa sut'in rimanakuyta kutichiy.

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

Allinllapaqmi model chaymanta messages kaykunam kanchik. Llamasqanchik rurayqa mana apisqan paramétruqa mana error nispa qichusqa kachkan, chayraykunmi huk request bodyqa imaymana ruraykunapi llamkan. Ruraykunapa listanqa ruray pachakunapa... qon. supported_parameters. Imaqmi qisqayachisqa kanman qisqayachiy ñanqaypa imaymana, chayqa modeloqa imaynan mana rurachu chayta: rikuyta mana yachaq modeloqa rikuna t’aqasqankunata, kachayta mana yachaq modeloqa rurana kaqkunata.

Qelpankunaqa manañam sumaqchu kanchu chat.completion, hampaq qullqiyuq kachkaspa usage.cost (dólarespi) hinaspa... nymbot imaymana ruraq. model tukuy pachapallan model nisqanmi, chaymi sapaq sutinpaqqa tukuy sutinmi kutimun. Munayninmi tapuypaqtaqa yuyayninmi, yuyayninmi kachkan message.reasoning_content, kutichiy de sut'ichasqamanta.

Tarpuy

{
  "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 kaymantam rurasqa kachkanmi lluqsimuqmantam, imayna rurakuyninkunataq allinpas mana yanapasqallanmi willakuyninkunapim: tool_calls modeloqa llamkapakunata mañakuqtin, length chay chakunpi qillqasqaqa permitidu llapan qillqaykunata usuchisqanmanta (ñaqqa llank'aqqa yuyaykunata rurachispa llapanta usuchisqa, manañam qillqasqachu), content_filter qhaliypaqqa mana munarqanchu, hinaspa stop mana chayrayku. usage.completion_tokens_details.reasoning_tokens pachaqaq 0mi: pakasqa yupaychay tukuy qelqaykunami, chaymantataq qarqaykun completion_tokens.

Imaymana endpointkunaq status koodnikunapas kaypi qillqasqa kashan qaqaykuna.

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

Yaku kawsayta kanchayninchi

wanan "stream": true llamkaypi kaqtaqmi kutichiyqa server-sent events hina chayamun modeloqa qillqaspanpas. Kunan kutiyqa qayka... chat.completion.chunk hukpi data: hinataq, chayqa pukllaymi tukun data: [DONE]Yuyaymi chay chayamun delta.reasoning_content, kutichiyqa delta.content.

Imapasapasmi 100 sicha nisqapi watayuq chayqa, hinaspa hatun kutichiy nisqaykunapas, qallarin kachun. max_tokens jukachataq yachay wasita. Mana kachaq nishqaqa manan imatapas qun suyakuspan tukuyta qelqaspanpas, chaymanta qanpaqtaq Nymbotpa kaqninpiqa chaki kaq pachaqa iskay pachak chunka ikaq ñawpaqtaqa tukukun; chaypiqa yachay wasicha tukusun, qelqasqanpas kutichin, ichaqa tukuy qelqaqa unqun. Kachaq nishqaqa kachayta qun, chaymi tukuy qelqaspa hasta qhepakun.

Mayu

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]

• Qallariqnin ñan kawsaykun ✍️ : keep-alive rimaykuna, pisi chunka pichqa segundo pachapi kachkan modelo yachaytañan kaqtin. SSE nisqapi ruranaqkunaqa qatichinku.
• Tapuy rqay "stream_options": {"include_usage": true} ñawpaq t'aqasqaqa, huch'uy chaypi kaqwan choices, token llimp'iykuna, allichaywan hinaspa nymbot imaymana ruraq.
• Pukllay tukuytaq chaskin. Sichus huk chaskikuyta sut'inllata takirqanki, chay modeloqa manan sayachisqachu: Nymbotqa yachay wasi nisqapa pukllayninta qhepata ñawinchin, iskay chunka phisqa pachak chunka ikimantapas, token suyunta riqsispa, chaymantataq yachay wasi nisqapa nishqanta chalan. Chay suyupay mana riqsispaqa, qanpa rimaynikitapas, qillqasqapis, chaymantaqa yuyayniyuq modelo nisqapa qhepakuy nisqantapasmi chalan.
• Huk yuyay pichqa ñawpaq chunk-paqtaq, hinataqtaq 401 dois 402, chayqa kutimun chikllay JSON hina status code-ninwan, manam stream hinaqa manam. Stream nispa qallarin tapunpas huk yaku tukuypaqtaqa chayqa chayqa sut'inmi apamun data: {"error": {…}} tukuypaq, chaymanta pacha ukhun chaymanta tukun</p> [DONE].
• Rimaykuna imaymana herramientaswan, hinaspa OpenAI-pa Responses transportninpi kawsaq unaykunawan, mana qallariychu kachkan llamkayninpi. Paykunaqa allin kachkan kawsaywanmi kutichinku, chayqa kutichisqan tapusay tukuchasqa kaspanmi.

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

Imawanllamllamkaykuna

Rimay kaykunata qillqay tools hinallataq modeloqa kutichispaq imaymanaqa qhichayta mañayta atin, chaymantataqmi rurayta purichinki, chaymantapas kutichiytami qunkanki tool hukchaymi kachkan tool_call_id, hinataq rimanakuyta kutimanta apachiy. Nymbotqa imaymana funktionaykikunatachu rurachin; payqa modelo nisqan munayta qampaq kutimanta apachin.

tool_choice qallarichin "auto", "none", "required" dois {"type": "function", "function": {"name": "…"}}. Modelo listaqa riqsinmi mayq modelokunaqa herramientasta usuchinkun (capabilities.tools) Llank'ayninakuna rechazakun wan 400 unsupported_tool Patapi nymbot/auto hinallataq OpenAI-pa Responses transport-ninpi puriq chay aswan ch'aska katalog modeli-kunapi, chaypi Nymbotqa hampiqkunata (tools) manan apachiyta atikunchu.

wanan "stream": true, huk sunqupi purichasqa hinallataq kachkan yanapakuykunawan, chaymantataq rurayta pacha kachkan: huk ruray, huk pachamimi llapan yanapakuyta apasqa kachkan huk index, id, sutinwan, ima imaymanapas chaywan, hinaspa tukuy pacha. Chay yanapakuykunata qelqasqata ñawlinqakuqkunaka manan allin kanchu chayta hinallataq ruran.

Huk waraqpi tarpuy

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

Mañakuypi rikuchikuna

Modelo kankuna chaywan capabilities.vision llamkay riqsimantami. Añunkuyta añadiy image_url musuq rimaypa huk p’unchay, huk hap’i kawsaywan o chaymanta... https:// Link imataq data:image/…;base64, URL. Tukuy 20 rikchay hina kachun huk sut'iypi. SVG rikchaykunata qa manam allinchu, chayllam 4,096 ch'aska rikchay nisqata huk link ima, chaymanta imaymana sut'i kaqta o imaymana hampinaqta kaqta kachkasqanpas (400 invalid_image_url). Huk munasqallay detail kaymi auto, low dois high.

wanan nymbot/auto, rikuywan rimayta munayninpi, qillqasqa kaqmanmi kutichikun, chaymi rikuyta atin. Mana qillqasqawan kanchaqa... capabilities.vision llantayta mana munanchu kunan ukhupi 🖼️ 400 unsupported_content. Rikuchikunaqa użytkari masi pachallam kachkan. Huk linkqa k'anchariq wasipi kachkan; Nymbotqa rikichiyta modelpa quqninman apan hinallataq manam qhichuykachun.

Rikchayqa, pampayniyuqmi imayna rimaykunawan (tokens) pagachikun, imaynatas rimasqanchis hina.

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

Yuyaypaq riqsisqa

Modelo kankuna chaywan capabilities.reasoning taqta kutichiytaqtaqa yuyayniyuq kanku. Ashwan otaq manan aswan chayta mañakuyku with reasoning_effort ("minimal", "low", "medium" dois "high") chayqa "reasoning": {"effort": "high"}, ichari añaychiy :thinking modelo sutinman, chayqa hatun llank'ayninmi ninchik. Yachay mana añayman ruray mananchispiqa, chay sapaq kayta manan allinchu. Wañuyllapi nymbot/auto, :thinking kay reqisiyñinta paqarichisqa yuyay ñanmanta purichin.

Anthropic yupaykunapi, llank'ayqa 1,000, 2,000, 8,000 icha 16,000 token kaq yuyay ruray (thinking budget) nisqamanta hamun, manan aswanchu max_tokens haykuy. yuyay saqikusqa kaqtin tool_choice hinmanta llamkanchik, chaymantataq hamp'ina k'asqapiqa (ñawpaqninpaq rimayninqa llamkana hamp'ina nisqanmi) kashan, manan Anthropicqa ñawpaqta qillqasqa yuyayninpaqmi hinataq kutimunan allin kanman. Hina munanapaqmi Responses nisqapiwan Messages nisqapiwan.

Yuyay kutimun message.reasoning_content, imaymana delta.reasoning_content hayk'asqa kashaspa, kutimuypi mana t'ikray, yuyayninqa qelqasqa kachkanmi, chaymanta chaymantam qarq'arin, aswanpi completion_tokens. Huk cungaykunaqa manan qillqasqa yachayta quykunchu, chaymantaq qullqi chaskichinku.

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

Model t'ikrasqaqkunam

Model sutichasqanmi imaymana k'anchaykunata lliw kutichin, huk wata nisqata mana añañiyta. Huk qallariypas, hinaspa huch'uy sutikunapasmi llamkan, hinataq: anthropic/claude-sonnet-5:online.

Mana hukmi otra suffix-taqa manan qhawaychu. Sutinqa ñawpaqta kutimanta t'ikraykun, chayraykun id-ninpi imaymana colon kachkasqan hinaqa llamkan; chay mana kanmanpas, suffix-kunaqa hukkunatam tukuyta hukkunata kutimun kachkaspa huk llamkanapaq. Sutinqa atipañanmi iskay pachak chunka qillqata, chaymantapas hukpacha t'ikraykunata; chaymantaspas aswan hatun kachkasqantaqa manan qallarinchu. 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);

Willaypaq ñawinchay

Chay chat modelkunapas kawsaypacha internetmantam kutichisunman. Nymbotqa chay ñawpaq rimayta (ñañaytaqmi 2,000 qillqasqata) maskhan, allin kaq qillqasqakunata ñawinchaspa, chay tapukuywan kuska chay modelman qun, chayqa manam modelpa rurananpaq nisqata qatunan mana hina nispalla kachkan. Iskay modo kachkan:

• Hayk'aqpas maskay: "plugins": [{"id": "web", "max_results": 5}], imayrukuray :online modelo patapi añayay.
• Yanapayta munasqayki pachapi maskay: "tools": [{"type": "web_search", "parameters": {"max_results": 5}}], chaywanpas qallarin chayta hinallataq web_search_preview dois openrouter:web_search. Nymbot maskhasqanqa tapukuypas qispichasqa kayta munan chayta rikunanpaqllapi, chaymi app nisqapi kaqta maman.

max_results 5 kani pachamamanta hinallataq chunka kachkan. Kay pachaqa chaymantam hamun. nymbot.web_search.sources, hukkunpasqa maskhaykunawan title, snippet chaymanta url, chaymanta as url_citation Willakuypi qillqasqakuna

Kay kutimachay pachaqa $0.008 ruraq, sats-man t’ikrasqa, tokens-pa patanpas, chaymi qhipaqpi kachkan. Payqa ñawinqan pajinaspas input tokensmi kachkan, chaymi internetmantapacha kutichisqanqa qillqasqataq kutichisqanmanta aswan chanin, paytaq wataq wata aswan chanin.

Huk waraqpi tarpuy

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

Tukuykunapa kutichikunankuna API

OpenAI-pa musuq patraq kaq nisqan, OpenAI Agents SDK-paq hinaspa Codex-paqtaqa usqhayta apasqan. Chat Completions hina mawk'aykunapi, qullqi pagapakuypaqtaq, hinaspa allin kaqkunapi kachkan.

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

Tarpuy

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

Huk llamkayta mañakuy riqsinkunim kachkan output nina hina function_call kaypaqmi call_id, name chaymanta arguments; kutichiyta qelqay kani a function_call_output Chay hina imawan call_id. Yuyaynin, chay modelomi qusqanpi, hukqa reasoning kaypaqmi reasoning_text lluqllay, ñawpaqta qillqasqa. status kaymi incomplete tukuypa kutichisqanmi chaypi chayamun max_output_tokens imaymana allichaqqa mana munarqan, ...wan incomplete_details.reason qhapaq kachun max_output_tokens dois content_filter. Tukuy kutichiyqa imayna mañakuypi kaqnin hinaqmi kachkan (temperature, tools, tool choice chay hina), OpenAI nisqapas hina, hinaspa qhali kachkan nymbot urarichiy imayman.

Yaku pacha kachkan, chay kaqkunapas hukmi... event: harawikuypas hikuypas data: a nisqawanninpa qillqa sequence_number, kay ordenpi: response.created, response.in_progress, response.output_item.added, response.content_part.added, ima yupaypas response.output_text.delta, response.output_text.done, response.content_part.done, response.output_item.done, hinaspa tukuytaqa response.completed tukuy aylluwan uyasqanwan paidunwan. Chaypaq kutichiyta chakisqaqa kaywan tukun: response.incomplete tukuytaq, hinaspa chay llant'uy nisqataq qallariypi hinaqa response.failed. Yachay yakuqkuna kantaq kunapaqmi kawsan response.reasoning_text.delta chaymanta .done. Llamkayninakuna hamunqam rimay nisqanmanta, ida riqnin killa hina kawsaspa response.function_call_arguments.delta chaymanta .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);

Anthropic Willaykuna

Anthropicpa nisqan, Anthropic SDK-kunapaqtaq Claude Code-paqtaq. Kayqa kachkan llapan modelokunawan, manam Claude-llapachu: tukuy rimayqa t'ikraykun, chaypi llamkaykun, hinaspa kutim t'ikraykun.

POST https://nymbot.ai/api/v1/messages — API key nisqata munanchu, chayqa x-api-key dois Authorization: Bearer.

-qa anthropic-version chaymanta anthropic-beta llank'aykunata qhipanakuypaq rimaykuna chayta qarpaykuyta munan kuymi, mana allichasqapas. Anthropic model sutinkuna katalgupi riqsinku, chaymi Claude Code nisqa hinaspa SDK-kunaqa kay sutikunawanmi llank'an:

• Katalog riqsisqan sutichay, hinataq claude-sonnet-5 dois anthropic/claude-opus-5, chay hinallatam usachakun.
• Mana chayrayku huk p'unchay (-20260514), -latest, hinataqmi version tag nisqapas -v1, qhichayta wiktaytaq ukhunpi kachkaq tag ukhunpi hina [1m] hinataq chaytaq anthropic/ dois anthropic. ñawpaq simikunata qunqayku, chaymanta versionpi p'unchaykunapas t'inkikunapas imaymana ñawpaqta hinaspa kutim ñawpaqta k'irinpa qhali kanku (claude-haiku-4-5 tarin claude-haiku-4.5).
• Chayqa manam imapas riqsimun chayraqchu, aylluta (Opus, Sonnet or Haiku) ushanchik, qillqanaqa rurayninqa sut'inchaq chayqa ñawpaqta munaqwan hina icha chaymantapas musuq kasqanwan.
• Manataq imatapas kacharqanchis sut'i kutimun. 404 not_found_error.

Tarpuy

{
  "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 kapuytaqmi atinman tool_use tullukuna hinataq huk thinking P'akcha, piqenpa signature Ch'aki kashan. stop_reason kaymi end_turn, max_tokens, tool_use dois refusal, hina rurashqa finish_reason Patapi Chaykunata Tukuy; stop_sequence kaypim kachkan semper ⏳ null, hatun tukuy nisqa khatariypas kutichikuyninta tukuytaq, input_tokens hayk'an musuq hampiyllapuni; qhipaq hampiyqa iskay cache pacha kachkan. Ancha chanriypaqqa chaypi kachkan nymbot allin kaqmi chaytan X-Nymbot-Cost-Sats umayuq.

Yakuwan chayasqa, Anthropicpa sasaqnin: message_start, content_block_start, ping, content_block_delta (text_delta, input_json_delta dois thinking_delta), content_block_stop, message_delta tukuyta papayta kaniypi, usata hina the nymbot qanpaq ruray, chaymanta message_stop. A ping pachaqa pichqa chunka chunka ikimunpimmi apachin kachkan modelo llamkanchaptinpas. Kay llamkaykunam qillqasqataq chaymantami hamun, chaykunaqa... tool_use tukuy imaymana qallariypaqmi huklla hukkunpi block nisqa input_json_delta.

Kay endpoint nisqapi hukuykuna Anthropic nisqapa sutillanmi rurayku: {"type": "error", "error": {"type": "not_found_error", "message": "…"}}. A ch'iq qhipaymiqa 402 billing_error, llant'aykusqa qatuyuq 503 overloaded_error. Qaqay qallarishaspan, mana allin kashayqa hinataqa... error tupanay.

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

Tokenkunatami yarpaniychani

Messages nisqamantaqa imaynan input tokenkuna kachkan chayta yachaypaq, manaraqmi kachikunatinpaq qhepakuspa riqsisqanpaq. Amaqanmi, ichaqa llave kachkan chaypaq.

POST https://nymbot.ai/api/v1/messages/count_tokens — API key requrin. Mana qullqi paganapaq.

Kurku chay hinallataq Willaykuna, manam max_tokens; modelo sutinmi allichan아야. Llaqt'aqa yuyaymi: system prompt nisqapa sutin, rimanakuykuna, tool calls, chaymantapas tool definitions nisqaykuna tawa nisqapi hinallataq, chaymantapas huch'uy rikch'aykunapaqqa 1,600 nisqata wiñay, hinaspa huk nisqata. Kayqa manam provider nisqapa tukuy rimayninchu, chaymi chayqa sapa kutin hukkuna kasqanmanta allin llamkananqa sapa kutin mosqusqam. Llaqt'aqa tukusqata reachesqan kypa runapas, chayta apanman.

Tarpuy

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

Modelokunata listay

APIqa qallariypas rurayninpaspiqa, kananchikninwan hina, qanpaqmi. Kay listaqa app nisqapi kanchaqnin hinaq hina kachkan, chaymi serverpa rurayninpiqa chaymi kachkan.

GET https://nymbot.ai/api/v1/models — manam k'hayllapaqpas kanmanchu. Limatami qhipakuyta chaskiy.

GET /api/v1/models/{id} Huk qillqasqata kutichin.

Premioqqa chaymi qipayki, pagallawanmi, hinaspa kikin mawk'ayniykinnam, dollarkunapi hinaspa Bitcoin allin pacha nisqapi sats-kunapi. balance riqsi chay qullqi kaqmantam ruranchik. nymbot_key app nisqapi llamk'aqpa sutinqa aswan huch'uyllan. created hinallapacham, 0, chayraykun katalluqa manan qillqanchu pikun kachkan. Manam qillqasqa token chaninpacha kachkanchay sutiyuq modelchu, chaymantapas chaninpacha kanman per_request aswanpas.

nymbot/auto ñawpaqtaqa kashan, chaymantaqa hinakoq mawk'aywan 💵 variable, huk routes Sapa rutanapaq chawpichasqankunata qillqay. Rikuyta hinaspa hamut'ayta qillqan, ichaqa llamkanapaq kaqkunata manan.

GET /api/v1/models/{id} tukuy sutinmanta hinaspa t'aqsiyninmantaqa imaynatapas qatichin, hinaspataq paykuna kawsayta mask'anpaqtaq chay modelo nisqapa qelqanmanta kutichin.

Tarpuy

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

Huk imaymana wataqkunapas:

• Rupay qillqakuna kashan capabilities (accepts_image_url, requires_image_url, edit) hinallataq hinaya qari per_generation.
• Video qillqakuna kashan max_duration_seconds chaymanta resolutions, hinaspa huk thanka per_second chay resolution nisqapaqmi.
• Uyway qillqakuna kashan audio_type speech dois transcription, anqasqa per_1k_chars dois per_minute.
• Hukpaqman churanay qillqakuna kashan dimensions, context_length, max_inputs hinallataqmi entrada tokens million nisqapaq thanqa.

Qillqasqa thansakuna "estimated": true apppa estimaciónmi chay generator nisqapaq, hinataq hucha qullqiqa manam willaykurqanchu. Huk yachunapacha type kutimuykuna 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);