Xiseketelo xa vutivi / Vaakuli wa swiendli

Xikongomiso xa API

Mindzhele, generators na balance leyi u tirhisaka eka app, eka mikhakha ya wena ya code. API yi vulavula hi mafomatha ya OpenAI na Anthropic, ndzi swi vula leswaku switirhisiwa swa nkarhi na SDK swi tirha hi ku cinca base URL na key.

Tluka leri ri hundzuluxeriwe hi muchini leswaku ri olova. Original ya Xinghezi i version leyi tirhaka.

API i yini

HTTP API eka nymbot.ai lexi hlamulaka swivivi leswi fanaka leswi OpenAI kumbe Anthropic client a tshame a tsalela. U kuma:

• Ku fambisela ka ku tswala ku vulavula, ya Swivutiso swa API na Swivulwa swa Anthropic, hi ku tshama u tshama, switirhisiwa, swifaniso, ku humisela na ku sweka eka webu, eka xihlangu xin'wana na xin'wana lexi nga eka khwata naswona ku ta Nymbot'a xihlamululo xa yena xa ku tsutsuma hi ku titsongahata.
• Swifaniso, vhidiyo, minkondzo, ku tsala hi ku landzela na embiidings.
• Swa wena minkarhi, Ku tlhengelisa ka Lightning, ku pfuxisa hi vutshila eka wallet ya wena na timo hi ku ri lava leswaku xitofulo xin'wana na xin'wana xi xala mali ya yini.

Swi rixiwile eka lava tano va fanaka minkarhi ya mali ku fana na app, hi mitirho ya mali leyo. Ku nga ri na xikongomelo xa ku tshamela kumbe xin'we na xin'we xa vuteleketi eka API: xivumbeloni xin'we na xin'we xi xirhandzaka hi makhuluwo leyi wuyikiwe hi ku xava.

Leswi API yi nga xi endlaka hi xona i ku engetela xin'wana-n'wana xa Nymbot. Swikulumu swa wena swi ya eka model hi ku fana ni leswi u swi tsindzaka: a ku na Nymbot system prompt, a ku na xikumbelo, a ku na ntirho wa siku kumbe xirimi. Leswi vuyaka byi humaka i mphendulo wa model ni xikombiso xa leswi swi nga xitshuri.

Ma-URL ya le hansi

Endpoint xin'wana na xin'wana xi tshama hi le pasi ka /api/v1/. Ndzhila leyi nga tiviwiki yi khutlumeta 404 na ndlela leyi tiviwaka leyi kumiwaka hi ndlela leyi xivileke yi nyika 405, xin'wana na xin'wana hi xihlamuselo xa JSON.

API yi hlamula nirito ra cross-origin eka vonkulu wun'wana na wun'wana, hi ku va xiphemu xa browser xi nga swi vula. Xinkulunkulu, xin'wana na xin'wana lexi u xi engetaka eka browser xi nga nga rihlomisa hi un'wana na un'wana loyi a nga xi tswakela, hi kuva swi fanele ku endliwa hi xikombiso lexi nga na xinyunyweto lexi xi endlaka leswaku... N'wiSwivandlaka leswi tsariwe hi nym ya wena (tihlohloko, xitlhokovetselo xa akaunti, ku tlhantlha hi NWC ni ku hakhuluxa ku humisela mali ntirho) i swivandlaka xin’wana: eka browser swi tivisa swivandlaka swa Nymbot swin’wana فحسب. Vonani Ku lumata swiombiwa swa akaunti.

Tshumela xiyenge hinkwaswo xa JSON hi ku ri: Content-Type: application/jsonHi ku ri na xin'wana xin'wana xin'wana lexi ri pfumari hi 415, xikombiso xa HTML form kumbe a text/plain xikongetelo eka site yin'wana xi nga swi kota ku fika eAPI. Hi cURL, pass -H "Content-Type: application/json" na ku fambisana na -d.

Switivi swa API

Makhalaha ya endliwa eka app. Vula API e le side bar ya web app, kumbe e menyu eka Android na iOS, u khomisa Sumeṭa xihlokoNyika vito naswona, loko u lava, vukulu na siku yo fhela.

Khokho yi kombiwa ka nkarhi wu n’we. Yi kopyela ndhawu leyi kahle u ntshama vhele: Nymbot yi tshungula xitshatshatsha xin’we ta khokho, hi leswaku yi nga swi kombi u pfanum’wini un’we. Khokho leyi laeke yi nga tswalukiwi; yivula u tswala yin’wana.

Xikongomana xi fana na sk-nymbot- ku landzela hi mañambhelu ya 43, xinumbwana, mitsila ni mitsila yo le pasi. Xitirhiso xi kombisa xinyakeyala xin'wana na xin'wana hi vito ra xona ni xichulumuselo xo koma hi ku fana na sk-nymbot-Qm7x…c2Lw.

• Xikunganyana xi ya eka ntiyiso wa wena. Yi dya mali ya wena, naswona n'wina n'we xitsandzaka x만 swi nga kota ku endla, ku cinca kumbe ku tshama hi yona. Manana a veke xihloko (key) i nga kota ku dya hi yona, ngopfu hi ku yi tlhokomela hi ndlela ya khunyetelo (password).
• Caps ti le matsatsatsa. Khombi yi nga va na xikongomelo xa ku tshwaya, naswona xikongomelo xi nga cinca hi siku nirhi, hi xivungu xinhi (Mavurundzira) kumbe hi ntsiku rin’wana rin’wana wa ku nyima (vukati), hi 00:00 UTC. Swi hlayisa mivandla hinkwayo, xikongomelo xa xiyimo xa xiga xa 10 sats ni xikongomelo xa Pro xa 100, hi leswaku swi vula swilo eku fananaka ku lava leswaku xikwembu xi tshwaya xivandla xihi. Tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsoswa ngopfu, tsos 403 key_limit_reached, hambi loko vutlwanisi byi nga ta fika hi le pasi ka xikongomelo; xiyambelo xi kombisa leswaku ku salekile yini na loko xikongomelo xi antswa. Ku ndhavukisa max_tokens swi engetela leswi vhiwona hi ku tshama swi ri kona. Xikwembu xi xewetiwa hi leswi xi tivaka leswaku swi tivile, naswona swi hlamusela ku fika ka xikwembu, hi leswaku loko mufambisi a ri kombisa mavele ya tokens yo tala ku tlula lava va nga va vekile, xikwembu xa mhaka ya vukosi bya xona xa nga fika katsongo ematshan'weni ya xona; xikwembu xo landzelaka xi ta leriwa.
• Xikongomelo lexi telekiweke xi henta ku tirhisiwa ntsena. Xitshungulo eka xikambelo xa xona xi nga ha kura ku xavisa minkarhi, ku hlaya rika xikombiso xa swilo swa rona, ku tsalela ti-model, ku balavanyisa ti-token, ku pfuxa mali naswona ku xavisa vhidiyo leyi nga sunguluxiweke.
• Ku fela ka nkarhi a ku pfaneleki. Hi ku landza siku leri u nga ri veke kona, xivi xi yima ku tirha.
• Ku hoxela swi engano naswona swi hoxile. Khivi leyi furiweke yi pfala xikongomelo xa xona xa endzhaku. Yi tshama eka xiyimbi, yi kombiwe hi leswaku yi furiweke, leswaku rikirisi ra xona ra ku tirhisa ri tshama ri na ntolovelo.
• U nga va ni tihlanganu ta swikogo swimbirhi na khume 25 leby tirhaka, xin'wana na xin'wana xi ri na vito ra xona. Ku cinca nkarhi wa ku tsundzuxa ka sikoko swi sungula nkarhi wo titshika eka zero.

Xihondla lexi xi kombisa xichavo xin'wana na xin'wana xa ntshekete (key) eka nkarhi lowu na hi ku lumunga, xikombiso xa swi-balance swa n'wina hi mbili, na ma-request ya wena ya API ya le kusuhi. Swiendla leswi nga eka xona swi kombisiwile eka ku lumata tikhari.

Ku tivisa xiphemu xa xikwembu

Humisa nchavi eka xin'wana na xin'wana xa ti-headers leti. Ti riki tivitshuri, ngopfu hi leswaku tirhisa xin'wana na xin'wana lexi khliyeta client wa wena hi xikombiso:

Khaviso leyi nga riki kona, leyi nga tiviwikiwiki, leyi nga hlayiwiwile kumbe leyi nga foleke yi nyika 401, hi khodi missing_api_key, invalid_api_key, revoked_api_key kumbe expired_api_key. Ku kombisa timodeli, timodeli ta audio na mivox, ni tindlela ta ku ripayeta a ku lava key.

Swifaniso, vidiyo, vito, ku kopeta na ku hlamusela swilo swa mianakanyo swi nga xavisiwa na xipfumo xin'we hi xin'we hi Lightning u nga ri na xivuku nkarhi wun'we ku: engetela xipfumo u nga xi ri na xona u ri ri hlamula i xiyimo xa 402 hlamula. Tala ku rihisa hi xicelo xin'wana xin'wana nga ri na khave.

Ulanguliwa ka tikhishi, xihundla-hlanganiso xa akaunti na ku pfuxa akaunti hi mpfumavalo i xin'wana lexi hlawulekaka: va amukela xitsakonza exin'wini xa nym wa wena ematshan'u ka khishi, leswaku tikhishi leri humileke ri nga swi kota ku endla tikhishi to tala. Vonani Ku lumata swiombiwa swa akaunti.

Xikwembu xa wena xa xin'we xa ku-tsongo

Nghenisa xikongomelo eka xihlamuseryi wa xiyimo, u tsutsumeta model hi nchumu un'wana. Swikombiso eka maswahiloni lawa swi hlaya eka NYMBOT_API_KEY.

cURL

export NYMBOT_API_KEY="sk-nymbot-..."

curl https://nymbot.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nymbot/auto",
    "messages": [{"role": "user", "content": "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"],
)

reply = client.chat.completions.create(
    model="nymbot/auto",
    messages=[{"role": "user", "content": "What is a Lightning invoice?"}],
)
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: "nymbot/auto",
  messages: [{ role: "user", content: "What is a Lightning invoice?" }],
});
console.log(reply.choices[0].message.content);

nymbot/auto i routing ya Nymbot ya yena, leyi riyiweiwaka eka balance ya xiyimo xa xinkulumo. Tsala id ya model ya catalog leyi nga riki kona, hi xikombiso: anthropic/claude-sonnet-5, ku tirhisa xihlanganisoLexi e ndzhaku ka Pro balance. Ku veka mihavero u nyika xingheniso xin'wana na xin'wana.

Xikongomelo xi xavisiwa mali ya yini

API yi hlawula hi ndlela leyi kongomaka na app.

• Ika xiviko lexihi? nymbot/auto u tswentela va xihakafula minkarhi (10 sats a credit). Xikombiso xa mahlamuselo ya mahulumenu yo hela yo karhi ya xikombiso xa mbulavulo wa ntsako. Pro khale (100 sats a credit). Generator ya xifaniso yo fana na voice yo fana na yi tirhisa credits to fana; generator yin'wana na yin'wana yi tirhisa Pro. Embeddings ti tirhisa credits to fana. Transcription yi tirhisa credits to fana loko balance yo fana na ya kota ku yi hlayisa, naswona Pro credits loko ku nga ri swi kona. Xihlanganiso xa mi-model xi kombisa leswaku balance yo fana na yini yi tirhisiwa hi model yin'wana na yin'wana.
• Mali yi enanganisaka? Xikweti xa ku vulavula xi tlhantlhaniwa hi tokens lexi model yi nga xi hlayae na ku xi tsala, hi swiyimbela leswi nga tshunywa hi muhumeleri. Xivindzi xin'wana xin'wana xi enetiwa 5% ya xigalo naswona swi tlhiwa hi 1.5, hi ku va u ri karhi u riha 1.575 ka xiyimbela xa muhumeleri. Swi hundzuluriwa eka sats hi xiyimbela xa Bitcoin lexi nga kona sweswi naswona swi rihiwa hi swinkulungwane swa credit. Swifaniso swa vutivi, video na vulavuri swi rihiwa hi nkarhi wa ku endliwa, hi sekondi yin'wana yin'wana kumbe hi xihlamuselo xa xin'wana xin'wana, naswona ku tsala hi ku ya hi sekondi ya swiantswa, hi xigalo ni ntsandzo lowu fanakawo. Xifaniso xa xiyimo xa xiya xi riha 5 standard credits naswona vulavuri bya xiyimo xa xiya byi riha 3.
• Xikongomelo xa xivunene. Xihundzuluxi xin'wana na xin'wana xin'we lexi tiviweke xi nga tirhisiwa xi xavisiwa vuyelo bya 0.05 credit ku fika eka: nkarhi wa sat ya nkarhi wa 0.5 eka balance ya standard, 5 sats eka Pro. Swivulavulelo swa credit swi hlayisiwa, swi nga hakuri hi ku rhendluka nkarhi na nkarhi.
• Yima, u nga ta tshamela. Loko ku karhi ku kumiwa, swilo leswi nga kona swi hlayisiwa eka mitsari ya wena, hi ku ya hi leswi u nga swi tsindza na leswi swi nga nga swi tsindza hi ku tisa tokens. Ma xigevenga eka ASCII ya hlayiwa hi UTF-8 bytes, naswona xin numbers ni mapunctuation ya ASCII xin hlayiwa hi token yin’we, hi kuva ma xigevenga eka xiyimo xin’wana na xin’wana, code ni xinumbers swi hlayisiwa hi ku xiya. Leswi hlayisiweke swi hlayisiwa hi credits, xin’we na xin’we, hi kuva xihlaku xin’wana na xin’wana xi lava ku va na 10 sats lexi nga riki eka standard balance kumbe 100 sats eka Pro leswaku xi sungula. Leswi nga tisiweke swo rhandzu swi tisiwa; leswi swin’wana swi vululuxiwa loko swi fika. Xihlaku xa xihlaku xa xikombiso xi hlayisa xihlaku xao loko xi xa tsandzeka; loko credits lexi hlayisiweke swi nga ha ri kona, stream yi ya yi yima hi a 402 insufficient_balance ntshava wa nchumu, naswona leswi hlamulaka swi hlamuriswa hi mali. Loko mali yo rhandza yi tlula leswi xigumba xi nga swi kombisa, xigumba hinkwaswo xi tekiwa, leswi swi salaka swi ta riwa (owed_sats e ka nymbot swilo, naswona xikambelo xa mahlunghu). Swi lavaka leswaku swi ri rhenisiwa tinhlamuselo leti nga ngeleyi ta nkarhi lowu nga ni xikambelo lexi. Ku fika loko swi ri rhenisiwile, xin’wana na xin’wana xa xikambelo lexi a xi kona xi nga hundzuluki: hi API, maendlo eka app, ku tsandzeka kumbe xipfalo.
• Mali yi nga riki. Loko mbali yi nga swi kombi ku hlayisa xikongomelo, xikwembu xi lulavuriwa hi ku: 402 tsimu na swinoko swi nga riki. Xiphiqo xi kombisa leswaku mali i mani leyi panganaka, leswaku xikombiso xi lava matsatsa mangani naswona ku ri na mani leyi nga riki na ntsako. Xikombiso lesitsongo max_tokens swi vula ku va ni nkarhi wo ndzhaka.
• Swiphiqo. Xikweto lexi nga tshathelaka xi nga riki mali, handle ka leswaku mfanisi wa xitiriso wu xaxelele hi ntirho lowu wu dyondzaka ku ringanisiwa, kumbe ku xirisiwa ka vuxwebu kumbe... nymbot/auto ntirhandzo check yi tshame ya tirhisiwa; hi nkheno lowu u ri xivalo, vusiwana hi 0.05 credit. Xikongomelo lexi u xavaka xi xivaletiwa hi matirhiselo ya tokens leyi ndzhavuko yi riyalahaka: Nymbot yi tshama yi hlaya ndzhavuko wa ndzhavuko ku fika hi masiku ya 25 hi ntirho loyi u nga xi tshamaka ku fika ku kuma ntsengo lowu. Loko yi nga wu fikanga, ntsengo wu xanisiwa hi leswi u nga swi tsandza na leswi swi nga tsariweke, naswona eka model leyi n'wini yi riyo ku xavisa swi xanisa ku hela ka swilo leswi nga nge nkarhi lowu. Xikwembu lexi xikongomelo xa xona xi nga herisa naswona xi xivaletiwa.
• Ku xavisa eka webu Swi rhandza $0.008 hi ku fifha yin'wana, swi hunduxetiwile eka sats, loko ku endliwa ku fifha nkarhi na nkarhi, nakambe loko model yi hlamula kumbe yi hluleka. Maphepha lawa yi a yi a nga wu hlaya yi ya eka model laha ku nga nghenisela kona, hi ku ri va ku engeta ma-token ya wona.

Xiphesbetelo xin'wana na xin'wana xin'komela leswi nga ri mali. Xin'wana na xin'wana xa JSON xin xavela a nymbot swilo leswi nga na swihundla leswi xihundla xa swona xi ri ri ngeka, xiyero xa credits na sats, ni leswi swi nga ri:

Xikongomelo xa xihlawulelo

"nymbot": {
  "balance": "pro",
  "charged_credits": 0.162,
  "charged_sats": 16.2,
  "balance_credits": 412.425,
  "balance_sats": 41242.5
}

Mayelana na mbulavulo wa mali i maheader lawa, laha ku faneleke ku languteka mali ya mbulavulo wa lexi ku nga riki JSON, ku fana na ku vulavula:

Mitirheko hi leswi nga kona ka mutolo wa matolemi ya mali ya milion, leswi nga riki na mutolo na xikongomelo, ku ri eka tihlamu ta mfanelo hi madolara na sats, naswona eka xihlamuselo xa xihlamusela xigevengaLoko xihlawulelo xa Bitcoin xi nga ha hlariwi, xinawu xinhetelele xi vuluka. 503 price_unavailable na Retry-After: 60 Ku nga ri ku tlangela.

Swiphiqo

Xihatlayi xin'wana na xin'wana xi va ni xivumbeko xin'we, lexi vaaki va OpenAI va nga xi tiva hi ku tala. code i vito leri nga cinciki lowu u nga ri kombanisa na wona; message i ta vanhu naswona i nga cinca.

Xihungataki xa xitenge

{
  "error": {
    "message": "This request needs up to 200 sats (2 credits) on your Pro balance, and 40 sats are free. Catalog models spend the Pro balance. Top up in the Nymbot app or with POST /api/v1/topup/create/btc-lightning.",
    "type": "insufficient_quota",
    "code": "insufficient_balance",
    "param": null,
    "balance": "pro",
    "required_sats": 200,
    "balance_sats": 40
  }
}

Swihleketi swimbiri:

• /api/v1/messages minkon'a hi ndhawu ya Anthropic error, hikuva i leswi va-Anthropic clients va tswakanyaka: {"type": "error", "error": {"type": "authentication_error", "message": "…"}}. Xitshuri xi landzela xiyimo: invalid_request_error, authentication_error, billing_error (402), permission_error, not_found_error, request_too_large, rate_limit_error, api_error kumbe overloaded_error (503).
• Xikwetiya xa streaming lexi tshamakaka ku ringana nkarhi lowu byte yi nga fiki xi kuma xihunguphelo xa JSON xa xihundla hi xiyimo lexi pfumaka ehenhla, hi nga ri event stream. Xihunguphelo hi mhiku lexi stream yi sungulaka hi yena xi tumeriwa tanihi xihlikeni xa mhiku xa xona, hi ndlela ya xona ya endpoint leyo.

Swinkhengo swa mavelele swi nga tshivi swi tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi swi nga tshivi sw

Swikongeti swi le henhla

Xikongetelo xa xifaniso xi fanele xi kombisa eka host yo vulavuleka: xihlala xa network ya swivuriso kumbe ya le kaya, kumbe eka mahala ya Nymbot, xi hlayetiwile. Ku pfumala ka mikhango loko ku rike eka app ku pfumela na le heyi na xikongetelo, xaikarhi ku rila ka mikhango yo enlavisi eka muveki un'wana swi nga vulelaka ku hlamusela ku ri na ku tsandzeka.

Swi nga vona yini hi API

API a wu pfumala ku vuyedza hi ndlela leyi mapulofesi (apps) ma riyaka hi yona, naswona swa rhandzeka ku va karhi swi rilele hi ndlela ya ntiyiso leswaku swi riyihi.

• A yi ri end-to-end encrypted. Eka ti-app, mbulavulo wu khongwetiweke eka device ya wena ku fika eka ti-key leti Nymbot yinxakae ta na ku famba hi ta ku phakanya xipfalo. Xikombiso xa API i HTTPS ya xivandza: yi pfumanyetiwile eka ndlela yi ya eka Nymbot, naswona server ya Nymbot yi yi hlaya yi nga ri na pfumanyeto leswaku yi i pfumanyeta ku yi lava.
• Swivutiso na swiphendulo a swi hlayiwi. Va fambela eka model naswona muxakatsi wu pfukela endzhaku. Leswi tikwemaka i xibilu: eka xitlhokovetselo xin'wana na xin'wana nkarhi, model, mufambisi, manombolo ya token, xikwembu, xinyunywanyunyu, xikoti, key ni leswaku swi tsandzekile, hi malembe ya 90, leswi i leswi xihundzuketi xa mpfuno swi ku kombisa wena. Xikombiso xa mathengelo xa xikwembu xin’we (nunghengerisi, mufuta, model, ku baleriwa ka tokens, mali, nkarhi lowu tirhisiweke na leswaku swi tirhise hi web search kumbe swi hundzile) swi hlayeriwa leswi nga ri 90 ni siku, hi ku kombana na xona xa app.
• Swinkulu hinkwaswo leswi nga ri n'wana i swinyenyeto leswi kombisiweke هنا. Switivi swa API swi hlamuleriwa hi hash, ku nga ri xikweni, hi vito vavo, xitshuri xo komba, xikongomelo xo xave, nkarhi wa ku tlula, nkarhi wo fela ni loko va endliwe ni ku tiya ka vona swa mhaka ya vukonzi; ti xikongomelo xa ti-key ta 50 ta ku tsilatisa ta swinene ta fambisela hi nkarhi wa sweswi. An ku tswakanya hi xinkulungwane khonnection ya wallet yi hlayisiwile hi ku pfumala, xikongomelo, xikamu na mhaka ya ku pfuxa mali ya mhangu. Marenda ya video ya tsaleriwa hi masiku 24. Swivowo leswi rixiwaka hi ku titshelatela swi tshikela ntsena lightning payment hash hi malembe 7 na hashed refund token hi malembe 30, leswi nga riki na nchumu lowu swi kombisaka. Swikongomelo leswi xikamu xa mali xi nga nga swi kota ku swi fhafula swi hlayisiwa hi ku riwa hi ku fhafula mali mpfula.
• Ku hamba app swi nga yi delesa. A ku hulisela xitshuri xa xitirhisiwa u faka vukorhokeri ni ku hlayisa hi swikongoma hinkwaswo swa API, ni ku hlayisa hi xikombiso xa ku kombisa, ta nkarhi wa ku tirhisa, ku khambanywa ka wallet ni ntirho wa vidiyo. Mbaxamuxelo ni swikongoma hinkwaswo leswi nga riki na swona swi tshama eka nym.
• Muvumbuleri wa model u vona xikwembo xaku, hi nga ku endleka ka app. Catalog swi hlamusela swivulavulelo swa vaaki wa swona; tindlela ta xiyero na swivuravulelo swi tirhiswa eCloudflare.
• Swilo leswi hlamuleriweke i swa vanhu hinkwavo. Swivunga na vidiyo lexi enetiweke hi ma-link i swi nga tluliseliwe eka Blossom file hosts leyi vulavulaka na unene, laha alamatana ya file yi nga yena hash ya yona. Mani a nga na link u nga swi vula, naswona Nymbot a nga swi nga ha koti ku swi tshenisa. Tsala u kombela b64_json naswona xifaniso lexi xumakawe xi humaka eka xiphendulo naswona xi nga tluliwi.
• Xana timfaniso leti u ti nyikaka i generator? Xifanambu lexi u pfumaka ku pfumala eka kumisa, kumbe u vulavula hi xigulu xa a data: URL eka muntirhi wa ku hlamusela image_url, yi humumentiwa eka Blossom host leyi tlhantshaka ku sungula leswaku generator yi nga yi kuma, naswona swi fana na yena. Xifaniso lexi humeriweke hi https:// link yi fambiswa hi ku ri link leyo. Swifaniso eka xicelo xa ku vulavula swi ya eka mubandzi wa model, hayi eka Blossom.
• Xikongomiso xi tshwa hi nximunhu wa wena. Swinkatana hinkwaswo leswi xikweni xi swi tirhaka swi huma eka balansi ya nym ya wena, hi leswaku ku tirhisiwa ka API a ku ri lowu nga riki vito. Loko u lava ku tirhisa API u vuyisela ku hlayisela ku famba hi nsuru wa wena wa siku na siku, endla tikhirhi hi nsuru wo karhi wo fambana na wena lowu nga na xihundla xa xona.

Loko u lava vukondzele bya ma-app, tirhisa ma-app. API i loko u lava ku tirhisa ma-model eka switirhisiwa swa wena.

Xiphetho xin'wana na xin'wana

“Nym” swi vula xikwembo lexi kombisiweke hi xitsepi xa wena xa Nostr, lexi hlamuseleriweke eka Ku lumata swiombiwa swa akaunti. Ku ta switirisi leswi nga ri kombiso hi ti fomatere ti, vona swesengeti na SDKs, naswona eka swikhutluki swa ku koda swi fana na Claude Code, Codex ni Cline, vona vona ya swiselu swa ku koda.