Motheo oa tsebo / Baetsi ba lenaneo

Kakaretso ea API

Limofuta, meralo le pawalo eo u e sebelisang ka har'a app, e tsoa lenkong la hau la khoutu. API e bua ka mofuta oa OpenAI le Anthropic, kahoo lisebelisoa le SDK tse ngata li sebetsa ka ho fetola URL ea motheo le senotlolo.

Leqephe lena le fetoletsoe ka mochini hore le be bonolo. Phetolelo ea mantlha ea Senyesemane ke eona e sebetsang.

API ke eng

HTTP API e holim'a nymbot.ai seo se araba litlhoko tseo khale e se e rometsweng ke mokli oa OpenAI kapa Anthropic. O fumana:

• Katloho ea Lipuisano, ea API ea Litaba tsa Karabo le Melaetsa ea Anthropic, ka ho phalla, lisebelisoa, litšoantšo, tenglelo le batla web, bakeng sa mohlala o mong le o mong o ka katalaogo le bakeng sa auto-routing ea Nymbot ka boyona.
• Litšoantšo, video, puo, Transkripshene le dikhomphutha tsa mofuta oa embeddings.
• Hao peo, Ho tlatsoa ha Lightning, lipheloho tse itšehlang ho tsoa lekoteng la hao le 'a histori tse sebelelletso tsa kopo e nngwe le e nngwe.

Ho lefiselwa ho tsoa ho ba babel ba le bang le bang ba tshwanang lip;$ehethe jwaloka app, ka litlhahloiso tse tšoanang. Ha ho na tebelo ea nako (subscription) le ha ho se na mohlala oa mahala holim'a API: kopo e 'ngoe le e 'ngoe e lefelloa ka lintlha (credits) tseo u li rekile.

Se seo API e sa se etseng ke ho eketsa ntho efe kapa efe e tsoang ho Nymbot ka bo boona. Molaetsa oa hau o ea mofuta oa mohlala (model) joalo ka ha o o rometse: ha ho na sesupo sa tlhophiso sa Nymbot, ha ho na mohopolo, ha ho na letsatsi kapa liphetetso tsa puo. Se se khutloang ke karabo ea mofuta oa mohlala le lintlha tsa hore na ho e bile le lefu le le kang.

Di-URL tsa motheo

Endpoint e 'ngoe le e 'ngoe e lula tlas'a /api/v1/. Tsela e sa tsebahalang e khutla 404 le tsela e tsebahalang e bitsitsoeng ka mokhoa o fosahetseng e khutlisetsa 405, ka bobeli joaloka JSON.

API e araba lithoko tsa cross-origin ho tsoa lebaleng lefe kapa lefe, kahoo lebala la browser le ka e bitsa. Leha ho le joalo, ntho efe kapa efe eo u e romellang ho browser e ka baloa ke e mong le e mong ea e bulang, kahoo etsa sena feela ka konokele e nang le... taolaLikhonono tse saenitsoeng ka nym ea hau (makhabane, kakaretso ea akhaonto, NWC auto-top-up le refund redemption) ke ntho e ikhethang: ka har'a browser li araba feelā maqephe a Nymbot a itlonela. Bona ho saena lithoko tsa akhaonto.

Romela mmele o 'ngoe le o 'ngoe oa JSON le Content-Type: application/json. Mofuta ofe kapa ofe o mong o rejoea ka 415, kahoo HTML form e tloaelehileng kapa a text/plain phetelo e tsoang leboaofeli le leng e ke ke ea fihlella API. Ka cURL, fetisa -H "Content-Type: application/json" hammoho le -d.

Lisebelisoa tsa API

Diketere li etsoa ka har'a app. Bula API lehlakoreng la web app, kapa ka meneng ho Android le iOS, mme o tobetse Etsa kataE fe lebitso mme, haeba u rata, le thapo le letsatsi la ho fela.

Sifako se bontšoa hang feela. Se kopitse sebakeng se sireletsehileng pele u koala letlapa lena: Nymbot e boloka setšoantšo sa menwana sa sona feela, kahoo e ke ke ea se bontša u hape. Sifako se lahlehileng se ke ke sa fumanoa hape; se hlakole 'me u entše se seng.

Leihlo a shebahala joalo ka sk-nymbot- e latelwang ke litlhaku tse 43, linomoro, linakisi le liponahalo tse tšoanang le linotlolo. App e bontša letšoao ka lebitso la lona le molaetsa o mokhutšoanyane joalo ka sk-nymbot-Qm7x…c2Lw.

• Lere le amana le lebitso la hao. E senya boleng ba hau, 'me feela nym ea hau e ka tsosa, fetola kapa tima eona. Mang le mang ea nang le senepe a ka e sebelisa ho senya, kahoo e tšoareleng joalo ka lenaneo la sethala.
• Lidididididi li ka har'a satelite. Sefofane se ka ba le lekapo la tšebeliso, ’me lekapo leo le ka ntshetsoa pele letsatsi le leng le le leng, bongata bja beke (Mantaha) kapa mongata oa khoeli (letsatsi la pele), ka 00:00 UTC. Se arola pehelo (balances) tše peli, khredit ea mofuta o tloaelehileng e le 10 sats ’me khredit ea Pro e le 100, kahoo se bolela ntho e le 'ngoe leha ho ka sebelisoa pehelo efe kapa efe. Pele kopo e phetheloa, tefo e ka fetang e ka bang efe kapa efe (e rutiloeng ho ea holimo ho ea khredititso tse tletseng) e hlahlobooa le seo se salletsoeng ke lekapo. Haeba se sa tloaele, kopo e hana le ho re 403 key_limit_reached, le haeba karabo e ne e ka fihla ka tlase ho takatso; phoso e bontša hore na ho na le eng e setseng le hore na takatso e nchafatsoa neng. Ho fokotsa max_tokens ho fokotsa se mpe ka ho fetisisa. Kopo e lekholisa se se qetellang ka nnete mme seo se abala ka har'a sechomo, kahoo haeba mofumahali a raletse litemana tse neng li behiloeng, kopo ea ho qetela e neng e khona e ka nka lebaka la senotlolo ho feta sechomo sa sona; e latelang e tla hanyetsoa.
• Sello se seng se fela se emisa ho senya. Phato ha e fihlele moeli oa eona, e ka ntse ea hlahloba mofuta, ea bala nalane ea eona, ea bontša mefuta, ea bala ditoken, ea eketsa, le ho hlahloba video eo e seng e qadile eona.
• Ho fela ke ea khethollo. Ka mor'a letsatsi leo u le behileng, senotlolo se a emisa ho sebetsa.
• Ho tloha ho etsoa hang-hang mme ho se ke ha fetoloa. Letšoao le lelekiloeng le hloleha lenako le latelang la kopo. Le lula lenalaneng, le tšepisitsoe hore le lelekiloeng, kahoo nalane ea lona ea ho sebelisa e ntse e utloahala.
• O ka ba le lithapo tse sebetsang tse fihlang ho 25, e 'ngoe le e 'ngoe e na le lebitso la eona. Ho fetola nako ea ho qala hape ea thapo ho qala nako e ncha ho tloha ho zero.

Let sheet e le nngwe e bontša tšhelete e sebelisitsoeng ke sesiele e 'ngoe le e 'ngoe nako ena le ka kakaretso, nako eo e neng e sebelisitsoe ka morao-horao, mochelo (balances) ea hao e 'meli, le likopo tsa API tsa hao tsa morao-horao. Lintlha tsa API (endpoints) tse ka morao ho eona li ngotsoe ka tlas'a taolo ea lintlha tsa phihlelo.

Ho netefatsa kopelo

Romela len钥 (key) ka e ’ngoe ea lintlha (headers) tsena. Li lekana, kahoo sebelisa efe kapa efe eo mofumahali oa hau a e romelang ka tlhaho:

Key e lahlehileng, e sa tsejubeng, e hlakotsoeng kapa e fentseng e khutlisetsa 401, le khoutu missing_api_key, invalid_api_key, revoked_api_key kapa expired_api_keyHo fana ka mofuta oa mahlale, mofuta oa lentswe le mantsoe, le mekhoa ea lefelloa ha e hloke senotlolo.

Litšoantšo, video, puo, transcription le embeddings li ka lefisoa hape kopo ka nako e le 'ngoe ka Lightning ntle le senotlolo le le leng: romela kopo ntle le eona 'me u lefe inkwotisi ho 402 karabo. Bona ho lefella ka kopo ntle le senotlolo.

Tsamaiso ea lintja, kakaretso ea akhaonto le ho eketsa chelete ka boitshisinyo ke tsona tse fapaneng: li nka setshwantsho sa boitsebiso ho tsoa ho nym ea hau ho e-na le lentja, kahoo lentja le ntšitsoeng le ke ke la etsa lintja tse ling. Sheba ho saena lithoko tsa akhaonto.

Kereko ea hau ea pele

Beha senotlolo ka har'a variable ea tikoloho, ebe u botsa mofuta oa mahlale ntho e itseng. Mehlala eohle ka har'a liphepha tsena e e bala ho 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 ke routing ea Nymbot e e mong, e lefiloang ka bakeng sa balance ea tloaelehileng. Beha id ea model ea catalog teng, joalo ka anthropic/claude-sonnet-5, ho sebelisa mohlala oo ho tsoa ho sepeletso sa Pro. Ho bapatsa mofuta o mong le o mong o fa nomoro ya mosebetsi e nngwe le e nngwe.

Ho lefu hakae ho kōpo e le 'ngoe

API e lefelloa ka tsela e le feleng eo app e lefelloang ka eona.

• Ke bolo efe? nymbot/auto o qetella sebopeho sa mofuta o tloaelehileng pehelo (10 sats ka kredo). Mofuta o mong le o mong oa puisano o qetella Sehlōlo peo (100 sats a credit). Sesebelisoa sa setšo sa ho bopa litšoantšo le molumo oa setšo se sebelisa peo ea setšo; sesebelisoa se seng le se seng se sebelisa Pro. Embeddings li sebelisa peo ea setšo. Transcription e sebelisa peo ea setšo ha peo ea setšo e khona ho e fihlella, le Pro haeba ho se joalo. Lenaneo la mofuta o bontša hore ke peo efe eo mofuta o mong le o mong o e sebelisang.
• Ke bokae. Puisano e lekollwa ka li-token tseo mohlala o li balileng le ho li ngoleng, ka litlhahlobo tseo mofaki a li tsebisitseng. Khelo eo ho eketsoa tefo ea 5% ebe e nkuoa ka ho ntan'ngoa ka 1.5, kahoo u lefa ka nako e 1.575 ho feta lehlakore la mofaki. E fetoleloa ho sats ka ntla ea boleng ba Bitcoin bo phelang mme e lekholisoa ka likarolong tse robong tse mehlano tsa khredite. Litšoantšo tsa mosebetsi, video le puo li tlhahisoa ka nako ea tsona, ka sekondi kapa ka tlhaku, le ho fetolela puo ho sekondi ea molodi, ka tefo le mohlala o tšoanang. Setšoantšo sa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta oa mofuta
• Nnyenyane haholo. Tekanyetso e nngwe le e nngwe e tsamaeang e nang le tefo e hlahlobang e qeta ho tala ho tala ho feta 0.05 ea khrediti: 'sat' e le nngwe e fokolang ho balance ea tloaelehileng, ha e le 'sats' tse 5 ho Pro. Likarolo tse nyane tsa khrediti li tsamaea le nako, ha li kopeloae ho tala nako le nako.
• Emela, ebe o khutsa. pele kopo e sebetsa, ntho e ka bang boima ka eona e tšoaretsoe tšebeliso ea hau, ho latela seo u rometseng le ntho e ka bang boima ka eona e ka ngolang. Litemana tse ka ntle ho plain ASCII li lekanyetsoa ho latela byte tsa tsona tsa UTF-8, 'me linomoro tsa ASCII le litalenta li nkoa e le token e le 'ngoe, kahoo litemana ka le leng leo le ngoliloeng, khoutu le linomoro li tšoaretsoe ka botlalo. Tšoarelo e etsoa ka dikrethe tse feletseng, ho itšetlehile ka hore ho be le e le 'ngoe, kahoo kopo efe kapa efe e hloka ho ba le ho feta 10 sats tse sa tšoareloang lenaneong la mantlha kapa 100 sats ka Pro ho qala. Se lefelloang ke sefo ela nnete feela; tse ling li lokolletsoa ketše e qetella. Kopo e telele e tsoela pele ho tšoara ntho e tšoaretsoeng nako eohle e ntse e sebetsa; haeba dikrethe tse tšoaretsoeng li ka qeta ho ba teng, mohlala oa melaetsa o emisa ka a 402 insufficient_balance lehlolo la phoso, le seo se hlahisitsweng ke sona se lefisiwa. Ha nako ya nnete e le e ntsi ho feta se sefahletseng se ka se lefisa, sefahletoso kaofela se nkuwa, se seng se nka nako e sa le teng (owed_sats ka hara nymbot (lintho, le bakala e le molafo). Se se leketseng se lefwa pele ho tsoa ho li-credit tse latelang tse fihlang bakalaneng eo. Ho fihlela se lefetswe, ha ho na se ka bakalaneng eo se ka se sebelisetsoang: ha se ka API, liphethisetso ka har'a app, ho fetisetsa chelete kapa mpho.
• Ha ho na chelete e lekaneng. Ha boleng bo sa kgone ho hlamela ntho e tšoereng, kopo e latoloa ka 402 pele ho ntho efe kapa efe e qalang. Phoso e re hore ke bolo efe e hlokang, hore na motsela o hloka satsu tse lingata hakae le hore na ke tse lingata hakae tse lokolohileng. E nnyane max_tokens ho bolela tshwarelo e nnyane.
• Litshohlanyi. Ho kopa ho hlolehang ha ho kake ha qeta ka ntho e itseng, ntle le ha mofumahali a se a lefisitse Mosebetsi oo a o entseng pele a hlolela, kapa ho batla marang-rang kapa ho nymbot/auto mosebetsi o ne o se o se sebetsoe; eaba ke seo u se lefelloang, ho tela 0.05 credit. Sehlahisoa seo u se kentseng sa se kgaotse se lefelloa ka litokomane (tokens) tseo mofahlohi a li fanoang: Nymbot e tswela pele ho bala sehlahisoa sa mofahlohi ka metsotso e fetang 25 ka mor'a hore u tlohe ho fumana ntho eo. Haeba e se e fihla, tefo e aroloa ka seo u se rometseng le seo se ngotseng, mme bakeng sa mofuta oa mohlala o o akang hore o nahana, ho akaretsa lekholotso lohle la pharollo ea nako e khetiloeng. Pitso eo tšimoloho ea eona e lahlehileng e ntse e phetheloa mme e lefelloa.
• Batla tlhahlobo ea web e qeta $0.008 ka thuto e le 'ngoe, e fetoleloa ho sats, nako le nako ha thuto e tsamaea, e le hore na mohlala o araba kapa o hloleha. Liphepha tseo e li balang le tsona li romeloa ho mohlala e le lintlha tsa ho kenya, kahoo li kenyelletsa litoekiso (tokens) tsa tsona.

Karabo e nngwe le e nngwe e re ke eng hore na e cost. Karabo tsa JSON li na le a nymbot thetho e nang le balanse eo ho e lefetsweng ka yona, tefo ka dikredite le sats, le se setseng:

Seloko sa moralo oa litšenyehelo

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

Litšebetšo tseo li lefiloeng li na le lintlha tsena, moo ho lokelang ho shepwa hore na lefello la karabo e sa le JSON, joalo ka puo:

Litlhahloebiso tsa tšebeliso ea tokens tse meli ka khale, tse seng li akaretsitsoe tefo le mofuta oa tšebeliso, li fumaneha ho... lenaneo la mefuta ea mohlala ka madolla le sats, le ho tsoela pele lehlakorela la litheko. Haeba lebitla la Bitcoin le ke ke la baloa, likopo tse lefelloang li khutlisetsa 503 price_unavailable le / le hokahanya Retry-After: 60 Ho na le ho etsa temoso.

Molato

Molato o mong le o mong o na le sebopeho se sejoale, seo bareki ba OpenAI ba se tsebeng hona joale. code ke lebitso le tiileng oo u ka le kopanyang ka lona; message ke bakeng sa batho mme e ka fetoha.

Mmele oa liphoello

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

Lihlakorelo tse peli:

• /api/v1/messages karabo ka mokhoa oa liphoso oa Anthropic, hobane ke hona seo bahlale ba Anthropic ba se hlahlobang: {"type": "error", "error": {"type": "authentication_error", "message": "…"}}Mofuta o latela boemo: invalid_request_error, authentication_error, billing_error (402), permission_error, not_found_error, request_too_large, rate_limit_error, api_error kapa overloaded_error (503).
• Kopalo ea streaming e hlolehang pele byte ea pele e fihla e fumana liphoso tsa JSON tse tloaelehileng ka taelo e holimo, eseng event stream. Phoso e tlang ka mor'a hore stream e qale e rometsoe e rometsoa joalo ka event ea ho qetela ea stream, ka mokhoa oa endpoint eo ka boyena.

Lipitso tsa phoso ha li na lintlha tsa ka hare tsa tšebeletso e ’ngoe. Phoso ea mofaki e fetoloa pele e fihla ho uena.

Meeli

Khoutu ea senepe e tlameha ho sheba ho motloa oa sechaba: aporo e lehoeng ho marang-rang a patiloeng kapa a le lefeleng, kapa ho mebala ea Nymbot ka boyona, e tla hana. Mantlha a mofuthu oa mofahlo o sebelisoang ka har'a app o sebelisoa mona hape, kahoo mofuthu oa likopo tse ngata ho mofahlo o le mong o ka nkuoa ka tsela e bonolo ho e-na le hore e hloele.

API e ka bona eng

API ha e thibellelloe joalo ka lisebelisoa (apps), mme ho bohlokoa ho hlakisa ka ho feletseng hore na ke joang.

• Ha se e e hlokomeloletseng ho tloha qalong ho ea qetellong. Liditšing, molaetsa o thibileloa sesebelisoa sa hau hore o lokiselletsoe likofuto tseo feela Nymbot e nang le tsona mme o tsamaea e le a paka ea mpho. Kereko ea API ke HTTPS e tloaelehileng: e khunyeletsoe lebaleng le eang ho Nymbot, mme sekhala sa Nymbot se e bala e hlakile ho e sebetsa.
• Litšobotsi le lipali ha li boloiwa. Ba kena ka har'a mohlala mme karabo e khutla morao. Se nkuoang ke molaoli oa tefo: bakeng sa sesupo ka sesupo nako, mohlala, mofuta, paloa ea mantsoe (tokens), cost, balance, key le hore na se atlehile kapa che, ka matsatsi a 90, e leng seo se le ... nakola ea lipotso e o bontša. Rekore ea tšebeliso ea pitso e le 'ngoe (nalle, mofuta, mohlala, palo ea litemanana, lenepo, nako le hore na e sebelisitse tshe searches tsa web kapa e atlehile) e bolokehiloe bakeng sa matsatsi a 90, hammoho le ea tlhophiso ea app.
• Tsohle tse ling tse bolokehiloeng bakeng sa nym ke tse nyenyane mme li ngotsoe mona. Lisebelisoa tsa API li bolokiloe e le hash, eseng lenotlolo ka linako tsohle, le lebitso la tsona, tlhahiso e khutšoanyane, moseto oa ho senya, nako ea ho pheta, nako ea ho fela, le hore na li entsoe neng le hore na li sebelisitsoe neng khafi; feela linotlolo tse 50 tse kansetsoeng tse tsoang letsatsi lena li bolokoa. An tlatsa ka boitšhabeli ketemelo ea wallet e bolokehiloe ka mokhoa o o patiloeng, le threshold ea eona, amount, le liphetho tsa top-up ea ho qetela. Video jobs li bolokehiloe ka lihora tse 24. Litlhoko tse lefelloang ka nako le nako li siea feela Lightning payment hash ka matsatsi a 7 le hashed refund token ka matsatsi a 30, e sa amane le nym efe kapa efe. Mafu a lebelo le ke keng la le lefu a bolokehiloe e le a ntho e sa lefelloang ho fihlela top-up e a lefa.
• Ho hlakola app ho e hlakola. A ho hlakola mosebelisi o hlakola le ho tlosa mofuta o mong le o mong oa API key, le ho tlosa nalane ea lipotso, litala tsa tšebeliso, ho hokahanya wallet le mosebetsi oa video. Tekanyetso le meralo efe kapa efe e sa le e le ntse e le nymeng.
• Mofuta oa mofagele o bona kopo ea hau, jwalokaha e tsoa ho app. Catalog mehlala e sebetsa ho ba e etletseng; litsela tsa sehlophiso le embedding di sebetsa ho Cloudflare.
• Media e hlahisitsoeng ke ea sechaba. Litšoantšo le video tse romeloeng e le maemo (links) li tshetlehala ho Blossom file hosts tse bulehlehileng, moo aporo e le ea mofuta oa (file) e leng hash ea eona. Motho e mong le e mong ea nang le maemo (link) a ka e bula, 'me Nymbot ha e ke ea e tlosa hape. Botsa ka b64_json mme setšoantšo se hlahisitsoeng se tla ka karabong mme ha se k'en'oeng.
• Kahoo, na lifoto tseo u li fang ke generator? Setšoantšo seo u se hloehisang ho fetola, kapa u romele e le a data: URL ka har'a sa sehlahisi image_url, e hloletswe ho Blossom host e pepeneneng pele hore generator e khone ho e nka, 'me ntho e tšoanang e sebeletsa le eona. Setšoantšo se rometsoeng ke https:// konokotlo e fetisetswa jwaloka konokotlo eo. Litshwantsho tseo di le chat request di ya ho mofuta wa mofaki wa model, ntle le ho Blossom.
• Sefofane se amang le nym ea hau. Tsohle tseo konokana e qetang ho li sebelisa li tlosa ntlheng ea pebala ea nym ea hao, kahoo ho sebelisoa ha API hase unathata. Haeba u batla hore API e tsamaee e khetiloe ntle le nym ea hau ea letsatsi le letsatsi, etsa lintlha (keys) ho tsoa nym e fapaneng e nang le balanse ea eona e ikemetseng.

Haeba o hloka tšireletso ea li-app, sebelisa li-app. API ke bakeng sa nako eo o hlokang mahlale (models) ka lisebelisoa tsa hau tsa boithuto.

Sebaka se seng le se seng

“Nym” ho bolela kopo e saenoe ka mokhoa oa key ea hau ea Nostr, e hlalosoang ka ho saena lithoko tsa akhaonto. Bakeng sa lisebelisoa tse se setseng li bua liphetafetso tsena, bona lisebelisoa le SDKs, haeba ho le ba qapa lenane la khomphutha joalo ka Claude Code, Codex le Cline, bona lishano tsa ho ngola khoutu.