Maziko a chidziwitso Opanga mapulogalamu
Chidule cha API
Ma model, ma generator ndi balance omwe mumagwiritsa ntchito mu app, kuchokera m'kalembedwe kanu. API imalankhula m'njira za OpenAI ndi Anthropic, choncho zida ndi SDK zambiri zimagwira ntchito pokonza base URL ndi key.
Tsambali lamasuliridwa pamakina kuti zikhale zosavuta. Chingelezi choyambirira ndi chomwe chimagwira ntchito.
API ndi chiyani
HTTP API pa nymbot.ai chimene chimayankha mapempho amene OpenAI kapena Anthropic
makasitomala amatumiza kale. Mumalandira:
- Kukwaniritsa kwa Zokambirana, the Mayankho API ndi Mawu a Anthropic, ndi streaming, zida, zithunzi, maganizo ndi kufufuza pa webu, kwa mbulu iliyonse mu kalogolo ndipo kwa auto-routing ya Nymbot yokhazikitsidwa yokha.
- Zithunzi, vidiyo, bulankhulo, kolemba mawu ndi Zoloweretsa.
- Anu khalidwe la ndalama, Kuonjezera ndalama za Lightning, ndipayikitsa kudzakumukira nokha kuchokera ku wallet yanu ndipo a mbiri za mtengo wa pempho lililonse.
Imalipiridwa kuchokera ku awiri omwe ali ofanana mabalaansi monga pulogalamu, pa mitengo yofanana. Palibe malipiro a nthawi zonse komanso palibe mwayi waulere pa API: pempho lililonse limalipiridwa pogwiritsa ntchito ndalama (credits) zomwe mwagula.
Zomwe API sizimachita ndi kuwonjezera chilichonse cha Nymbot. Mauthenga anu amapita ku model mmene mwatumizira: palibe Nymbot system prompt, palibe kukumbukira, palibe tsiku kapena zizindikiro za chinenero. Zomwe zimabweranso ndi yankho la model komanso chidziwitso cha zomwe zinagwiritsa ntchito ndalama.
Ma URL oyambira
| Gwiritsani ntchito | URL yoyambira |
|---|---|
| SDKs za OpenAI ndi zipangizo zomwe zikugwirizana ndi OpenAI | https://nymbot.ai/api/v1 |
| Anthropic SDKs ndi Claude Code | https://nymbot.ai/api (SDK imaonjezera /v1/messages diwewe) |
Endpoint iliyonse ili m'munsi mwa /api/v1/. Njira yosadziwika ikubweranso 404 ndipo
njira zodziwika kuti idawitchidwa ndi njira yolakwika imabweretsa 405, onse monga JSON.
API imayankha mapempho ochokera ku ma site ena aliwonse, choncho tsamba la browser likhoza kuitchula. Komabe, chilichonse chomwe mumatumizira ku browser chikhoza kuwerengedwa ndi aliyense amene angaliutsegule, choncho chitani zimenezi ndi kiyi yomwe ili ndi... kapuMapeto omwe asayidwa ndi nambala yanu (keys, summary ya account, NWC auto-top-up ndi refund redemption) ndi okha: m'browser amayankha mawebusayiti a Nymbot okha. Onani kusaina mapempho a akaunti.
Tumizani JSON body iliyonse ndi Content-Type: application/json. Mtundu uliwonse wina uli
kukandidwa ndi 415, choncho HTML form yodziyimira yekha kapena a text/plain pempho kuchokera ku
webusayiti ina sungafike pa API. Pogwiritsa ntchito cURL, pass
-H "Content-Type: application/json" limodzi ndi -d.
Ma API keys
Makiyi amapangidwa m'app. Tsegula API mu mbali ya ku cira ya web app, kapena mu menyu pa Android ndi iOS, ndipo dinani Pangani kiyiPatsanika dzina ndipo, ngati mukufuna, kapu ndi tsiku limene zidathe.
Kiyi uliwonetsedwa kamodzi. Ukope kiyiwo pamalo otetezeka musanatseke tsamba ili: Nymbot imasunga chidindo chabe cha kiyiwo, choncho simungathe kuwonanso. Kiyi olasika sangathe kubwezeretsedwa; kanyozani kiyiwo ndipo pangani wina.
Kiyi imakuoneka ngati sk-nymbot- zotsatira ndi zilebo 43, manambala, malemba ndi
zizindikiro zofindika. Pulogalamuyi imasonyeza kiyi iliyonse ndi dzina lake komanso chidziwitso chachidule monga
sk-nymbot-Qm7x…c2Lw.
- Kiyi amakhala wa dzina lanu. Imathetsa ndalama zanu, ndipo yemwe ali ndi nym yanu yekha ndiye angathe kupanga, kusintha kapena kuchotsa izo. Aliyense amene ali ndi kiyi akhoza kugwiritsa ntchito ndalamazo, choncho chiyendetseni ngati password.
- Ma caps ali m'sats. Kiyi ikhoza kukhala malire a ndalama zomwe zingagwiritsidwe ntchito, ndipo malire amenewa akhoza kuimilanso
tsiku lililonse, sabata lililonse (Lachisanu) kapena mwezi uliwonse (tsiku loyamba), pa 00:00 UTC. Imasankha
misonkho yonse, credit yachikhalidwe ngati 10 sats ndipo Pro credit ngati 100, choncho zikutanthauza zofanana
kaya kusoŵa kumakhala kuli kuliwonse komwe pempholi kukugwiritsa ntchito. Kusamala pempholi lisanayambe, ndalama zambiri zomwe zingagwiritidwe ntchito
(zofunsidwa kukhala misonkho yonse) zimaperekedwa pa zomwe zasala za malirewo. Ngati sizikwanira,
pempholi limakanidwa ndi
403key_limit_reached, ngakhale yankho lingakhale pansi pa malire; cholakwika chimati ndi kangati kotsala komanso nthawi yomwe malire amayambitsidwanso. Kuchepetsamax_tokenskumatsitsa zimenezo. Pempho limalipiridwa pa zomwe zinachitika ndipo zimaphatikizidwa m’mlimo, choncho ngati opereka malipoti amapereka ma token ambiri kuposa omwe anasungidwa, pempho lomwe lachitika mwaphetheliwa likhoza kutenga kiyi pang'ono kupitirira mlimo wake; pempho lotsatira limanenidwa kuti silichita. - Chidziwitso cha ndalama chotha chimangostimitsa kagwiritsidwe ntchito ka ndalama. Kiyi pa mkomwe wake akhoza kupitiriza kuunika malingaliro a ndalama, kuwerenga mbiri yake, kulista mitundu ya zinthu, kuwerenga ma token, kuonjezera ndalama komanso kuunika vidiyo yomwe inayamba kale.
- Kutha ndiko kosankha. Pambuyo pa tsiku lomwe mwasankha, kiyi zimayima kugwira ntchito.
- Kuchotsa kumachitika nthawi yomweyi ndipo ndi kokhazikika. Kiyi yochotsedwa imalephera pa pempho lake lapadera lapadera. Imakhala m'ndandanda, yolembedwa kuti yachotsedwa, kuti mbiri yake yogwiritsa ntchito ndalama izikhalabe yozindikika.
- Mutha kukhala ndi makiyi akugwira ntchito osakanasiana mpaka 25, aliyense ali ndi dzina lake. Kusintha nthawi yomwe key idzayambitsidwe mwakanso kumayambitsa nthawi yatsopano kuchokera pa zero.
Chikalata chimachimodzi chimasonyeza ndalama zomwe kiyi iliyonse wagwiritsa ntchito pa nthawi ino komanso yonse, nthawi yomwe inagwiritsidwa ntchito komaliza, mabanja anu awiri a ndalama, komanso pempho anu a API zaposachedwa. Mapunji omwe ali m'mbuyo mwa izi amafotokozedwa pansi pa kusamalira makiyi.
Kutsimikizira pempho
Tumizani kiyi m'modzi mwa ma header awa. Ndi ofanana, choncho gwiritsani ntchito aliyense yemwe client wanu amatumiza mwachibadwa:
| Mutu | Katulidwa ndi |
|---|---|
Authorization: Bearer sk-nymbot-… | OpenAI SDKs, zipangizo zambiri, Claude Code ndi ANTHROPIC_AUTH_TOKEN |
x-api-key: sk-nymbot-… | Anthropic SDKs |
api-key: sk-nymbot-… | Makasitomala a kapangidwe ka Azure |
Kufuna kiyi yemwe alibe, yemwe wasiyana, yemwe wakhazikitsidwa m'mbuyomu, kapena yemwe wapita nthawi kukubweretsa 401, ndi kodi
missing_api_key, invalid_api_key, revoked_api_key kapena
expired_api_keyKuonetsa ma model, ma model a audio ndi mawu, komanso njira zolipirira
sikuofunika kiyi.
Zithunzi, vidiyo, mawu, kulemba mawu ndiponso ma embeddings zitha kulipiridwanso pa pempho limodzi pa nthawi imodzi kudzera ku Lightning popanda kiyi konse: tumizani pempho popanda kiyi ndipo lipirani fomu ya malipiro mu 402 yankho. Onani kulipira pa chilichonse chomwe chipangidwa popanda
kukhala kiyi.
Kasamalidwe ka makhidiridwe (Key management), chidule cha akaunti ndiponso kukhazikitsa ndalama mwachisawonjezere ndi zolakwika: amalandira sigini kuchokera ku nym yanu m'malo mwa khidiridwe, choncho khidiridwe cholowa m'manja kwa ena sungathe kupanga ma khidiridwe ena. Onani kusaina mapempho a akaunti.
Pemphotso lanu loyamba
Ikani kiyi mu variable ya environment, kenako pemphani model chinthu chilichonse. Zitsanzo zonse m'mapeji awa zikuwerenga kuchokera ku 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 ndi ku zozungulira kwa Nymbot koyenera, yolipiridwa kuchokera pa kachapa kachidziwitso (standard balance). Ikani id ya model ya catalog m'malo mwake, monga kuti anthropic/claude-sonnet-5, kugwiritsa ntchito kamodeli kamene aka
kuchokera pa Pro balance. Kuwerenga mamodeli imapereka id iliyonse.
Mtengo wa pempho limodzi ndi uthenga wanji
API imalipira mofanana ndendende ndi momwe app imalipirira.
- Kodi ndiye mulingo uti?
nymbot/autoamagwiritsa ntchito ndlamu balance (10 sats a credit). Model iliyonse ina imagwiritsa ntchito Wodziwa kwambiri balance (100 sats a credit). Generator yemwe ili ndi yachikhalidwe komanso voice yemwe ili yachikhalidwe amagwiritsa ntchito ndalama zoyenera; generator iliyonse ina imagwiritsa ntchito Pro. Embeddings amagwiritsa ntchito ndalama zoyenera. Transcription imagwiritsa ntchito ndalama zoyenera pamene balance yoyenera ingathe kulipira, ndipo Pro credits ngati siwotero. Mndandanda wa ma models umati ndi balance iti yomwe model iliyonse imagwiritsa ntchito. - Ndi ndalama zingati? Pemphotso la macheza amatsimikizidwa pa mulingo wa ma token omwe model inayera komanso kulemba, pa mtengo womwe wosungika kwa opereka, pa mtengo womwe wosungika kwa opereka umathandizidwa ndi chiwerengero cha 5% ndipo kenako amukulitsidwa ndi 1.5, choncho mumalipira 1.575 kamene kuli mndandanda wa opereka. Amasinthidwa kukhala ma sats pa mtengo wa Bitcoin womwe uli m'mbiri ndipo amalipiridwa mwa mbali zochepa za credit. Zithunzi za Pro, video ndi mawu zamphamvuyontho amalamulidwa pofuna kupanga, pa chiyambi chilichonse, pa ndime iliyonse kapena pa tchimanyanja, ndipo kumasulira mawu amalamulidwa pa ndime iliyonse ya mawu omwe amveka, ndi chiwerengero chofanana cha chinthu ndi mulingo umene uliwo. Chithunzi chachikhalidwe ndi 5 standard credits ndipo mawu achikhalidwe ndi 3.
- Chochepa. Chilichonse chofunika kulipira chomwe chimayenda chimadya osachepera 0.05 credit: half a sat pa standard balance, 5 sats pa Pro. Zigawo za credit zimapitirizidwa, osati kuzikweza nthawi iliyonse.
- Dikirani, ndipo dzikhale m'malo. Musanachitike pemphovuto, ndalama zambiri zomwe zingagwiritsidwe ntchito zimangosungidwa kuchokera m'malo mwanu amene muli nawo, malinga ndi zomwe mwatumiza komanso chiwerengero chachikulu cha mawu (tokens) omwe angalembemo. Zolemba zomwe sizili m'ndandanda ya ASCII zimayezedwa kudzera mwa ma bytes a UTF-8, ndipo manambala ndi zizindikiro za ASCII chimodzi ndi chimodzi chimakhala token imodzi, choncho zolemba m'ziŵerengero zilizonse, makodi, ndi manambala zimangosungidwa zonse. Kusungidwa kwa ndalamazi kumachitika monga m'mabwezi (credits) onse, osachepera amodzi, choncho ntchito iliyonse ikufunika osachepera sats 10 m'malo amene ali ndiwe m'standard kapena sats 100 m'Pro kuti iyambe. Ndalama zomwe zagwiritsidwa ntchito okha ndizo zimachotsedwa; zina zonse zimabwezedwa ntchito ntchito itatha. Ntchito yozama imapitiriza kusunga ndalamazo malinga ndi nthawi imene ikuyenda; ngati ndalamazo zisamasungidwa monga mwayenera, mauthenga amathera ndi a
402insufficient_balancechochitika cha cholakwika, ndipo zomwe zinapangidwa zaperekedwa ndalama. Ngati mtengo weniweni uli waukulu kuposa zomwe balance ingathe kulipira, balance yonse imatengedwa, ndipo kotsalira kumadalirowa (owed_satsmunymbot...chinthu, komanso kukhala ndi ndalama zochepera). Zimene zili ndi ngongole zimaperekedwa koyamba kuchokera m'ndalama zamakrediti zomwe zidzafike pa nambala imeneyo. Mpaka pamene idzaperekedwa, palibe chilichonse cha ndalama zomwe zili pa nambalayo chomwe chingagwiritsidwe ntchito: kaya ndi API, mayankho m'pulogalamu, kutumiza ndalama kapena mphatso. - Ndalama sizikwana. Ngati ndalama zomwe zalipo sizingathe kulipira ndalama zomwe zasungidwa, pemphulo limakanidwa ndi
402musanayambe chilichonse. Kuyanja kumati ndi kiyansi komwe kuli pang'ono, ngati kuti pali sats zingati zomwe pempholi zikufuna komanso kuti pali zingati zomwe zilipo. Zochepamax_tokenszikutanthauza kukhala ndi kusamalira kochepa. - Zolephera. Pembiro limene limalephera silipitsa kanthu, kupatula ngati wopereka wapereka mlandu
chifukwa cha ntchito yomwe inachita musanalephere, kapena kufufuza pa webu kapena
nymbot/autoKuyeza ntchito kachatikadi; ndiye kuti ndiye zomwe mumalipira, osachepera 0.05 credit. Mtsinje (stream) womwe mwamuchotsa umalipiridwa malinga ndi ma token omwe opereka amapereka malipoti: Nymbot amapitiriza kuwerenga mtsinje wa opereka kwa mpaka SEKONDI 25 mutachoka kuti apeze chiwerengerocho. Ngati siwafika, malipiro amalangizidwa malinga ndi zomwe mwatumiza ndi zomwe zinlembedwa, ndipo kwa model yomwe imaganiza, izikuphatikizapo malipiro onse a zotsatira zomwe zinali zosungidwa. Pempho limene uluse wake ulitsekedwa limalizidwa ndipo limalipiridwa. - Kafukufuku wa pa web ndalama ndikupita pa $0.008 pa kufufuza komodzi, yomwe yasintha kukhala sats, nthawi iliyonse yomwe kufufuza kwachitika, kaya modeleriyo inayankha kapena inalephera. Zida zomwe imawerenga zimaperekanso ku modeleriyo ngati input, choncho zimawonjezera ma token awo.
Mayankho aliyense amati ndalama zomwe adagwiritsidwa ntchito. Mayankho a JSON amabala a nymbot chinthu chomwe chili ndi
balance yomwe inalipiridwa nayo, mtengo mwa credits ndi sats, komanso zomwe zasala:
Chinthu cha mtengo
"nymbot": {
"balance": "pro",
"charged_credits": 0.162,
"charged_sats": 16.2,
"balance_credits": 412.425,
"balance_sats": 41242.5
}
Mayankho amene aliponadi malipiro amanyamulanso ma header awa, omwe ndiye malo ozunzirira mtengo wa yankho lomwe si JSON, monga mawu:
| Mutu | Tanthauzo |
|---|---|
X-Nymbot-Cost-Sats | Pembirowu imakozera ndalama zingati, m'sats. |
X-Nymbot-Balance-Sats | Kodi ndalama zomwe zachotsedwa pa balance ndi zingati, m'sats? |
X-Request-Id | ID ya pempho, pa yankho lililonse. Ipwani ngati mufunsa chithandizo. |
Mitengo pa miloni ya token, yomwe kale ili ndi mali ndi phindu, ili mu
makalelo awerengedwe m'madola ndi sats, ndipo pambuyo pake
tsamba la mitengoNgati mtengo wa Bitcoin sungatheke kuwerengzedwa,
mapempho adalipiridwa amabwerera 503 price_unavailable ndi
Retry-After: 60 m'malo modzuleza.
Zolakwika
Zolakwika zonse zili ndi mawonekedwe amodzi, amene makasitomala a OpenAI kale amamvetsetsa. code ndi
dzina lodalirika lomwe mungathe kuonjezera; message n'chifukwa cha anthu ndipo ikhoza kusintha.
Thupi la cholakwika
{
"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
}
}
| Mkhalidwe | Liti |
|---|---|
400 invalid_request_error | Thupi silibe JSON yoyenera (invalid_json), malo ofunika wosowa (missing_required_parameter), mtengo ndi olakwika, kapena pemphu likupempha chinthu chomwe model kapena endpoint sichimachita, monga zida zomwe ali pa nymbot/auto (unsupported_tool). param dzina la munda. Komanso upstream_rejected pamene opereka anakana pempho. |
401 authentication_error | Kiyi ikusowa, siidziwika, yachotsedwa kapena yatha, kapena pempho lomwe lili ndi chizindikiro si lofana kapena lagwiritsidwanso ntchito. |
402 insufficient_quota | Ndalama zomwe zilipo sizikwanira pempho. Code insufficient_balance, ndi balance, required_sats ndi balance_sats. |
403 permission_error | Pemphero siligwirizana ndi mbali ya batani (key_limit_reached, ndi limit_sats, used_sats ndi reset_at), kapena akaunti sitingagwiritse ntchito chithandizo (account_denied). |
404 not_found_error | Njira yosadziwika (unknown_endpoint), ndondomeko yomwe palibe ife (model_not_found), kapena kiyi yemwe sikudziwika, invoice kapena vidiyo. |
405 | Njira ilipo koma osati m'njira imeneyo (method_not_allowed). Ndizomwe Allow Header imalemba mndandanda wa njira zimene imalandira. |
413 | Thupi kapena fayilo ndi yaikulu kwambiri (payload_too_large, file_too_large), kapena karekhodingu ndi chachitali kwambiri (audio_too_long). Onani malire. |
415 invalid_request_error | Thupi silitumidwa ngati application/json (kapena, kwa mipata ya upload, multipart/form-data): unsupported_media_type. |
422 | Mawu ndi chinenero chomwe sichiliogwirizana mu text to speech (voice_language_mismatch, unsupported_language). |
429 rate_limit_error | Zopemesa zambiri pa kiyi uno, kuchokera ku address ino, kapena ndi zolemba zomwe zinafeli kuunika (rate_limit_exceeded), kapena wopereka akugwiritsa ntchito chinthu chochepetsa kuchuluka kwa pemphu (upstream_rate_limited). Yudzani masekondi ali mwa Retry-After. |
500 api_error | Zinthu zina zisayenda bwino mbali ya Nymbot (internal_error). |
502 api_error | Wopereka sanabweretse yankho (upstream_error), kapena invoice ya Lightning inalepha kupangidwa (invoice_unavailable). |
503 api_error | Wopereka wazidwa kwambiri (upstream_overloaded), mtengo wa Bitcoin sungathekuwerengeka (price_unavailable), kapena gawo la ntchito lili pa vuto (service_unavailable, media_hosting_unavailable). Retry-After amati nthawi yoti muyese kachiwiri, kumene kuli zodziwika. |
Zinthu ziwiri zapadera:
/api/v1/messagesmayankho mu kachidindo ka cholakwika ka Anthropic, chifukwa ndicho chomwe makasitomala a Anthropic amapenda:{"type": "error", "error": {"type": "authentication_error", "message": "…"}}. Mtundu umathandizira mmene zinthu zilili:invalid_request_error,authentication_error,billing_error(402),permission_error,not_found_error,request_too_large,rate_limit_error,api_errorkapenaoverloaded_error(503).- Pemphotso la streaming yomwe imalephera musanayambe kutumiza byte yake yoyamba imaperekedwa ndondomeko ya JSON yadzithunzi ndi mkhalidwe womwe uli pamwambapa, osati event stream. Kulephera kumene kumachitika kusanafike pamene streaming yayamba ikuyenda kumatumizidwa ngati event yomaliza ya streaming, m'ndondomeko yake yeniyeni ya endpoint imeneyo.
Uthenga wa zolakwika sukafotokoza zinthu zamkati za ntchito ina iliyonse. Zolakwika za opereka ntchito zimamasulidwa bwino asanafike kwa inu.
Zozindikira
| Chiganyidwe | Mtengo |
|---|---|
| Zopempha pa kiyi iliyonse | 120 pa mphindi. Pamene pali kupitirira apo, 429 ndi Retry-After. |
| Zopempha popanda kiyi | 120 pa mphindi pa liaddress iliyonse, chifukwa cha model, audio ndi mndandanda wa njira zolipira, kuunika mauthenga a kubwezeretsa ndalama, komanso ma endpoint amene amolipiridwa amene amagwiritsidwa ntchito popanda kiyi kapena malipiro. Kupitirira apo, 429 ndi Retry-After. |
| Kuvomerezeka kwa nthawi kulephera | 30 pa mphindi pa fambulasi iliyonse ya mafoni, masaini, zinthu zolipira komanso mafoni odzadzera ndalama omwe sakupezeka. Pamene pali kupitilira apo, pemphu lililonse kuchokera ku fambulasi yomwe ili ndi chizindikiro chimenechi chimalandira 429 ndi Retry-After mpaka mphindi itatha. Zidziwitso zimadzedwa asanawerenge thupi. |
| Makiyi atsopano | 60 pa ola kwa nym iliyonse ndipo 120 pa ola kwa mawolowoza aliyense. |
| Ma invoice a kudzaza ndalama | 60 pa ola kwa nym iliyonse ndipo 120 pa ola kwa mawolowoza aliyense. |
| Maululumikizidwe a wallet a NWC | 10 pa ola limeneli pa nym ndipo 30 pa ola limeneli pa adilesi. Wallet relay iyenera kugwiritsa ntchito wss:// pa pawtu wotsata. |
| Kubweza tokens | Zofuna 60 pa mphindi pa token imodzi. |
| Malo | Adilesi ya IPv6 imatengedwa ngati /64 yake yonse m'malire aliwonse a adilesi, ndipo adilesi ya IPv6 yomwe ili ndi IPv4 imatengedwa ngati adilesi yake ya IPv4. |
| Mawu a JSON request body | 4 MB; 64 KB kwa mapempho omwe ali ndi sigini ya nym yanu. |
| Chinthu cha pempho chachipatso (kukumitsa) | 32 MB. Chithunzi choti chikonjedwe chingakhale mpaka 20 MB, fayilo ya mawu mpaka 25 MB. Zigawo zambiri 64, malinga ndi zigawo zambiri 8 KB za part headers, komanso malire a 1 mpaka 70 characters; ngati ayenera 400 invalid_multipart. |
| Zithunzi m'pempho limodzi la macheza | 20. Chilichonse ndi an https:// kapena http:// link ku host yozikidwa poyera, kapena a data:image/… URL. |
| Zithunzi pa pempho la kupanga | 1 mpaka 4 (n) |
| Zotsatira za mawu | Zolimitsidwa pa chiwonadi chachikulu cha model. Chachikulu max_tokens kupita pansi kwa iye, osati kukana. |
| Kulowetsa mawu | Makarakata 800 kwa mawu amene ali ndi mtundu wamba, 2,000 kwa Aura 2. |
| Kulemba mawu omwe akamveka | mphindi 30 za audio, 25 MB. Kujambula kwa nthawi yayitali kukana ndi 413 ndipo sikutambira malipiro, ngakhale pamene kutalika kwake kumadziwika pokhapokha pamene Whisper wamvapo. |
| Zolembedwa m'magulu | Zolemba 100 pa pempho lililonse. |
| Ntchito za video | Zimasungidwa kwa maola 24 mutatsatira kutumiza; chithunzi (render) chimaperekedwa pambuyo pa ola imodzi. Pamodzi, nambala yomwe ingathe kuimpiridwa ndi 10 pa nym iliyonse. |
| Mbiri ya mafunso | Wasungidwa kwa masiku 90. |
| Ma kunci oli akukhwima pa nym | 25. Mafoni ogulitsidwa akusowa 50 akuzikidwa okha. |
Link ya chithunzi iyenera kukhala pa malo ololedwa kwa aliyense: malo amene ali pa network ya pakhomo kapena ya pa m'mudzi, kapena pa malo a Nymbot eni, si ololedwa. Kayendetsedwe ka mauthenga (pacing) komwe kumagwiritsidwa ntchito mu app kuli ndi mphamvu komanso pano, choncho kupeza mauthenga ambiri nthawi imodzi kwa m'patsidwe mmodzi kungathe kuchepetsedwa m'malo moti mauthengawa asachitike.
Zomwe API ingathe kuona
API si yachinsinsi monga momwe ma app aliri, ndipo ndikofunika kukhala lenileni pa mmene izi ziliri.
- Sizolowa ndendende mwa njira yoziteteza (end-to-end encrypted). M'mapulogalamu, uthenga umasefaliwa pa chida chanu kuti mavesi amene Nymbot ali nawo okha angathe kuwawereza ndipo amayenda monga a Kupaka mphatso. Pempho la API ndi HTTPS yachidziwikidwa: imakhala yolembedwa mwaluso pa ulendo kupita ku Nymbot, ndipo seva ya Nymbot imayiverenga mwachindunji kuti ikwaniritse.
- Maulizo ndi mayankho sikusungidwa. Amapitira ku model ndipo yankho limabwerera m'mbuyo. Chimene chimasungidwa ndi bilu: pa pempho lililonse nthawi, model, mtundu, chiwerengero cha token, mtengo, balance, key komanso ngati zinayenda bwino, kwa masiku 90, chomwe ndi mbiri ya mafunso amakuwonetsani. Mbiri ya kagwiritsidwe ntchito ka pemphulo limenelilo (nthawi, mtundu, model, kuchuluka kwa token, mtengo, nthawi yomwe yanama, komanso ngati inagwiritsa ntchito kufufuza pa webu kapena inaphambana) imasungidwanso kwa masiku 90, pamodzi ndi yomwe app imasunga.
- Zonse zina zomwe zili kwa nym ndi zochepa ndipo zalembedwa pano. Ma API keys amasonedwa ngati hash, osati kiyi, ndi dzina lawo, chidziwitso chachidule, malimita a ndalama zomwe angagwiritsidwe ntchito, nthawi yoti azikhazikitsenso, nthawi yomwe zidzasiridwa komanso nthawi yomwe zinapangidwa ndi nthawi yomwe zinagwiritsidwa ntchito komaliza; kiyi 50 zatsopano zomwe zatengedwa zimangosungidwa. An kukonza kudzitchatsa kokha Kugwirizana kwa wallet kusungidwa mwachinsinsi (encrypted), ndi threshold yake, ndalama, komanso zotsatira za kudzazidwa kwa ndalama komwe kwachitika posachedwapa. Ntchito za video zimwasungidwa kwa maola 24. Zipembozo zomwe amalipira pa kuitana iliyonse zimasiya Lightning payment hash yokha kwa masiku 7 komanso hashed refund token kwa masiku 30, yomwe siyiilumikizidwa ndi dzina lililonse. Malipiro omwe ndalama zomwe zilipo sizingathe kufunika amasiyidwa ngati ngongole mpaka pamene kudzazidwa kwa ndalama kumawalipira.
- Kufuta pulogalamu kumachotsa pulogalamuyo. A Kufuta chida amavutula ndipo amachotsa API key iliyonse, ndipo amachotsa mbiri ya mafunso, zolemba za kagwiritsidwe ntchito, kuphatikizapo kulumikizidwa kwa wallet ndi ntchito za video. Ndalama zomwe zilipo ndi ndalama zilizonse zomwe zili ndi udindo zikutsala pa nym.
- Wopereka wa model aona pempho lanu, monga mmene chimachitira kuchokera ku app. Catalog maudindo amayenda ku opanga awo; njira ndi ma embeddings osiyanasiyana amayenda pa Cloudflare.
- Zinthu zomwe zapangidwa ndi zaonetsedwa kwa onse. Zithunzi ndi vidiyo zomwe zatumizidwa monga malink ndi
zolembedwa pa malo osungira zinthu a Blossom amene ali okhala poyera, kumene komweyo malo a chinthu ndi hash yake. Aliyense yemwe ali ndi
link akhoza kuzitsegula, ndipo Nymbot sangathe kuzichotsa kachiwiri. Pemphani
b64_jsonndipo chithunzi cholembedwa chimabweranso m'mayankho ndipo sichikwezedwa nkomwe. - Ndiye kodi zithunzi zomwe mumapereka ndi zopangidwa ndi makina? Chithunzi chomwe mukachitumiza ku
konza, kapena tumizani ngati a
data:URL mu woletsaimage_url, imaperekedwa pa Blossom host yozindikirika kaye kuti generator ikhoza kupeza, ndipo izi zikuchitika chimodzimodzi ndi izo. Chithunzi chomwe chatumizidwa ndihttps://link imaperekedwa ngati link imeneyo. Zithunzi m'pempho la macheza zimapita kwa opereka modeliyo, osati kwa Blossom. - Kiyi ili yozungulidwa ndi nym yanu. Zonse zomwe kiyi imagwiritsa ntchito zimachotsedwa pa balance ya nym yanu, choncho kugwiritsa ntchito API si wosadziwika. Ngati mukufuna kagwiritsidwe ntchito ka API kukhale kusepukana ndi dzina lanu la tsiku ndi tsiku, pangani makiyi kuchokera
Ngati mukufuna chitetezo cha mapulogalamu, gwiritsani ntchito mapulogalamawa. API ndi yoti mukafuna kugwiritsa ntchito ma model mu zida zanu.
Malonda onse
| Malo otsirizira | Zomwe zimachita | Ubwumwalira |
|---|---|---|
GET /api/v1/models | Mndandanda wa maudeli, ndi mitengo | Palibe |
POST /api/v1/chat/completions | Kukwaniritsa kwa Zokambirana | Kiyi |
POST /api/v1/responses | Mayankho API | Kiyi |
POST /api/v1/messages | Mawu a Anthropic | Kiyi |
POST /api/v1/messages/count_tokens | Zolozera za tokeni zomwe zalowa | Kiyi |
POST /api/v1/images/generations | Imapanga zithunzi | Kiyi kapena Mfulumira |
POST /api/v1/images/edits | Kukonza chithunzi | Kiyi kapena Mfulumira |
POST /api/v1/videos, GET /api/v1/videos, GET /api/v1/videos/{id} | Amayamba, amalembetsa ndiponso amayang'ana mavidiyo | Kiyi, kapena Mfulumira kuyamba chimodzi |
POST /api/v1/audio/speech | Kuwerenga mawu mofunda | Kiyi kapena Mfulumira |
GET /api/v1/audio/models, GET /api/v1/audio/voices | Ma model a audio ndi mawu | Palibe |
POST /api/v1/audio/transcriptions, POST /api/v1/audio/translations | Mawu kukhala zolemba, ndipo ku Chingerezi | Kiyi kapena Mfulumira |
POST /api/v1/embeddings | Zolembedwa m'magulu | Kiyi kapena Mfulumira |
GET /api/v1/credits/balance (kapena POST) | Mphamvu zonse ziwiri | Kiyi |
GET /api/v1/topup/payment-methods | Njira zolipira | Palibe |
POST /api/v1/topup/create/btc-lightning | Mchenga wa invoice ya Lightning | Kiyi |
GET /api/v1/topup/status/{invoice_id} | Amayesa ndipo amaika ndalama mmenemo | Kiyi |
GET /api/v1/queries/history | Mtengo wa pempho lililonse | Kiyi kapena nym |
GET /api/v1/account | Chidule cha akaunti | Nym |
/api/v1/keys | Amapanga, amasintha komanso kumang'anitsa makiyi | Nym |
/api/v1/nwc-auto-topup | Kudzulutsa kokha | Nym |
GET /api/v1/l402/refunds, POST /api/v1/l402/refunds/redeem | Kumvera kapena kuweruza kachapa ka kubwezeretsa ndalama | Token yobwezera; nym kuti mubwezere |
“Nym” amatanthauza pempho lolembedwa ndi kiyi yanu ya Nostr, kofotokozedwa mu kusaina mapempho a akaunti. Kwa zida zomwe kale zimalankhula maformat awa, onani zipangizo ndi SDKs, ndipo kwa ma coding agents monga Claude Code, Codex ndi Cline, onani ziyenero za coding.