Scientia basis / Developers

Visus generalis API

Modelli, generatores, et aequilibrium quae in applicatio utaris, ex ipso codice tuo. API formata OpenAI et Anthropic loquitur, ita ut plures instrumenta et SDK operantur per mutationem URL basis et clavis.

Haec pagina machinae ad commodum translata est. Originale Anglicum est versio quae applicatur.

Quid est API

API HTTP in nymbot.ai id quod eadem petitoria respondet quam client OpenAI vel Anthropic iam mittit. Accipis:

• Completiō Conloquiōrum, is API Responsio et Nuntii Anthropic, cum fluxu, instrumentis, imaginibus, ratione et investigatione in rete, pro omni sermone in catalogus et ad ratiocinatio automata ipsius Nymbot.
• Imaginum, Imago movens, oratio, transcriptio et implicitus.
• Your aequilibrium, Incredibilia supplementa ⚡, repletiones automaticae ex portulā tua et et historia quodquodque petitio pretium habeat.

Egis utraque eadem solvitur rationes sicut applicatio, eodem pretiis. Nullum est subscriptio nec gratis permissio in API: omnis petitio emere creditis quas emisti solvitur.

Quod API non facit est aliquid proprium Nymbot addere. Tua missilia ad modellum eodem modo mittuntur ut misista sunt: neque promptum systematis Nymbot, neque memoriam, neque indicia diei vel linguae. Quod revertitur est responsum modelli et nota pretii.

URLs Fundamentales

Omnis terminus sub vivit /api/v1/. Via ignota redit 404 et via cognita falso methodo vocata reddit 405, utraque ut JSON.

API petitiones ex diversis originibus ab omni loco respondet, ut pagina in navigatore eum vocare possit. Tamen, omnia quae in navigatorem mittis, ab eo quisque qui eam aperit legi possunt, ergo hoc tantum cum clave quae parvam habeat facias caput. Termini finis cum tuo nym (claves, summarium rationis, NWC automatum impletionem et redemptio restitutio) signati sunt exceptiones: in navigatulo tantum situs ipsos Nymbot respondentes sunt. Vide petitiones rationum signandi.

Mitte omnem corpus JSON cum Content-Type: application/json. Aliud genus cum ... reicitur 415, ergo formam HTML simplicem an text/plain petitio ab altero loco ad API non pervenire potest. Cum cURL, transmittas -H "Content-Type: application/json" cum -d.

Claves API

Claves in applicatione faciuntur. Aperi API in sinisteris margine applicationis interretialis, aut in mensem in Android et iOS, et tecto Clavem creaNomen ei da et, si vis, pileum et diem expirationis.

Clavis semel ostenditur. Eam in loco tuto scribe antequam chartam claudas: Nymbot tantum impressum eius servat, itaque eam tibi iterum ostendere non potest. Clavis amissa recuperari non potest; eam revoca et aliam fac.

Clavis similis est ut sk-nymbot- sequuntur quadraginta tria litterae, numeri, lineae et sublineae. Applicatio singulas claves nomine et breve indicium sicut... indicat. sk-nymbot-Qm7x…c2Lw.

• Clavis tibi nymini pertinet. Aequum tuum consumit, et tantum nym tuum facere, mutare vel revocare potest. Quicumque clavis tenet, eo consumere potest, ergo sicut verbum claves hab, ita ita a te colatur.
• Caps in sats sunt. Clavis numerum limitis sumptuum habere potest, et limitis renovari potest quotidianē, hebdomadum (die Lunae) aut mensem (die primō), ad 00:00 UTC. Omnes numeros computat, creditum commune ut 10 sats et creditum Pro ut 100, ergo idem est quocumque numero postulatio sumptus. Antequam postulatio agatur, maximum quod constat (ad integra credita elevatum) contra id quod ex limite restat ponitur. Si non sufficit, postulatio recusatur cum 403 key_limit_reached, etiamsi responsum sub modum venisset; error indicat quanto restet et quando modus renovatur. Minuendo max_tokens id quod pessimum casum minuat. Postulatum ei pretium imponitur quod re vera constat et id in modum limitis computatur, ergo si praebitor plures sermones nuntiat quam parati erant, ultimum postulatum quod locum habuit potest clavis modum paulo ultra excedere; deinde proximum negatur.
• Caput consumptum tantum impensas prohibet. Clavis ad caput suum etiamne aequilibrum inspicere, historiam legere, exemplaria enumerare, verba numerare, creditum addere, et video iam initum videre potest.
• Expiratio est optio. Post diem quem statuisti, clavis cessat operari.
• Revocatio immediata et definitiva est. Clavis revocata postulationem proximam deficit. In indice manet, revocata signata, ut historia dispensationis eadem viget.
• Potes habere usque ad viginti quinque claves activas, unamquamque suam proprietate nominata. Mutare periodum renovationis clavis novum periodum ab zero incipit.

Eadem tabula ostendit impensas uniuscumque clavis in hoc periodo et in summa, quando ultimae versae sint, utraque vestra rationum saldo, et peticiones tuas API recentiores. Finitiones quae postea sunt documentatae sub clavis regere.

Petitio authenticans

Mitte clavis in quacunque eorum capitim. Aequales sunt, ergo utere eo quem clientem tuus per default mittit:

Clavis amissa, incognita, revocata vel lapsa reddit. 401, cum codice missing_api_key, invalid_api_key, revoked_api_key aut expired_api_keyEnumeratio exemplarum, exemplarium sonorum et vocum, et rationum solutionis clavem non requirit.

Picturae, video, elocutio, transscriptio et intextiones etiam una quaque postulatione per Fulgur sine ulla clave solvi possunt: petitionem sine ea mitte et rationem in... 402 responde. Vide solvendus per petitionem sine clavi.

Administratio clavium, summarium rationis, et repetitio pecuniaria automata sunt exceptiones: signatum ex nimo tuo accipiunt pro clavi, ne clavis effusa plures claves creare possit. Vide petitiones rationum signandi.

Primum postulatum tuum

Clavem in variabile ambientali pon, deinde quaerito a modello aliquid. Exempla per has paginas eundem ex legunt 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 est via propria Nymbot, ex saldo communi soluta. In locum illud pone id catalogi exempli, sicut anthropic/claude-sonnet-5, ut illud exemplum ex aequilibrio Pro utaris. Modellorum enumeratio omnem numerum dat.

Quanti petitio constat

API eodem modo imponit quam applicatio.

• Quod equilibrium. nymbot/auto consumit norma Summa (decem sats pro creditu). Omnis alius machina colloquii consumit... Pro Aequitas (centum sats pro credito). Generator imaginum ordinarius et vox ordinaria creditibus ordinariis utuntur; omnis alius generator creditibus Pro utitur. Intextūs creditibus ordinariis utuntur. Transscriptio creditibus ordinariis utitur si aequitas ordinaria id capere potest, aliter creditibus Pro. Index modorum indicat quam aequitatem unusquisque modus consumat.
• Quantum constat. Petitio colloquii mensuratur secundum verba quae exemplar actualiter legit et scripsit, secundum pretia a praebitore edita. Illud pretium aestimatio quinque centesimarum partium addita, deinde per uno et dimidium multiplicatur, ut pretium praebitoris per unum et dimidium et septem centesimas partium solvas. In sats convertitur secundum pretium vivum Bitcoin et per milia partium unius creditum exigitur. Imago professionalis, video et vox pretia habent secundum generationem, secundum secundum an secundum litteram, et transcriptio secundum secundum auditus, eadem aestimatione et margini. Imago communis est quinque credita fixa et vox communis tria fixa.
• Minimum. Omnis petitio mensurata quae currit minimum 0.05 creditum constat: dimidium sat in saldo standardi, 5 sats in Pro. Partes creditorum translaturae sunt, non singulis vice ad summum elevatae.
• Tene, deinde quiesce. Antequam postulatio exsequitur, maximum quod constat ex saldo tuo retinetur, secundum quod misisti et maximum quam possit scribere verba. Textus extra plain ASCII ex suis octetibus UTF-8 mensuratur, et numeri ASCII et punctisunctio unum unum numerum computantur, ergo textus in quavis scriptura, codice et numeris in toto retinetur. Retentio est in creditis integris, saltem unus, itaque omnis postulatio indiget saltem 10 sats liberis in saldo ordinario vel 100 sats in Pro ut incipiat. Solum actualis pretium imponitur; reliquum liberatur cum finitur. Postulatio longa retentionem suam servat quamdiu exsequitur; si crediti retenti non iam praesto sunt, fluxus consistit cum a 402 insufficient_balance error casus, et quod generatum est emptionem debet. Si pretium verum plus quam saldo solvendum est, totum saldo capitur, reliquum debetur (owed_sats in nymbot (objectum, et saldo negativo). Quod debitum est primo ex creditis sequentibus qui illud saldo attingunt solvitur. Donec solvitur, nihil in illo saldo consumi potest: nec per API, nec responsibus in applicatione, nec per transfertum aut donum.
• Créditum non sufficit. Si reliquum retentionem tegere non potest, petitio cum ... negatur. 402 antequam quidquam agat. Error dicit cui saldo desit, quantis satellis petitionem requirere et quantos sint liberi. Minor max_tokens minorem tenaculum significat.
• Defectus. Petitio quae deficit nihil constat, nisi praestator pretium exegit pro labore ante defectum peracto, vel investigatio interretialis vel... nymbot/auto munus exsequutum iam est; tunc id est quod solvis, saltem 0.05 creditum. Fluxus quem intercisti pro verbis quos praebitor nuntiat imponitur: Nymbot fluxum praebitoris lectio usque ad viginti quinque secunda postquam abis pergit ut numerum cognoscat. Si non pervenit, onus ex eo aestimatur quod misisti et quod scriptum est, et pro modello quod cogitat totum munus effluendi quod retinet includit. Petitio cuius nexus cadit tamen perficitur et imponitur.
• Inquisitio interretialis pretiat $0.008 per investigationem, in sats conversum, quotienscumque investigatio peracta est, sive exemplar respondit sive defecit. Paginae quas legit etiam ad exemplar ut inputum mittuntur, sic suos termini addunt.

Omnis responsio dicit quid constet. Responsiones JSON ferunt ￦ nymbot objectum cum reliquo ex quo solutum est, onere in creditibus et satis, et quod reliquet:

Objectum pretii

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

Responsa soluta etiam hæc capita ferunt, in quibus pretium responsi quaerendum est quod non est JSON, sicut vox:

Pretia per miliones tokenum, iam cum onere et margine inclusis, sunt in index modorum in dollariis et satoshiis, et in tabula pretiorum. Si pretium Bitcoin legi non potest, postulationes solutas redde 503 price_unavailable cum Retry-After: 60 potius quam conjectando.

Errorēs

Omnis error eandem formam habet, eam quam clientes OpenAI iam intellegunt. code est nomen stabile in quo congruere potes; message est hominibus et mutari potest.

Corpus erroris

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

Duae exceptiones:

• /api/v1/messages responsa in formam erroris Anthropic, quia id est quod clientes Anthropic interpretantur: {"type": "error", "error": {"type": "authentication_error", "message": "…"}}. Genus statum sequitur: invalid_request_error, authentication_error, billing_error (402), permission_error, not_found_error, request_too_large, rate_limit_error, api_error aut overloaded_error (503).
• Petitio fluxus quae ante primum byte accipitur deficit, errorem JSON ordinarium cum statu supra scripto recipit, non fluxum eventuum. Defectio postquam fluxus incipit, ut ultimum eventus fluxus mittitur, secundum propriam formam puncti finalis.

Nuntii errorum numquam singula interna alterius servitii continent. Error proprius praestatoris mutatur antequam ad te veniat.

Limites

Vinculum ad imaginem ad hospitem publicum spectare debet: locus in rete privatum vel locale, aut in situs Nymbot proprios, reiectur. Moderatio praebitoris quae in applicatione viget etiam hic operatur, ut impetus petitionum ad unum praebitorem lenitur, non autem negatur.

Quid API videre potest

API non est privatum sicut applicationes sunt, et dignum est exacte dicere quomodo.

• Non est encryptio ab extremo ad extremum. In applicatiobus, nuntius in instrumento tuo ad claves quas solum Nymbot tenet obsignatur et ut... vehitur. donum involvereper itinere ad Nymbot encrypta est, et server Nymbot eam plane legit ut eam tractet.
• Promptūs et responsa non servantur. Per modellum praetereunt et responsum revertitur. Quod servatur est ratio: pro quoque interrogatione tempus, مودل, genus, numerus datorum, pretium, saldo, clavis et an successit, per 90 dies, quod est historia interrogationum tibi ostendit. Tabula usus eiusdem petitionis (tempus, genus, exemplar, numerus signorum, pretium, longitudo, et an investigationem interretialem adhibuerit an successerit) etiam per nonaginta dies una cum propria applicationis servatur.
• Omnia alia quae nym tenet parva sunt et hic annotata sunt. Claves API ut hash sub sigillo servantur, numquam clavis ipsa, cum nomine eorum, nuntio brevissimo, limite sumptuum, periodo renovationis, expiratione, et quando factae sint et ultimae tempore adhibitae sint; tantum quinque decem clavis revocatae novissimae servantur. An repletio automatica Connexio portulae encrypta conservatur, cum limite suo, quantitate, et exitu ultimae repletionis. Munera pellicularia viginti quattuor horas servantur. Postulationes per vocationem solutae tantum momentum solutionis Lightning pro septem diebus et signum reditus encryptum pro triginta diebus relinquunt, nulli nomini nexum. Debita quae saldo non possunt solvuntur ut debita servantur donec repletio ea solvat.
• Applicatio delebile est si deleatur. A Deletio instrumenti omnes claves API revocat et delet, et delet historiam interrogationum, rationes usus, nexum portulae et labores video. Saldo et omnia debita in nym manent.
• Praebitor modelli petitionem tuam videt, sicut ex applicatione fit. Catalog modelli apud creatores euntur; viae et inscriptiones standardis in Cloudflare fiunt.
• Media generata publica sunt. Imago et video per nexum transmissa in publicos Blossom accommodata suscepta sunt, ubi locus certi numeri est hash eius. Quivis cum nexo id aperire potest, et Nymbot id iterum delere non potest. Petito pro b64_json et imago generata in responsione redit et numquam uploadatur.
• Ergone imagines quas das generator sunt? Imago quam in ... uploadas emende, vel emitte ut data: URL in generatoris image_url, in publicum Blossom hospitium primum uploadatur ut generator id capere possit, et idem ei apparet. Imago a latere missa https:// Nexus ut ille nexus praebetur. Imaginines in quaestione colloquii ad praebitorem modelli mittuntur, non ad Blossom.
• Clavis ad nym tuum iuncta est. Omnia quae clavis expendit de saldo nym tui decedunt, ergo usus API non est incognitus. Si vis API a nomine tuo cotidiano separatam esse, claves ex nomine separato cum proprio equilibrio fac.

Si tutelam applicationum desideras, applicationibus utere. API est ad id tempus ubi modos in propriis instrumentis desideras.

Omnis terminus

“Nym” significat petitionem a clave Nostr tua signatam, quae in describitur petitiones rationum signandi. Pro instrumentis quae iam has formas loquuntur, vide Instrumenta et SDK, et pro agentibus codicibus sicut Claude Code, Codex et Cline, vide instrumenta programmandi.