Pitani ku zomwe zili
Kubwerera ku Nymbot

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.

API ndi chiyani

HTTP API pa nymbot.ai chimene chimayankha mapempho amene OpenAI kapena Anthropic makasitomala amatumiza kale. Mumalandira:

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 ntchitoURL yoyambira
SDKs za OpenAI ndi zipangizo zomwe zikugwirizana ndi OpenAIhttps://nymbot.ai/api/v1
Anthropic SDKs ndi Claude Codehttps://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 403 key_limit_reached, ngakhale yankho lingakhale pansi pa malire; cholakwika chimati ndi kangati kotsala komanso nthawi yomwe malire amayambitsidwanso. Kuchepetsa max_tokens kumatsitsa 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:

MutuKatulidwa 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/auto amagwiritsa 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 402 insufficient_balance chochitika cha cholakwika, ndipo zomwe zinapangidwa zaperekedwa ndalama. Ngati mtengo weniweni uli waukulu kuposa zomwe balance ingathe kulipira, balance yonse imatengedwa, ndipo kotsalira kumadalirowa (owed_sats mu nymbot ...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 402 musanayambe chilichonse. Kuyanja kumati ndi kiyansi komwe kuli pang'ono, ngati kuti pali sats zingati zomwe pempholi zikufuna komanso kuti pali zingati zomwe zilipo. Zochepa max_tokens zikutanthauza 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/auto Kuyeza 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:

MutuTanthauzo
X-Nymbot-Cost-SatsPembirowu imakozera ndalama zingati, m'sats.
X-Nymbot-Balance-SatsKodi ndalama zomwe zachotsedwa pa balance ndi zingati, m'sats?
X-Request-IdID 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
  }
}
MkhalidweLiti
400 invalid_request_errorThupi 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_errorKiyi ikusowa, siidziwika, yachotsedwa kapena yatha, kapena pempho lomwe lili ndi chizindikiro si lofana kapena lagwiritsidwanso ntchito.
402 insufficient_quotaNdalama zomwe zilipo sizikwanira pempho. Code insufficient_balance, ndi balance, required_sats ndi balance_sats.
403 permission_errorPemphero 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_errorNjira yosadziwika (unknown_endpoint), ndondomeko yomwe palibe ife (model_not_found), kapena kiyi yemwe sikudziwika, invoice kapena vidiyo.
405Njira ilipo koma osati m'njira imeneyo (method_not_allowed). Ndizomwe Allow Header imalemba mndandanda wa njira zimene imalandira.
413Thupi kapena fayilo ndi yaikulu kwambiri (payload_too_large, file_too_large), kapena karekhodingu ndi chachitali kwambiri (audio_too_long). Onani malire.
415 invalid_request_errorThupi silitumidwa ngati application/json (kapena, kwa mipata ya upload, multipart/form-data): unsupported_media_type.
422Mawu ndi chinenero chomwe sichiliogwirizana mu text to speech (voice_language_mismatch, unsupported_language).
429 rate_limit_errorZopemesa 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_errorZinthu zina zisayenda bwino mbali ya Nymbot (internal_error).
502 api_errorWopereka sanabweretse yankho (upstream_error), kapena invoice ya Lightning inalepha kupangidwa (invoice_unavailable).
503 api_errorWopereka 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/messages mayankho 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_error kapena overloaded_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

ChiganyidweMtengo
Zopempha pa kiyi iliyonse120 pa mphindi. Pamene pali kupitirira apo, 429 ndi Retry-After.
Zopempha popanda kiyi120 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 kulephera30 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 atsopano60 pa ola kwa nym iliyonse ndipo 120 pa ola kwa mawolowoza aliyense.
Ma invoice a kudzaza ndalama60 pa ola kwa nym iliyonse ndipo 120 pa ola kwa mawolowoza aliyense.
Maululumikizidwe a wallet a NWC10 pa ola limeneli pa nym ndipo 30 pa ola limeneli pa adilesi. Wallet relay iyenera kugwiritsa ntchito wss:// pa pawtu wotsata.
Kubweza tokensZofuna 60 pa mphindi pa token imodzi.
MaloAdilesi 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 body4 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 macheza20. Chilichonse ndi an https:// kapena http:// link ku host yozikidwa poyera, kapena a data:image/… URL.
Zithunzi pa pempho la kupanga1 mpaka 4 (n)
Zotsatira za mawuZolimitsidwa pa chiwonadi chachikulu cha model. Chachikulu max_tokens kupita pansi kwa iye, osati kukana.
Kulowetsa mawuMakarakata 800 kwa mawu amene ali ndi mtundu wamba, 2,000 kwa Aura 2.
Kulemba mawu omwe akamvekamphindi 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'maguluZolemba 100 pa pempho lililonse.
Ntchito za videoZimasungidwa kwa maola 24 mutatsatira kutumiza; chithunzi (render) chimaperekedwa pambuyo pa ola imodzi. Pamodzi, nambala yomwe ingathe kuimpiridwa ndi 10 pa nym iliyonse.
Mbiri ya mafunsoWasungidwa kwa masiku 90.
Ma kunci oli akukhwima pa nym25. 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_json ndipo 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 woletsa image_url, imaperekedwa pa Blossom host yozindikirika kaye kuti generator ikhoza kupeza, ndipo izi zikuchitika chimodzimodzi ndi izo. Chithunzi chomwe chatumizidwa ndi https:// 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 otsiriziraZomwe zimachitaUbwumwalira
GET /api/v1/modelsMndandanda wa maudeli, ndi mitengoPalibe
POST /api/v1/chat/completionsKukwaniritsa kwa ZokambiranaKiyi
POST /api/v1/responsesMayankho APIKiyi
POST /api/v1/messagesMawu a AnthropicKiyi
POST /api/v1/messages/count_tokensZolozera za tokeni zomwe zalowaKiyi
POST /api/v1/images/generationsImapanga zithunziKiyi kapena Mfulumira
POST /api/v1/images/editsKukonza chithunziKiyi kapena Mfulumira
POST /api/v1/videos, GET /api/v1/videos, GET /api/v1/videos/{id}Amayamba, amalembetsa ndiponso amayang'ana mavidiyoKiyi, kapena Mfulumira kuyamba chimodzi
POST /api/v1/audio/speechKuwerenga mawu mofundaKiyi kapena Mfulumira
GET /api/v1/audio/models, GET /api/v1/audio/voicesMa model a audio ndi mawuPalibe
POST /api/v1/audio/transcriptions, POST /api/v1/audio/translationsMawu kukhala zolemba, ndipo ku ChingereziKiyi kapena Mfulumira
POST /api/v1/embeddingsZolembedwa m'maguluKiyi kapena Mfulumira
GET /api/v1/credits/balance (kapena POST)Mphamvu zonse ziwiriKiyi
GET /api/v1/topup/payment-methodsNjira zolipiraPalibe
POST /api/v1/topup/create/btc-lightningMchenga wa invoice ya LightningKiyi
GET /api/v1/topup/status/{invoice_id}Amayesa ndipo amaika ndalama mmenemoKiyi
GET /api/v1/queries/historyMtengo wa pempho lililonseKiyi kapena nym
GET /api/v1/accountChidule cha akauntiNym
/api/v1/keysAmapanga, amasintha komanso kumang'anitsa makiyiNym
/api/v1/nwc-auto-topupKudzulutsa kokhaNym
GET /api/v1/l402/refunds, POST /api/v1/l402/refunds/redeemKumvera kapena kuweruza kachapa ka kubwezeretsa ndalamaToken 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.