Bingeha zanînê / Dizayner/Pêşveber

Kurteya API

Model, generatîr û hevsengiya ku tu di aplikasyonê de bikar tînî, ji koda te ya taybet. API bi formatên OpenAI û Anthropic dipeyive, lewma piraniya amûr û SDK's bi guhertina URL-a bingehîn û kunc (key) yekê dixebitin.

Ev rûpel ji bo rehetiyê bi makîneyê hatiye wergerandin. Orjînala Îngilîzî guhertoya ku derbas dibe ye.

API çi ye

API-yekî HTTP li ser nymbot.ai ku heman daxwazên ku mişteriyekî OpenAI an Anthropic jixwe dişîne bersiv dide. Tu dibînin:

• Temamkirinên Chatê, ê API yên Bersivan û Peyamên Anthropic, bi streaming, amûr, wêneyan, rêberî û lêgerîna web, ji bo her modelê di kataloj û ji bo rêberiya otomantî ya Nymbot'ê bi xwe.
• Wêne, vîdeyo, axaftin, nivîsandin û embedding.
• Ya te hevsengî, Zêdekirinên Lightning, bi xolo ji hejayîyê we re nûkirinên otomâtîk û û dîrok bi ku her daxwaz bi çi bihayî çêdibe.

Ji heman duyan tê daxistin heqelî/bakiye wekî sepika, bi bi heman bihayiyan. Çayî abone û nîşaneya belaş li ser API nîne: her daxwaz bi krediyên ku te kirî tê dravdan kirin.

Tiştê ku API neketiye kirin ew e ku tiştekî xwedî Nymbot lê zêde bike. Peyamên we wekî ku we şandine diçin modelê: ne promptê sîstemê yê Nymbot heye, ne bîr, ne jî îşaretên dîrok an jî ziman hene. Tiştê ku vedigere bersiva modelê û tîp heye ya ku çi bi tohmet hatiye.

URL-ên Bingehîn

Her endpoint di bin ... de cih digire. /api/v1/Rêyek neyar vedigerî. 404 û rêyeke naskirî ku bi metoda wrong tê vekirin vedegere 405, her du jî wekî JSON.

API ji her malperê daxwazên cross-origin bersiv dide, loma rûpela brazerê dikare wê bixwîne. Lê belê, her tiştê ku tu dişînî brazerê, dikare ji hêla her kesê ku wê vedike ve bê xwendin, loma tenê bi kilekê (key) re wisa bike ku xwedî piçûk kulahEndpointên ku bi nîma (kîlên, kurteya hesabê, auto-top-up a NWC û daxwaza vegerandina pereyan) hatine îmzekirin istisnayî ne: di brauzerê de tenê bersiva malperên Nymbotê didin. Binêre daxwazên îmzekirina hesabî.

Her gava JSON bişîne bi Content-Type: application/jsonHer cure din bi ... tê redkirin 415, lê formeke HTML a sade an jî a text/plain daxwaza ji #> malpereke din nikare bigihîje API. Bi cURL, derbas bike -H "Content-Type: application/json" digel -d.

Kuncên API

Keran di applîkasyonê de tên çêkirin. Vekirin API di lîsteya alî ya sepan a webê de, an jî di menûya ser Android û iOS de, û bitikîne Miftê çêbikeNavêk bike û, heger tu bixwazî, kofî û dîroka derbasbûnê bide.

Mifte yek caran nîşan vedêde. Berî ku tu pelê bigirî, li cîhekî ewle kopî bike: Nymbot tenê şopê (fingerprint) wê digire, ji ber vê yekê nikare dîsa nîşanî te bide. Miftiyek windabûyî nikare were vegerandin; wê betal bike û yek din çêbike.

Mifteyek wiha xuya dike sk-nymbot- piştî 43 tîraj, rêng, xêz û underscores. App her kîleyî bi navê xwe û agahiyeke kurt wekî vê diheyîne: sk-nymbot-Qm7x…c2Lw.

• Mifteyek dikeve nav nîma (nym) te. Ew bêdana te xerç dike, û tenê nymê te dikare ew çêbike, biguherîne an jî betalkine. Her kesê ku kuncê di destê xwe de hebe dikare bi wê re xerç bike, lewma wekî peyvên sereke (password) bi wî re mijû bibin.
• Kaps di sats de ne. Mifteyek dikare sînorê xercê (spending cap) hebe, û ev sînor dikare her roj, her hefte (Duşanbe) an jî her meh (bera yekem), li dawiya saet 00:00 UTC reset bibe. Ew her du bilanstan jî hesab dike, krediyeke standard wek 10 sats û krediyeke Pro wek 100, ji ber vê yekê wateya wê wekhev e çi bilansek di daxwazê de xerc bike. Berî ku daxwazek bixebite, bi riya bilindtirîn mîqdara ku dikare biçî (bi krediyên tam ve hatî xala kirin) li hemberî wê yekê ku ji sînor maye tê de hatî danîn. Heke newere, daxwaz bi vê yekê tê redkirin: 403 key_limit_reached, heger bersiv di bin sînor de jî dibûya hatibe; xeletî dibêje çiqas maye û kengî sînor reset dibe. Kêmbukirin max_tokens Wê rewşa herî xerab kêm dike. Ji bo daxwazekê, biha yê ku bi rastî xerj kirî tê qutkirin û ew li hemberî sînor tê hesabkirin, lewla heke dabînkar zêdetir ji wan tokenên ku hatine veqetandin rapor bike, daxwaza dawî ya ku guncive dikare mifte hinekî ji sînorê wê derbas bike; paşê ya din tê redkirin.
• Kapakek xerjandî tenê xerjandinê disopîne. Mifteyek li ser qapa xwe dikare hîn jî hevsengiyê bipîçîne, dîroka xwe bixwîne, modelan bileyîze, tokenan bide hesab, reşîn bike û li vîdyoyeke ku jixwe dest pê kiriye bipîçe.
• Dema derbasbûnê vebijark e. Piştî dîroka ku te diye, perçeyê (ker) dixwazin dixwazin.
• Betalkirin yekserî û dawî ye. Mifteya ku hatî weratînkirin, di daxwaza xwe ya din de tê têkçûn. Di lîsteyê de dimîne, wek weratî hatî nîşankirin, da ku dîroka xerckirina wê hîn jî wate bike.
• Tu dikarî heta 25 kuncên çalak hebî, ku her yek bi navê xwe yên taybet hebe. Guhertina dema nûvekirina kuncêkê, dema nû li ser sifir dest pê dike.

Pergela hemanî nîşan dide xerckirina herîvekê di vê serdemê de û bi giştî, dema ku herî dawî hat bikaranîn, her du bilansekên we, û daxwazên API yên we yên dawî. Endpointên li pişt wê di bin vê navê de hatine belgekirin: birêvebirina kuncan.

Disarîkirina daxwazekê

Mifteya di yek ji van serlêdanan (headers) de bişîne. Ew wek hev in, lewma ya ku mîjîna (client) te bi default dişîne bikar bîne:

Kîyekî winda, neyarî, revoke bûyî an jî derbas bûyî vedigerîne 401, bi kodê re missing_api_key, invalid_api_key, revoked_api_key an expired_api_key. Listkirina modelan, modelên dengî û deng, û rêbazên dravdanê tu kilek naxwaze.

Wêne, vîdyo, axaftin, nivîsandin û embedding jî dikarin bi rêya Lightning bi yek daxwazê di her carê de bê daxistin bêyî ku tu tu carî klîdan bikî: daxwazê bê klîdan bişîne û faturaya di 402 bersiv. Binêre bê kuncê per daxwazî daxistin.

Birêvebirina kunc, kurtiya hesabê û zêdekirina pembeyan a otomaz istisna ne: ew li şûna kuncê, îmzeyek ji nymê we werdigirin, lewma kuncê ku derketibe nikare kuncên din çêbike. Binêre daxwazên îmzekirina hesabî.

Daxwaza te ya yekem

Mifteya di guhertoya hawirdorê de bixe, paşê ji modelekî pirsekê bipirse. Mînakên di nav van rûpelan de wî ji vê ve dixwînin 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 rêberiya Nymbot a bi xwe ye, ku ji hejmara standard tê dravdan kirin. Li şûna wê, ID-a modela katalogê bixe, wek mînak anthropic/claude-sonnet-5, ji bo bikaranîna wê modelê ji hejmara Pro. Lîsteykirina modelan hemû ID-yan dide.

Daxwazekê bi çi tê

Faturayê API tam wekî ku sepan diket didet.

• Kîjan bilanç. nymbot/auto xerçandine / derbas dike standard bakiye (10 sats kredî). Her modelê çatê yê din...) Pispor hembêrî (100 sats ji bo her kredi). Amûra çêkirina wêneyê standard û amûra dengê standard krediyên standard dixin; her amûreke din Pro dixin. Embeddings krediyên standard dixin. Transcription dema hembêrîya standard bikaribe wê biparêze krediyên standard dixin, û di encama din de krediyên Pro dixin. Lîsteya modelan diyar dike ka her model kîjan hembêrîyekê dixin.
• Çend e. Daxwaza sohbetê li ser tokenên ku model xwendiye û nivîsiye, bi rêjeyên ku pêşkêşkar weşandiye, tê hesabkirin. Ew biçax 5% sûc tê lê zêdekirin û paşê tê cudakirin bi 1.5 re, ji ber vê yekê tu 1.575 caran biçaxê lîsteya pêşkêşkarî didî. Ew li gorî biçaxê Bitcoin ê rastîn tê guhertin bo sats û bi hezarê kedanê tê hîsabin. Wêneyên profesyonel, vîdyo û axaftin li gorî çandina her yekê, li gorî her saniye an jî li gorî her tîpê tê biçaxkirin, û nivîskarî li gorî her saniyeya dengê audîو, bi heman sûc û qemerê tê kirin. Wêneyê standard 5 kedanên standard in û dengê standard 3 in.
• Kêmin. Her daxwaza ku bi pîvan (metered) tê kirin, kêmî 0.05 kredî dikişîne: yarê sat li ser hejmara standard, 5 sat li ser Pro. Parçeyên krediyê tên veguhestin, ne her carê tên bilindkirin.
• Bisekin, paşê aram bibe. Berî ku daxwazek dest pê bike, heqê herî mezin ê ku dikare biçêtiye, li gorî tiştê ku we şandibe û herî zêde ku dibe ku token binivîse, ji hejmara we tê ragirtin. Nivîsa derveyî ASCII ya sade ji byte-ên UTF-8 re tê hesabkirin, û hejmar û nîşaneyên ASCII wekî her yek token tên hesabkirin, lewma nivîsa di her alfabeyê de, kod û hejmar bi temamî tên ragirtin. Ragirtin di nav creditên temam de ye, herî kêm yek, lewma ji bo destpêkirina her daxwazekê divê herî kêm 10 sat di hejmara standard de an 100 sat di Pro de hebin. Tenê heqê rastîn tê barkirin; ya mayî dema ku daxwaz bi dawî dibe tê berdan. Daxwazeke dirêj ragirtina xwe heta demê ku dixemijîne parastina dike; heger creditên ragirtî bi her awayî nebin berdest, herikîn (stream) bi... 402 insufficient_balance bûyeya xeletiyê, û tiştê ku hatî hilberandin hat barkirin. Heke heqê rastîn ji wisa ku hejmar be zêdetir be, hemû hejmar tê girtin, ya mayî wek verejin tê hesabkirin (owed_sats di nymbot objekt, û bakiyeleyek neyativ). Tiştê ku ji berê heye berî her tiştî ji krediyên ku tên wê bakiye de tê dan. Heta ku neyê dan, tu tişt ne bi rêya API, ne bi bersivên di nav app de, ne bi transfer an jî bi diyari dikare bê xarna wê bakiye.
• Krediya têr nake. Heke hejmar nekaribêje daxwazê biparêze, daxwaz tê redkirin bi 402 berî ku tiştek bixebite. Error dibêje ku kîjan balance kêm e, reqest çend sat reqet dike û çend hene. Yekî piçûktir max_tokens bi wateya saxistineke piçûktir.
• Şikestin. Daxwazeke ku bi ser neketinê dimîne bi tiştekî nabe, melavê heger pêşkêşkar ji bo xebata ku berî ser neketinê kiribe wekî xerc hesab kiribe, an jî lêgerîna web an jî nymbot/auto Tareke hatibû kirin; paşê ew tiştê tu vedixwî, her herî kêm 0.05 kredî ye. Stîrêka (stream) ku tu dikişînî, ji bo wan tokenan tê daxistin ku pêşkêşkar rapor dike: Nymbot heta 25 saniyeyan piştî ku tu çûyî, berdewam dike xwendina stîrêka pêşkêşkar da ku wî hejmarê bistîne. Heke ew neyê, daxistin ji wê tiştê ku te şandiye û wê tiştê ku hatî nivîsandin tê nirxandin, û ji bo modeleke ku ramanê dike, hemû deqa derûnî ya daxistina holdê di nav de ye. Daxwazeke ku têkiliya wê diçe, hîn jî qediya dibe û tê daxistin.
• Li ser we web Her lêgerîn 0.008 dolar dikiro, ku tê veguherîn satsan, her kengî lêgerînek pêk dehat, çi model bersiv bide çi jî bi ser neketin. Rûpelên ku dixwîne jî wekî daneyên hevber (input) tên şandina ji bo modelê, lewira ew jî tokenên xwe lê zêde dikin.

Her bersiv dibêje ka çi bi tozelî ye. Bersivên JSON dihewînin a nymbot objekt bi hejmara ku ji wê hatîye dan, xerca bi kredî û satan, û ya mayî:

Objeyta costê

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

Bersivên bi drav jî van sernavan (headers) li xwe digirin, ku ew cih e ku mirov ji bo hêla cost/çarenûsa bersivekê lê bigere ku JSON nîne, wek mînak: axaftin:

Bi mîlyonan tokenan navber, ku berçav bi mucib û qeraxê re hatine heftkirin, di .... de ne Lîsteya modêlan bi dolar û satstan, û li ser êşiya fîşê firotinê. Heke bihayê Bitcoin nedîtbar be, daxwazên bi drav vedigerin 503 price_unavailable bi / digel Retry-After: 60 li şûna ku ez xeyal bikim.

Xeletî

Her şaşiyek heman şêwe ye, ew ya ku mişteriyên OpenAI jixwe fêm dikin. code navê wekîdest e ku tu dikarî lê bisekini; message Ji bo mirovan e û dikare biguherî.

Erdora xeletiyê

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

Du istisna:

• /api/v1/messages bersiv di formata xeletiyê ya Anthropic de, ji ber ku ew tiştha ku clientên Anthropic pars dikin: {"type": "error", "error": {"type": "authentication_error", "message": "…"}}. Cure li pey rewşê tê: invalid_request_error, authentication_error, billing_error (402), permission_error, not_found_error, request_too_large, rate_limit_error, api_error an overloaded_error (503).
• Daxwazeke streaming ku berî ku yekem byte biêre, bi şaşiyeke JSON a gewş bi statûya jorîn tê kirimandin, ne wekî event stream. Şaşiyek piştî destpêkirina streamingê wekî dawiya dawî ya streamingê, bi formata taybet a wê endpointê tê şandin.

Peyamên şaş qet hûrgiliyên hundurîn ên xizmeteke din nîşan nedin. Şaşiya xwediyê xizmetê beriya ku bigihîje te tê dubarekirin.

Sînor

Lînkeke wêneyî divê nîşanî mêvanekî (host) giştî bide: sernavên li ser tora taybet an ya lokal, an jî li ser malperên Nymbotê yên xwe, têne redkirin. Kontrolkirina leza radêyê ya ku di aplikasyonê de hatiye bikaranîn li vir jî hatiye bikaranîn, ji ber vê yekê, leza daxwazên zêde yên ji bo yek radêyî dikare were lawazkirin li şûna ku bi awayekî têkçûyî bê.

API dikare çi bibîne

API wekî ku sepan (apps) ne privayî ye, û nirx heye ku mirov bi hûrgulî behsa ka çawa ye bike.

• Encrypsiyona wê ya ji berê heta dawiyê nîne. Di appan de, peyamek li ser amûra te bi mifteyan tê girtin ku tenê Nymbot dixîne û wekî... pakêtkirina bilaşkirinê. Daxwaza API ya asayî HTTPS e: ew di rêya çûyîna Nymbot de tê şîfrekirin, û serverê Nymbot wê bê şîfre dixwîne da ku wê bi rêve bibe.
• Prompts û bersiv ne têna pakarkirin. Ew diçe ser modelê û bersiv vedigere. Tiştê ku tê parastin fatora ye: ji bo her daxwazê dem, model, cure, hejmara tokenan, bihay, hejmarê bakiye, tîp û ka bi ser ket an na, ji bo 90 rojan, ku ew e dîroka pirsiyarên (query history) nîşanî te dide. Rekorda bikaranîna daxwaza heman (dem, cure, model, hejmara tokenan, bihayî, dem) jî ji bo 90 rojan tê parastin, ligel ya serlêdayî ya aplikasyonê.
• Hemû tiştên din ên ku ji bo nym tên parastin piçûk in û li vir hatine lîstirkirin. Kuncên API wek hash tên parastin, qet ne mifte, bi navê wan, îşareteke kurt, sînorê xercê, demhandera nûkirinê, dembereskê û kengî hatine çêkirin û bingehê herî dawî hatine bikaranîn; tenê 50 kuncên revoke kirî yên herî nû têne parastin. An tije kirina otomâtîk Têkiliya waletê bi şêweyek şîfrekirî tê parastin, bi seredariya wê, mîqdar û encama dawî ya zêdekirina waletê re. Karên vîdyoyê ji bo 24 saetiyan tên parastin. Daxwazên ku bi her bangê tên dan, tenê 'hash'-ekî dravdanê yê Lightning ji bo 7 rojan û 'token'-ekî vegerandinê yê şîfrekirî ji bo 30 rojan li pey xwe dimînin, ku bi tu navn ve girêdayî ne. Karxaneyên ku bilansek naxwazin, heta ku bi zêdekirinê werin dan, wekî qerçiyan tên parastin.
• Paşistina appê wê jê dihilîne. A Paqijkirina amîrê hemû kuncên API bêunden û jêder dike, û dîrok û daxwaza lêgerînê, rekordên bikaranîna, girêdana waletê û karên vîdyoyê jêder dike. Bakiye û her alîgiriyên (charge) ku hîn jî li ser in, li ser nym dimînin.
• Dîdarê modelê daxwaza te dibîne, wekî ku ji aplikasyonê tê; modelên katalogê li cem çêkirvanên xwe dixebitin; rêyên standard û embedding li ser Cloudflare dixebitin.
• Medyayên afirandinî giştî ne. Wêne û vîdyoyên wekî lînk tên pêşkêşkirin di hostên fîlên Blossom ên giştî de tên barkirin, ku li wir nirxa fîlekê hashê wê ye. Her kesê ku lînkê hebe dikare veke, û Nymbot nikare dîsa wê bixe navber. Bipirse ji bo b64_json û wêneyekî hatî çêkirin di bersivê de vedigeret û tu carî nayê barkirin.
• Nexwe wêne yên ku tu didî generatork in? Wêneya ku tu dikeyî ser sererast bike, an jî wekî ... bişînin data: URL di nava çêkeran de image_url, pêşî li hostekî Blossom ê giştî tê barkirin da ku generatôr bikaribe wê werbigire, û heman tişt ji bo wê jî hatiye gotin. Wêneya ku ji aliyê ... ve hatîye şandin https:// Girê wekî wê girê tê hundirîn kirin. Wêne di daxwaza sohbetê de diçin cem pêşkêşkarê modelê, ne ji bo Blossom.
• Mifteyek bi nymê te re girêdayî ye. Her tiştê ku rîveçûneke kunc (key) bi dareke wî ve diçe, ji hejmara nymê we derdikeve, ji ber vê yekê bikaranîna API ne nānîmHeke tu dixwazî API bikar bînî wekî ku ji nîma (nym) herdemî ya te veqetî be, kunceleri ji nîmeke (nym) cuda û bi bilesê (balance) xwe ve ava bike.

Heke tu hewceyî parastina appsan bî, appsan bikar bîne. API ji bo wê demê ye ku tu hewceyî modelan bî di amûrên xwe de.

Her endpoint

"Nym" tê wateya daxwazek ku bi kuncê Nostr ê te hatiye îmzekirin, ku di ... de tê danasîn. daxwazên îmzekirina hesabîJi bo amûrên ku jixwe bi van formatan diaxivin, binêre Amûr û SDKs, û ji bo ajanên kodkirinê yên wekî Claude Code, Codex û Cline, binêre dibistanên kodkirinê.