Bażi ta 'għarfien Żviluppaturi
Taħdiss tal-API
Il-modelli, il-ġeneraturi u l-ibvilupp fuq xogħol li tuża fl-app, mill-kodiċi tiegħek stess. Il- API jitkellem fil-formatijiet OpenAI u Anthropic, għalhekk la maggioranza tal-għodod u SDKs jaħdmu billi tbiddel URL bażi u chiave.
Din il-paġna hija tradotta bil-magni għall-konvenjenza. L-oriġinal bl-Ingliż huwa l-verżjoni li tapplika.
X'inhu l-API
An HTTP API fuq nymbot.ai li jwieġeb l-istess talba li klijent ta' OpenAI jew Anthropic juża diġà. Inti tikseb:
- Chat Completions, it- API tal-Risponsijiet u Messaġġi ta' Anthropic, b'streaming, għodod, ritratti, raġunament u ħarċ x search fuq il-web, għal kull mudell fil- katalogu u għall-auto-routing ta' Nymbot stess.
- Immaġni, videwjo, diskors, transkrizzjoni u embeddings.
- Tiegħek bilanċ, Top-ups tal-Lightning, top-ups awtomatiki mill-portafollju tiegħek u u storja ta' kemm iħkost kull petizzjoni.
Il-ħlas qed jiġi mitlaq mill-istess tnejn bilanci bħall-app, bi l-istess prezzijiet. M'hemm l-ebda सब्सkripsjoni u l-ebda allokazzjoni gratis fuq l-API: kull talba hija mixtrata b'krediti li xtaqqajt.
Dak li l-API ma jagħmilx huwa li jżid xejn mill-parti ta' Nymbot stess. Il-messaġġi tiegħek imorru għall-mudell kif xtaqqithom: l-ebda prompt tas-sistema ta' Nymbot, l-ebda memorja, l-ebda suġġerimenti ta' data jew lingwa. Dak li jerġa' jmorri huwa l-risposta tal-mudell u nota ta' kemm kosta.
URLs ta' Bażi
| Uża | URL tal-Bażi |
|---|---|
| SDKs tal-OpenAI u għoddan kompatibbli mal-OpenAI | https://nymbot.ai/api/v1 |
| SDKs ta' Anthropic u Claude Code | https://nymbot.ai/api (l-SDK iżid /v1/messages stessu) |
Kull endpoint jinsab taħt /api/v1/Triq mhux magħrufa tirritorna 404 u
path magħruf imsejjaħ bil-metodu l-𝗶ġġuriet jirritorna 405, it-tnejn bħala JSON.
L-API twieġeb mistieba cross-origin minn kull sit, għalhekk paġna tal-browser tista' tepċiha. Iżda, kull şey li tibgħat għal browser tista' tinqara minn kull min jiftaħha, għalhekk agħmel dan biss b'ċwieċella li għandha limitazzjoni żgħira kapL-endpoints imsignati bil-nym tiegħek (keys, it-sommarju tal-kont, l-auto-top-up tal-NWC u r-redemption tal-refund) huma l-esċezjoni: f'browser huma jirrispondu biss għas-sitijiet proprji ta' Nymbot. Xoff taħsig tal-joni tal-akkunttijiet.
Ibgħat kull JSON body b' Content-Type: application/json. Kull tip ieħor jiġi
rifiżat b' 415, maka fformularju HTML sempliċi jew 🙃 text/plain talba minn
sit ieħor ma jistax jilħaq l-API. B'ċURL, passa
-H "Content-Type: application/json" flimkien ma -d.
Keys tal-API
Il-klaviijiet huma magħmula fl-app. Iftaħ API fil-sidebar tal-app tal-web, jew fil- menù fuq Android u iOS, u tgħaqqab Tħoliq ta' klaviĠżejjituha b'isem u, jekk tixtaq, kap u data ta' skadenza.
Il-klavijiet tidher darba biss. Kopjaha f'post sigur qabel ma tagħlaq il-folja: Nymbot iżomm biss fingerprint tagħha, għalhekk ma tista' turiha lil kif għaliqha. Klavijiet mitluba ma jistgħu jinstabux; revokaha u agħmel oħra.
Fenkata tidher bħal sk-nymbot- dejta segwita minn 43 ittra, numri, dażijiet u
underscores. L-app lista kull klavijiet bl-isem tagħhom u suġġeriment qasir bħal
sk-nymbot-Qm7x…c2Lw.
- Ċav le jappartieni lill-nym tiegħek. Huwa juża l-ibdal tiegħek, u biss in-nym tiegħek jista' jagħmel, ibiddel jew jiddeċiedi għalih. Kullox li għandu l-klavijiet jista' juża bil tiegħu, għalheku ittrattah bħala password.
- Il-caps qegħdin fis-sats. Il-klavijiet jistgħandhom ikollhom limit ta' spese, u l-limit jista' jiġi riċċetta
kull jum, kull వార (L-Etna) jew kull xahar (l-ewwel), às 00:00 UTC. Huwa jikkalkula Żewġ
bażi, kreditu standard bħala 10 sats u kreditu Pro bħala 100, quindi Dan jibni l-istess
ir-riżultat inkluż kemm jkun il-bażi li telfu r-requistjoni. Qabel ma r-requistjoni timxi, l-aktar li tista' tikostja
(immaffuta għal krediti sħiħi) tiġi ssetgħa kontra dak li għadu baqi mill-limit. Jekk ma tiffittrax,
ir-requistjoni tiġi rifiċuta b'
403key_limit_reached, anke jekk il- risposta kienet se tiġi taħt il-limit; l-errore jgħid kemm għadu baqi u meta l-limit jirissetta. Innersarmax_tokensitnahetta dak il-każ l-aktar terbbuħ. Ritruv tal-ħlas jiġi ċċarġat bi dak li kkostaw fil-fatt u dan jinqasas mill-limitu, għalhekk jekk il-fornitur jirrapporta aktar tokens minn dawk li kienu maħsieba, l-aħħar ritruv liffiċja jista' jieħu l-klavijiet ftit oqreb mill-limitu tiegħu; ir-ritruv li jmiss dinhar jiġi rifjutat. - Kap maħsuda biss twaqqaf is-separazzjoni tal-ħlas. Ċav tal-kapaċċini tiegħu still jista' jiċċekkja l- bilanċ, jaqra l-istorju tiegħu, jlietja mudelli, jgħażżel tokens, jibża' u jiċċekkja videw meta ijaqsam wisq.
- L-iskadenza hija Wara d-data li ħareġt, il-klavijiet tiegħu jieqaf ta' jaħdem.
- Ir-revoka hija immedjata u finali. Ċaviet revokat iħwievi li r-rigadu tiegħu jfajja. Jidħol fil-lista, immarkat bħala revokat, sabiex l-istorja tal-infaq tiegħu tibqa' tiskriva ħelu.
- Tista' jkollu sal‐aħħar 25 keys attiv, kull wieħ b'isimu stess. Il-bidla fil-periyodu ta' reset ta' kisi tbda periyodu ġdid minn zero.
Il-istess folja turi l-infirmar ta' kull klavijiet f'dan il-periodu u totalment, meta kienet muta l-aħħar darba, iż-żewġ saldi tiegħek, u r-requisiti API reċenti tiegħek. L-endpoints waraha huma dokumentati taħt ġestjoni tal-klaviets.
Awtentikazzjoni ta' talba
Ibgħat il-klavijiet f'xi waħda minn dawn il-headers. Huma ekwali, għalhekk uża kwalunkwe li l-klijent tiegħek ibgħat b'mod awtomatiku:
| Kapital | Sent minn |
|---|---|
Authorization: Bearer sk-nymbot-… | OpenAI SDKs, l-aktar għodod, Claude Code ma' ANTHROPIC_AUTH_TOKEN |
x-api-key: sk-nymbot-… | SDKs ta' Anthropic |
api-key: sk-nymbot-… | Klijenti b'stil Azure |
Ċewġ, mhux magħruf, revokat jew skadut jirritorna 401, bil-kodiċi
missing_api_key, invalid_api_key, revoked_api_key jew
expired_api_keyIl-lista tal-modelli, il-modelli tal-awdjo u l-vuċċi, u l-metodi ta' pagament
ma teħtieġ nothing key.
Ritratti, videw, diskors, transkrizzjoni u embeddings jistgħu wkoll jiġu mħalsuş għal każ-każ fuq Lightning mingħajr l-ebda klavijiet: ibgħat ir-requiest mingħajr wieħed u ħallas l-fattura fil- 402 tweġib. Xogħol ħlas għal kull talba mingħajr
ċwieċ.
Il-ġestjoni tal-klavi, is-sommarju tal-kont u t-top-ups awtomatiċi huma l-istess eċċezzjoni: they jieħdu sigatura mill-nym tiegħek minflok klavi, għalhekk klavi li ntabbaħ ma tista'xxepp ma twieleġ ebda klavi oħra. Tara taħsig tal-joni tal-akkunttijiet.
Ir-rigwiż tiegħek l-ewwel
Put il-klavijiet f'varjabbli ambjentali, imbagħad istaqsi mudell xi ħaġa. L-eżempji minnufih
dawn il-paġni jaqrawha minn 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 huwa r-routing proprju ta' Nymbot, ippagħata mill-bażi tal-livell standard.
Put an id tal-mudell tal-katalogu hemm, bħal anthropic/claude-sonnet-5, biex tuża dawk il-mudell
mill-balanċ Pro. Lista tal-modelli jagħti kull ID.
Kemm iħkost talqauda waħda
L-API taċċipja l-fatturi eżattament kif tagħmel l-app.
- Liema bilanċ.
nymbot/autoiqspent il- standard bilanċ (10 sats u kredit). Kull mudell ta' chat ieħor iqatta' l- Pro bilanċ (100 sats kreditu). Il-ġeneratur tal-immaġni standard u l- ħarfiena tal-leħen standard jusejnu krediti standard; kull ġeneratur ieħor juża Pro. L-Embeddings jużaw krediti standard. It-Transkrizzjoni tuża krediti standard meta l-bilanċ standard jista' jikkoveriha, u krediti Pro otherwise. Il-lista tal-modelli tgħid liema bilanċ kull mudell juża. - Kemm? Il-chat request huwa ikalkulat fuq it-tokens li l-mudell qalaq u kiteb, fuq ir-rati mapplikati mill-fornitur. Dak il-prezz għandu fee ta' 5% miżjat u mbagħad jiġi mmultiplikat b'1.5, għalhekk tħallas 1.575 ż fois il-prezz tal-lista tal-fornitur. Huwa jiġi konvertit għal sats fuq il-prezz live tal-Bitcoin u jiġi ċċarat f'milja partijiet mill-kreditu. Ritratti pro, video u diskors huma prezzati għal kull ġenerazzjoni, għal kull sekonda jew għal kull karakter, u t-transkrizzjoni għal kull sekunda ta' awdyo, b'l-istess fee u margin. Ir-ritratt standard huwa 5 krediti standard fiss u l-leħen standard huwa 3 fiss.
- Il-minimun. Ħarġa kull talba immetrata li tmexxi tiksiż ít-tlieta mill-inqas 0.05 kredit: nofs sat fuq il-baċċit standard, 5 sats fuq il-Pro. Frazzjonijiet ta' kredit jiġu mġarrra, mhux imġabbbin kull darba.
- Żomm, imbagħad settla. Qabel ma gira talba, l-akbar ammont li tista' jikkostta jiġi żżomm
mill-bażi tiegħek, ibbażat fuq dak li göndert u l-massimum ta' tokens li tista' tikteb. It-test barra
mill-plain ASCII huwa miżen fuq il-bytes UTF-8 tiegħu, u d-difiċit u l-punteggjazzjoni ASCII każda kontaw bħala token wieħed, għalhekk it-test f'sistemi ta' skriptiijiet kullwiegħed, kodiċi u numri huma żżommom għal kollox. Il-qbid huwa f'
krediti sħiħi, mill-inqas wieħed, għalhekk kull talba teħtieġ mill-inqas 10 sats ħielsa fuq il-bażi
standard jew 100 sats fuq Pro biex tibda. Solamente l-kost attwali jiġi ċċarġat; il-bqija jiġi rilassat
meta tispiċċa. Talba twiega żżomm il-qbid tagħha għall-konsegwenza li tkun qed tiġri; jekk il-krediti mażżomom
jieppu disponibbli għal xi raġuni oħra, stream jieqaf b'a
402insufficient_balanceavvent ta' żball, u dak li ġie ġenerat huwa ċċarġat. Jekk il-kost attwali huwa aktar minn quello li l-bażi tista' tħallas, il-bażi kollha tieħu, il-bqija tkun dovuta (owed_satsfil-nymbotoġġett, u bilanċ negattiv). Dak li jkun dovut jiġi pajat l-ewwel mill-krediti li jkunw għadhom jaslu għal dak il-bilanċ. Sakemm ma jiġišx pajat, xejn fuq dak il- bilanċ ma jistax jiġi spese: lanqas mill-API, risposti fl-app, trasfert jew rigal. - M'hemmx kreditu biżżejjed. Jekk il-bażi ma tistaxx cover il-hold, id-talba tiġi
رفض b'
402qabel ma r-run jidħol. L-error jgħid li liema bilanċ huwa naqs, kemm sats jeħtieġ il-requiest u kemm hemm ħielsa. Xi wieħed iżgħarmax_tokenstifsid holdiりħs hơn. - Fallimenti. Talba li ma taħdimx ma tikollx konsegwenzi, ħlief jekk il-fornitur iċċajja għall-xogħol li għamlet qabel ma tfaċċja l-ħnien, jew tfriġa fuq il-web jew il-
nymbot/autotask ċekk ifaħdt; imbagħad dak hu li tħallas, mill-inqas 0.05 credit. Stream li tnaqqas ti ħallas għall-tokens li r-rapporta l-fornitur: Nymbot ikompli jaqra l-stream tal-fornitur għal saħħa ta' 25 sekundiet wara li titlaq biex iġib dik il-kontanza. Jekk ma tasalx, il-charge jiġi stimat mill-post li lestijiet u dak li kien miktub, u għal mudell li jagħmel reżonament jinkludi l-limitu kollu tal-output tal-hold. Request li tinstab tieqaf il-konnessjoni tagħha għadu jtemm u jiġi ċċarġat. - Ispazju tal-web ikostja $0.008 għal kull ħarċa, konvertita għal sats, kull meta ħarċa ġiet imdejja, kemm jekk il-mudell iwieġeb jew joffri l-ebda risposta. Il-paġni li jaqra huma wkoll imkejja lill- mudell bħala input, għalhekk huma jżiddu l-tokens tagħhom.
Mhux kull risposta tgħid x'kienet il-kostijiet tagħha. Risposti JSON iġġibu a nymbot oġġett b'
l-osservazzjoni li nħallset minnha, l-prezz f'krediti u sats, u x'hemm fuqha:
L-oġġett tal-kost
"nymbot": {
"balance": "pro",
"charged_credits": 0.162,
"charged_sats": 16.2,
"balance_credits": 412.425,
"balance_sats": 41242.5
}
Risponsijiet maħsubs ġġorbu wkoll dawn il-headers, li hija fe trid tfittex il-kost ta' rispons li mhux JSON, bħal diskors:
| Kapital | Meaning |
|---|---|
X-Nymbot-Cost-Sats | Kemm iħallas din ir-requesta, fis-sats. |
X-Nymbot-Balance-Sats | Kemm għandek f'resto fuq il-balanċ li npayat minnu, fis-sats. |
X-Request-Id | ID għall-joni tal-joni, fuq kull risposta. Iċcitaha jekk tkontattja l-appoġġ. |
Ir-rati għal kull miljun token, li huma ewlement inklużi l-ħarfien u l-margini, huma fil-
lista tal-modelli f'dollars u sats, u fuq
il-lista tal-prezzijiet. Jekk il-prezz tal-Bitcoin ma jistax jitqara,
talbija magħdija tirritorna 503 price_unavailable ma'
Retry-After: 60 minflok ma tgħammel tqatta' ġesti.
Erruri
Ħarba kull żball għandu l-istess x Malta, dak li l-klijenti ta' OpenAI jużaw wisq. code huwa
isem stabbli li tista' tużah biex timmatchja; message hu għal nies u jista' jinbidel.
Body tal-error
{
"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
}
}
| Status | Meta |
|---|---|
400 invalid_request_error | Il-body mhux JSON validu (invalid_json), kamp fejmpjat huwa nież 부족 (missing_required_parameter), valur huwa ħażin, jew it-talba titlob xi ħaġa li l-mudell jew l-endpoint ma jagħmilux, bħal għodod imdaqqa nymbot/auto (unsupported_tool). param isem il-qasam. Ukoll upstream_rejected meta l-fornitur irrifjuta t-talba. |
401 authentication_error | Il-klavijiet mhux preżenti, mhux magħrufa, revokati jew skaduti, jew talba imxemmla mhux validi jew riużata. |
402 insufficient_quota | Il-bażi ma tista'x cover it-talba. Code insufficient_balance, b' balance, required_sats u balance_sats. |
403 permission_error | Id-talba ma taqgax fil-kapa tal-klavixxura (key_limit_reached, b' limit_sats, used_sats u reset_at), jew l-account jista' ma jużawax is-servizz (account_denied). |
404 not_found_error | Triq mhux magħrufa (unknown_endpoint), mudell li ma jkunxxistenti (model_not_found), jew klavijiet mhux magħrufa, fattura jew videw. |
405 | Il-path jesisti imma mhux b'dak il-metodu (method_not_allowed). Il- Allow il-header jiddindikkar il-metodi li jieħu. |
413 | Il-body jew il-fajl huwa żgħir wisq (payload_too_large, file_too_large), jew reġistrazzjoni hija tul wisq (audio_too_long). Tara limiti. |
415 invalid_request_error | Il-ġisem ma jiġiex sentri bħala application/json (jew, għall-endpoints tal-upload, multipart/form-data): unsupported_media_type. |
422 | Leħen u lingwaġġ li ma sejrinx flimkien f'test għal leħen (voice_language_mismatch, unsupported_language). |
429 rate_limit_error | Siti tal-kotijiet wisq fuq din il-klavijiet, minn dan l-indirizz, jew b'kredenzjali li żammew biex jiġu verifikati (rate_limit_exceeded), jew il-fornitur qed jagħmel rate-limiting (upstream_rate_limited). Waitar is-sekondi f' Retry-After. |
500 api_error | Żamm xi ħtul sar minn naħa ta' Nymbot (internal_error). |
502 api_error | Il-fornitur ma raddxxax tweġiba (upstream_error), jew ma setgħetx tiġi magħmula fattura ta' Lightning (invoice_unavailable). |
503 api_error | Il-fornitur huwa sovrachkantat (upstream_overloaded), l-prezz tal-Bitcoin ma jistax jitqara (price_unavailable), jew parti mis-servizz hija waqfa (service_unavailable, media_hosting_unavailable). Retry-After jgħid meta jipprova mill-ġdid, fejn huwa magħruf. |
Żewġ esċezzjonijiet:
/api/v1/messagestweġibiet f'format ta' error ta' Anthropic, poiché huwa dak li l-klijenti ta' Anthropic janalizzaw:{"type": "error", "error": {"type": "authentication_error", "message": "…"}}. It-tip issegwi l-status:invalid_request_error,authentication_error,billing_error(402),permission_error,not_found_error,request_too_large,rate_limit_error,api_errorjewoverloaded_error(503).- Riqjesta ta' streaming li tfajjet qabel ma l-ewwel byte tiegħha jiġi rċevut iġġib error JSON ordinarju b' l-istatus fuq, mhux event stream. Ftal wara li l-stream jibda jiġi bagħat bħala l-l-aħħar event tal- stream, fil-format proprju ta' dak l-endpoint.
Ir-rectoli tal-error qatt ma jinkontrazzaw dettalji interni ta' servizzIEħor. L-error proprju ta' fornitur jiġi rippubblikat qabel ma jasal għandek.
Limiti
| Limit | Valur |
|---|---|
| Talbet għal kull ċav | 120 kwaċċata fiduċi. Fuq dak, 429 ma' Retry-After. |
| Talpeti mingħajr ċav | 120 għal minuta għal kull indirizz, għall-lisings tal-mudell, tal-awdjo u tal-metodu ta' pagament, checks tal-token tal-refund, u endpoints multiplikati mingħajr chiave jew pagament. Fuq dak, 429 ma' Retry-After. |
| Autentikazzjoni fallita | 30 għal minuta għal kull indirizz għal keys, signatures, payment credentials u refund tokens li ma jiċċertifikawx. Fuq dak, kull talba mill-indirizz li terbbu credential tirċievi 429 ma' Retry-After sakka' l-minuta tispiċċa. Il-kredenzjali jiġu verifikati qabel ma jinqara' l-body. |
| Ċwieki ġodda | 60 skali siegħa għal kull nym u 120 skali siegħa għal kull indirizz. |
| Fatturi ta' top-up | 60 skali siegħa għal kull nym u 120 skali siegħa għal kull indirizz. |
| Konnessjonijiet tal-wallet NWC | 10 flus fis-siegħda għal kull nym u 30 flus fis-siegħda għal kull indirizz. Il-wallet relay għandu juża wss:// fuq il-port standard. |
| Refund tokens | 60 talba kwal minuta għal kull token. |
| Indirizzi | L-indirizz IPv6 huwa kontabbiliti bħala l-kollox /64 tiegħu f'kull limit għal kull indirizz, u indirizz IPv6 mappat għal IPv4 bħala l-indirizz IPv4 tiegħu. |
| Body tal-িanket JSON | 4 MB; 64 KB għal talbiji imxemmija bil-nym tiegħek. |
| Body tal-talba multipart (tal-upload) | 32 MB. Immaġni għat-editjoni tista' tinmaxxi għal 20 MB, fajl tal-awdjo sal-25 MB. Mass importantly 64 partijiet, kull waħda b'mass ta' 8 KB ta' headers tal-parti, u limit ta' 1 għal 70 karakteri; otherwise 400 invalid_multipart. |
| Ritratti f'rejista ta' chat waħda | 20. Kull wieħ huwa https:// jew http:// link għal host pubbliku, jew isang data:image/… URL. |
| Immaġni għal kull talba ta' ġenerazzjoni | 1 għal 4 (n) |
| Tokens tal-output | Limitat għall-massimu proprju tal-mudell. Xi akbar max_tokens inqass lejh, mhux irrifjutat. |
| Input tal-kliem | 800 karakteri għall-leħen standard, 2,000 għal Aura 2. |
| Traskrizzjoni | 30 minuti ta' audio, 25 MB. Rekordazzjoni aktar twila hija rfiduta b' 413 u mhux iċċarġat, anke meta t-tul tagħha jkun magħruf biss malli Whisper ikun semgħuha. |
| Embeddings | 100 inputijiet għal kull talba. |
| Xogħolijiet ta' videwju | Miżżum għal 24 sigħat wara li jiġu sottomettuti; render wieħed jiġi rilegat wara siegħa. Massimu ta' 10 rendering flimkien għal kull nym. |
| Istorja tal-query | Miħżum għal 90 ġurnata. |
| Ċavijiet attivi għal nym | 25. Doċi biss l-aħħar 50 keys revokati jiġu żżommu. |
Link għal ritratt għandu jagħti lejn host pubbliku: indirizz fuq netwerk privat jew lokali, jew fuq is-sitijiet stess ta' Nymbot, jiġi rfiżut. Il-pacing tal-fornituri li japplika fl-app japplika hawnhekk ukoll, għalhekk burst ta' reqqiesta lil fornitur wieħed jista' jiġi rallenta minnxijen li jinfaċċja żżmien ta' żmien.
Dak li l-API tista' tara
L-API mhux privata bħal kif huma l-applikazzjonijiet, u worth li tkun eżatt dwar kif.
- Mhuwiex enkriptat minn estrem għal estrem. Fl-applikazzjonijiet, messaġġ huwa sigillat fuq l-apparat tiegħek b'klaviżijiet li biss Nymbot iżżommu u jivvjaġġa bħala bwraping rigal. Request tal-API huwa HTTPS ordinarju: huwa encrypted fit-triq lejn Nymbot, u s-server ta' Nymbot jaqrah b'test açık biex jifhdimh.
- Prompts u rispondi mhumiex maħżuna. Huma jgħaddu through għall-mudell u l- tweġiba tgħaddi lura. Dak li jiġi żżomm huwa l-fattura: għal kull talba l-ħin, il-mudell, it-tip, l-għadd tat-tokens, il-kost, il-bażi, il-klavijiet u jekk suksess iva, għal 90 jum, li huwa x'e tal-istorja tal-istampa jurik. Rekord tal-użu tal-istess talba (ħin, tip, mudell, kontijiet tat-token, prezz, durata u jekk uża x search fuq il-web jew suksess) huważ ugliż miżmum għal 90 ijjem, flimkien ma' dak tal-app stess.
- Kollox l-oħra li żomm għal nym huwa żgħir u huwa rlistat hawn. Keys tal-API jitżammu bħala hash, qatt mhux il-key, b' isemhom, ħhint qasir, limit tal-ħarsiexa, perjodu ta' reset, skadenza u meta saru u l-aħħar darba użaw; biss l-aħħar 50 keys li nkablu jiġu żżammija. An top-up awtomatiku il-konnessjoni tal-wallet hija mistokja enkriptata, b'il-threshold tiegħu, l-ammont u r-riżultat tal-aħħar top-up. L-impjiegi tal-vidjow huma miżmumin għal 24 sigħa. Nirazzjonijiet maħqudin għal kull sejħa jħallu biss hash ta' pagament Lightning għal 7 ijiem u token ta' refund hashed għal 30 ijiem, ma jkunx marbut ma' n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n
- Meta tmeħxa l-app, tmeħha wkoll. A tħassir tad-device jirrevoka u jiddelite kull API key, u jiddelita l-istorik tal-query, ir-rekords tal-użu, il-konnessjoni tal-wallet u l-xogħolijiet tal-vidjow. Il-bażi u kwalunkwe ħlas li għadu jkun dovut jibqgħu fuq in-nym.
- Il-fornitur tal-mudell jara r-requesta tiegħek, kif tagħmel mill-app. Modelli tal-katalog ġewwa l-makers tagħhom; rotte standard u embeddings jiġu iffurmati fuq Cloudflare.
- Il-media generat huwa pubbliku. Ir-ritratti u l-vidjows ipprovduti bħala links huma
imniet fuq host ta' files pubbliċi ta' Blossom, fejn l-indirizz ta' file huwa l-hash tiegħu. Kullox ma għandu l-
link jista' jiftaħu, u Nymbot ma jistax jneħħih mill-ġdid. Istaqsi għal
b64_jsonu r- ritratt ġenerat jiġi lura fir-risposta u qatt ma jitgħallef. - Għalhekk, ir-ritratti li tagħti huma generator? Immaġni li tniżżel fuq
edit, jew ibgħat bħala a
data:URL f' ġeneratur ta'image_url, jiġi ttajata fuq host pubbliku ta' Blossom l-ewwel sabiex il-ġeneratur ikun jista' jġibha, u l-istess japplika għalih. Ritr bagħat minnhttps://il-link jiġi passa 'l quddiem bħala dak il-link. Il-foto f'talba ta' chat imorru għand il-fornitur tal-mudell, mhux għand Blossom. - Ċwieċa hija marbuta mal-nym tiegħek. Kollox li tużah chiave jiġi nqas minn l-assi tal-nym tiegħek, għalhe Rez, l-użu tal-API mhux anonymus. Jekk trid li l-API jkun separat mill-nym tädijewwa, agħmel il-klavi minn nym separat b'bilanċ proprju.
Jekk għandek bżonn il-protezzjoni tal-apps, uża l-apps. L-API huwa għal meta għandek bżonn il-modelli f'l-għodod tiegħek stess.
Mhux kull endpoint
| Endpoint | X'tagħmel | Awtorizzazzjoni |
|---|---|---|
GET /api/v1/models | Lista tal-modelli, b'prezzijiet | None |
POST /api/v1/chat/completions | Chat Completions | Ċwiev</li> |
POST /api/v1/responses | API tal-Risponsijiet | Ċwiev</li> |
POST /api/v1/messages | Messaġġi ta' Anthropic | Ċwiev</li> |
POST /api/v1/messages/count_tokens | Stima tal-tokens tal-input | Ċwiev</li> |
POST /api/v1/images/generations | Ġenera immaġni | Ċwievka jew Mili |
POST /api/v1/images/edits | Editra immaġni | Ċwievka jew Mili |
POST /api/v1/videos, GET /api/v1/videos, GET /api/v1/videos/{id} | Bidu, listi u checks ta' vidjows | Ċavet, jew Mili biex tibda wieħed |
POST /api/v1/audio/speech | Test għal leħen | Ċwievka jew Mili |
GET /api/v1/audio/models, GET /api/v1/audio/voices | Modelli tal-awdjo u vuċi | None |
POST /api/v1/audio/transcriptions, POST /api/v1/audio/translations | Mixi l-kliem għal test, u għall-Ingliż | Ċwievka jew Mili |
POST /api/v1/embeddings | Embeddings | Ċwievka jew Mili |
GET /api/v1/credits/balance (jew POST) | It-tnejn saldi | Ċwiev</li> |
GET /api/v1/topup/payment-methods | Modi kif tħallas | None |
POST /api/v1/topup/create/btc-lightning | Fattura Lightning | Ċwiev</li> |
GET /api/v1/topup/status/{invoice_id} | Iċċekkja u jiddebitah | Ċwiev</li> |
GET /api/v1/queries/history | Kemm jikkostja kull talba | Ċwiek jew nym |
GET /api/v1/account | Sommarju tal-kont | Nym |
/api/v1/keys | Jipproduċi, ibiddel u jneħħi l-klavi sabħor | Nym |
/api/v1/nwc-auto-topup | Top-ups awtomatiċi | Nym |
GET /api/v1/l402/refunds, POST /api/v1/l402/refunds/redeem | Iċċekkja jew iċċiedi token ta' rimborzu | Token ta' rimborsu; nym biex jiġi rredimiet |
Nym" tfisser talba imxemmija mill-klavijiet Nostr tiegħek, deskritta f taħsig tal-joni tal-akkunttijiet. Għal għodod li diġà jitkellmu dawn il-formatijiet, xogħol fuq taħdima u SDKs, u għal aġenti tal-kodifikazzjoni bħal Claude Code, Codex u Cline, xogħol fuq taħtim tal-kodifikazzjoni.