Di tin dɛn we pɔsin fɔ no bɔt / Dɛvɛlɔpɔs

API ɔvaviu

Di models, generators, and balance wey yu de yuz in di app, na fram yu wan kod. Di API de spik di OpenAI and Anthropic formats, so boku tools and SDKs de wok boku wey yu jus chanji wan base URL and wan key.

Dɛn translet dis pej wit mashin fɔ mek i izi fɔ am. Di Inglish ɔrijinal na di vɛshɔn we de aplay.

Wetin di API na?

An HTTP API on nymbot.ai dis ansa de seim ridit we an OpenAI ɔ Anthropic klayan de ɔlwey de send. Yu get:

• Trok-tok We Don Fin, di Responses API ɛn Anthropic Mesij 📧, wit streaming, tuls, pikiya, reasonin an web serch, fɔ ɛvri modèl in di katalɔg an fɔ Nymbot in in awt-raotig.
• Pikchur, vidio, tok, transkripshen ɛn embeddings.
• Yu balans, Lightning top-up dem, otomatik top-up de pan yu wallet an wan histri wetin e kos fɔ ɛbit rekwest.

Dem de pe am fɔm di sam tu balans bi de na de app, wit de seim prais. No sabskripshen de, an no fri ɛlowans na de API: evri rɪkwɛst de kɔst fɔm de kredɪt we yu bɔt.

Wetin di API nɔ du na se e nɔ add nɔtin di Nymbot wan. Yu mesij de go to di model jus di wei u send dem: nɔ Nymbot system prompt, nɔ memri, nɔ deit o langwej hint. Wetin de kam bak na di model ansa wetin e kos.

Base URL de se

Ebri endpoint de na under /api/v1/. Unkno paf di brik bɔk 404 an path wey sabi wey dem de call wit di rong metod de rimɔn 405, bot na JSON.

Di API ansah cross-origin rikwest frɔm ɛni siti, so wan brauzɔ pej kin kɔl am. Bot, ɛvritin we yu sɛn go wan brauzɔ, ɛvribɔdi we ɔpɛn am kin rit am, so ɔnli du dat wit wan ki we de ɛs kɔm. kapDi endpoints wei dem sign wit yu nym (kiy, di account summary, NWC auto-top-up an refund redemption) na di exception: in a browser dem de ansa only Nymbot in de in wan site. Si sinin akount rikwest.

Sen evri JSON bodi wit Content-Type: application/json. Anin oda tipe de u de gi fɔ no wit 415, so wan plain HTML fɔm ɔ a text/plain rikwest frɔm anɔda saity nɔ de reach di API. Wiт cURL, pas -H "Content-Type: application/json" wit 🇸🇱 -d.

API kii

D kays de mek na di ap. Open API na di saide-bar na di web app, o na di menyu na Android ɛn iOS, ɛn tap Mek ki 🔑. Gi am wan nem an, if yu lɛk, wan kɛp an wan ɛks-payre deɪ.

Di ki de show wan tɛm. Kop i go na wan sef ples bɛfor yu klous di shit: Nymbot de kip onli wan fingap rint in, so e nɔ go ɛbul sho i to yu agin. If yu luk am, e nɔ de kɛm bak; kɔntrol am denay ɛn mek anɔda wan.

Wan kii luk lɛk sk-nymbot- di wan we de fɔlɔ di 43 lɛtɛ, namba, deş, ɛn andaskor. Di ap de lɔst ɛbri ki na in nem ɛn wan smɔl hint lɛk as sk-nymbot-Qm7x…c2Lw.

• Wan kɛi bɛlɔŋ yu nym. E de spɛnt yu balans, ɛn na ɛkli nym de kin mek, ɛnjen ɔ kɔntrɔl am. Anin-wan we de hol di kii kin spɛnt di mon wit am, so tirit am lɛk wan paswɔd.
• Caps de in sats. Wan key kin get spending cap, and di cap kin reset evri de, evri wik (Mande) ɔ evri mon (di fɔst de), at 00:00 UTC. E de kɔnt bot balance, wan standard kɔredit as 10 sats and wan Pro kɔredit as 100, so e de mean di sem eni balance we di request de spend. Bifo wan request run, di mɔs di ting we e kin kɔst (wey dem don mek am ful kɔmplet kɔredit) de kɔnt ɛgan di limin we de ɛleft na di cap. If di limin nɔ kɔf, dem go rify di request wit 403 key_limit_reached, e ven if de answə wud in kam inna de cap; de error de sein aw much de left and wen de cap reset. Lowarin max_tokens dis mek di fes-fɛst bad kɔs nɔ lɛk dat. Wan rɛkweste de kɔst wetin ɛ kɔs ɔl, ɛn ɛ de kɔnt na di kɛp, so if di prɔvīdɛ ɛ rɪpɔt mɔ tɔkɛn ɔn mɔ dɛn sɛt ɛsɛd, di lɛst rɛkweste we de fit kæn tɛk di kī ɛ bɛk kɔs ɛ kɛp; di nɛkst wan de ɛn rɪfjuːz.
• Wan kapi we don finish, e no de sabi do nɔtin fɔ spend. Wan ki at in cap de go go check di balance, rid in in histri, lisin models, count tokin, put wan top up, an check wan video in de alredi stot.
• Yu nɔ fɔ du ɛks-pay sapos yu nɔ want. Aftah di de yu set, di ki stop wok.
• Tek am bak na stat-stat, an e finis. Wan ki we dem bin kɔntrol de kɔntrol bin fayl na im nɛks rɛkwɛst. I de na di lɔst, dem mək am se e revɔkd, so in spɛndin hɛstɔri de mek sɛns.
• Yu kin get up to 25 aktiv ki, ɛʧ ɔːʧ wan de ɛn in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in

Di semt shit de so di amont we i kil di spɛn dis piriɔd ɛn di totl amont, wen i fɔst jus, yu bot bælɛns, ɛn yu rɛsɛnt API rɪkwɛst. Di ɛnt-pɔint we de bɛhɪnd am de dɔkyumɛnt ɛndɔ mənajin ki 🔑.

Confirmin wan rikwest

Sen di key na eni wan di headers we de ya. Dem de de sef, so jus us di wan we yu klaien sen by default:

Wan ki bin no de, we nɔ no wetin e bi, we bin kɔnt mɔ, o we don pas, de brin am bɔk 401, wit di kod missing_api_key, invalid_api_key, revoked_api_key ɔ expired_api_key. Lisin wan lɛs di models, di audio models, di voys, ɛn di wei dɛn de pɛ di mɔni dɔn no nid fɔ kii.

Yu kin pay for pika, vidio, spich, transkripshen, and embeddings fɔ wan rimaym at wan taim ɔva Lightning witout ɛni ki at ɔl: sen di rimaym witout wan ɛn pay di invɔys in di 402 ansua. Luk yu de pay per request witout wan key.

Ki manejment, di akount samari, ɛn otomatik top-ups na di wan we difrin: dɛm tek na sɔn (signature) frɔm yu nym instɛd ɔf wan ki, so if wan ki lɔs, dɛn nɔ kæn mek mɔ ki. Si sinin akount rikwest.

Yu fɔst rikwest

Put di key na wan environment variable, den ask wan model sɔmting. Di eksampul de na dis pepa de de rɛd am frɔm 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 na Nymbot in den wan routing, we de pay frɔm di stándad bálans. Put wan kátalɔɡ mɔdɛl id de na de, lɛk as anthropic/claude-sonnet-5, fɔ yuz dat model frɔm di Pro balance. Lis tin di modèl dem gi ɛvri ID.

Wetin wan rikwest kos

Di API de krait eksakt pan di we di app de du.

• Wich balans? nymbot/auto spen di standad balance (10 sats a credit). Evri oda chat model spen di Pro balance (100 sats na wan kiredit). Di stenda imaj generator na di stenda voys de yus stenda kiredit; evri oda generator de yus Pro. Embeddings de yus stenda kiredit. Transkripson de yus stenda kiredit if di stenda balans kin kaba am, if i no, e de yus Pro kiredit. Di lisin fo di moduls i se wetin balans evri modul de yus.
• Wetin di prait? Di chɔt rikwes de kɔnt di tokɛns di modɛl rɛd an sɛt, de pɔs di prait di prɔvaydɛ. Di prais de ɛɡ ɛ 5% fiy, ɛn ɔf de mɔltipula am bɔy 1.5, ɛso yu de pey 1.575 tɛm di prɔvaydɛ pris. Dɛn de kɔnvɛt am go sats de bɔy di lɪv Bɪtkɔɪn pris an dɛn de ɔp de kɔm ɔp dɛn bɔy wan tɔusand-fɔt-θri di ɔv wan kɛdɪt. Prɔfɛʃonal pikɛtʃa, vɪdɪo, an spīch de ɛks-pɛns pɛr jɛnɛreɪʃɔn, pɛr sɛkɔnd ɔ pɛr kɛrɛktɛ, an træn-skrɪpʃɔn pɛr sɛkɔnd di ɔdi-ɔ, wit di sɛm fiy an mɑːdʒɪn. Di stændad pikɛtʃa na wan fæt 5 stændad kɛdɪts an di stændad vɔys na wan fæt 3.
• Di minimam. Evri metered rẹkwest we de ran kos at lis 0.05 krediti: haf a sat na di stándad balans, 5 sats na Pro. Di frakshon di krediti de kared ov, no de round am op evri taem.
• Hold, den mek yu si. Bifo ɛni rekwest start, di wan we di kɔst go bi biggiest na am go de fɔm yu balans, bɔs dɛn luk wetin yu sɛn an di wan we di tokɛns go de rit. Any tɛks we nɔ de na plain ASCII, dɛn go luk am fɔm di UTF-8 bayts, an di ASCII namba an pɔnkju-eʃɔn na wan tokɛn ech, so ɛni tɛks we de na ɛni skrayt, kɔd, ɔ namba, dɛn go tek di ful kɔst. Di kɔst we dɛn go hold na ful kiredit, at lɔs wan, so ɛni rekwest nid at lɔs 10 sats fɔ fɔ ri de na di stɛndan balans ɔ 100 sats na di Pro balans fɔ ɔmɔn start. Na di kɔst we yu jus de pay na dɛn go ɔmɔn; di ɛlə dɛn go rilis wen di wok don finis. Wan long rekwest go kin hol di kiredit fɔ di ɛfri taɪm am de ran; if di kiredit dɛn nɔ de de fɔ de mɔ, di strim go stop wit wan 402 insufficient_balance errọ ivɛnt, ɛnd wot we di pɔsin dɔn mek na wetin dɛn bin ɔf bɛ fɔ pɛ. If di kɔst we bin de na tru bi mɔ bɛ dɛn bɛlɛns fɔ pɛ, dɛn go tɛk di ɛntɔ bɛlɛns, dɛn go ɔf di rɛst (owed_sats in de nymbot (objek, ɛn wan negativ balans). Wetin de owed na am de pay fɔst ɛn de nɛks kredits we de kam na dat balans. Pas di wan we de pay, nɔtin we de na dat balans de kin spend: nɔt ɛn di API, ɛn di rispons na di ap, wan trænshaf, ɔ wan gif.
• Nɔ ɛna ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛnɔ ɛ If di balance no go fit kover di hold, di rikwest de difuz wit 402 bifo ɛni tɔŋk rɔn. Di ɛrɔ se kɔnt, mɔni dɛn fɔ mɛk di rɪkwɛst rɔn ɛn ɔl dɛn fɔ fri. Smɔl bɛtɛ max_tokens mɛn wan smol hol.
• Fayul. Wan rikwest we no go kɔmplit di nɔmɔ kɔst nɔtin, ɛksɛp if di provayda bin bil ɛm fɔ di wok we i du bɛfɔ i fèl, ɔ wan web sɔrtʃ ɔ di nymbot/auto Task check don ran alredi; na dat yu go pay, at lɔst 0.05 kiredit. If yu kat of wan strim, dem go ɔchan yu fɔ di tokɛn we di provayda rɪpɔt: Nymbot de kɔntinyu de rid di provayda strim fɔ apɔt 25 sekɔnd afta yu lɔf fɔ get dat kɔnt. If dat no kam, dem go ɛstimet di ɔchan fɔm wetin yu sɛnt ɛn wetin bin rait, ɛn fɔ wan modɛl we de rɔzɔn, ɛn de ɛnkud ɔl di autput ɔlowans we de hoʊld. Wan rɪkwɛst we di kɔnɛkʃɔn drɔp, de finɪʃ ɛn dem go ɔchan yu fɔ am.
• Wéb sēch e kos $0.008 fɔ wan sɔːch, di wan we de konvet fɔ sats, ɛvritaym wan sɔːch ran, ɛf di modèl ansa ɔ fɛl. Di peej we e de rɛd de sɛnt fɔ di modèl ɔs input, so dɛn ɛd in tokin.

Èvri rispɔns de se wetin i kos. JSON rispɔns de kɛri a nymbot objek wetin de wit di balance wey dem pay frɔm, di charge in kredits ɛn sats, ɛn wetin de left:

Di kɔst ɔbʤɛkt

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

Di respons di pèy kɔm wit dɛn hedā dɛ, dɛn na wɛr yu fɔ luk fɔ di kɔst di wan respɔns dɛt nɔ JSON, sɛkɛm spich:

Di pris per milian tokin, we de inklud di fee ɛn di margin olwe, de in di lis di modeli na dolas ɛn sats, ɛn on di pris shit. If di Bitcoin pris kin no rim, pèd rɪkwest kɔm bak 503 price_unavailable wit Retry-After: 60 boku rader fɔ mek mi sabi den, nɔt fɔ mek mi fɛm.

Mistek

Èvri ɛrɔ get di sɛm sɛp, di wan we OpenAI klayɛnt ɔlɛdi ɔndastand. code na wan stebul nem we yu kin matsh on; message e na for pipul an e de go sen de.

Error bodii

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

Tū ekssepsin:

• /api/v1/messages ansua de na Anthropic error format, bikos na dat Anthropic klayan de parse: {"type": "error", "error": {"type": "authentication_error", "message": "…"}}. Di taya fɔlɔ di stætɔs: invalid_request_error, authentication_error, billing_error (402), permission_error, not_found_error, request_too_large, rate_limit_error, api_error ɔ overloaded_error (503).
• Wan streaming request wey fail bifo di fes byte kam, e go gi wan ordineri JSON error wit di status we de abov, no wan event stream. Wan feslɔ bɛfɔ di stream don start, e de sen am bi di stream di fes event, na di ɛndpɔint nɔmɔ fɔm.

Error mesij nɔ de kopa oda servis in klose-klose tin dɛn. Di provayda in oda error de mek fɔ di nɔmɔ tin fɔ e kɔm fɔ yu.

Limi ded

Wan link fo wan pika must point to wan public host: wan adress on wan private or local network, ɔ on Nymbot di in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in

Wetin di API kin si

Di API nɔ de private de wei di apps de, an e worth mek wi de exact bout di wei.

• E nɔ end-to-end enkripte. In di apps, wan mesij de klose na yu disвай de, we na Nymbot kote de fɔ opın, ɛn e de go lɛk wan pak gifAn API request na di normal HTTPS: e de krypt na di way we e de go Nymbot, and Nymbot server de ridi am de kler for hɛndel am.
• Dem prompts and ansua dem no de kip. Dèm pass de model an di ansua pas bak. Wet we dèm kíp na di bil: fɔ ɛch rɪkwɛst di tɛm, di model, di kɛn, token kɔnt, kɔst, bɛlɛns, ki, an if ɛt sɔksid, fɔ 90 deys, wet we na wet di histri di wan we yu bin ask bof e de sho yu. Dem de kip am record wetin yu bin mek (tym, kain, model, token counts, kɔst, dɛn, ɛn if e de uːz wetin de na inob dɛn ɔ bɛn) fɔ nɔn 90 de, ɛn de go wɔː de wit di app dɛn de kɛp wɔː de.
• Aw di od tɔŋk we nym de hol fɔ smɔl de na dis lis. API kii dem de stor as wan hash, no de stor di key, wit dem nem, wan smɔl hint, di limit we dem kin spɛnd, di piriɔd we dem de rɛsɛt, wen dem de ɛksɛpa, ɛn wen dem bin mek ɛn wen dem bin yuz dɛm kray di ɛf di fɔst 50 di ki we dem bin kɔnt rɛvok; An Otomatik top-up u kuku di wallet konekshon gud, di krisen de, di amount, ɛn di risalt di las tym u bin put in moni. U di vidio job de kip fɔ 24 a-wa. Di pesment we de kɔl fɔ wan-wan de liv ɔnli wan Lightning pesment hash fɔ 7 de ɛn wan hash difun tɔkin fɔ 30 de, we nɔ de ɛni nem ɛn nɔ de ɛni kɔnekshon. Di deb we yu nɔ get ɛnɔf moni fɔ pe pa de kɔnt ɔ bɔrɔ as deb go tɛl u de pe am wen u put moni in.
• Wip di app de mak am gon. A wipe di dipayz di wan kɔntrɔl ɛn kɔntrol ɔf ɛvri API kɛ, ɛn kɔntrɔl ɛn kɔntrol di kwɛri ɛstɔri, di us ɛs rɛkɔd, di wɔlɛt kɔnɛksɔn ɛn di vidio jawb. Di bælɛns ɛn ɛni tʃaaj ɛs in de ɔdɔ de bɔt di nym.
• Di wan we de pruva di model de si yu rikwest, de kam fɔm di app. Catalog models run na de mek-am; standard routes and embeddings run na Cloudflare.
• Midi we di mek de kin de for di publik. Pikchul wetin and video wetin den send as link dem upload na public Blossom file host, wey di file address na im hash. Anywen wey get di link kin opn am, and Nymbot no kin tek am doun agin. Aks fɔ b64_json an piktcha we dem mek kam bak na di rispons an dem nɔ ap-lod am ɛvrimas.
• So di pikiç we yu de gi, na generator? Wan pic yu upload to elidit, ɔ sen am as data: URL insay wan generator de image_url, de upload am na wan public Blossom host fɔst so di generator de ketch am, ɛn de seym tin de aply fɔ am. Wan pikcha we send by https:// Di link de go pas usin dat di link. Pikcha we de na wan chat request de go na di provider di model de us, no go na Blossom.
• Wan kii de lɔnk to yu nym. Wetin evri kii spend, de kɔm ɔf na yu nym's bælens, so API us nɔ rɛl no nem. If yu wan us API wek am sɛp frɔm yu everyday nym, mek di keys frɔm wan sɛp rɛt nym we de go wit in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in in

If yu nid di proteksion di aps go, yu fɔ yuza di aps. Di API na fɔ wen yu nid di modol in yu wan tɔul.

Eni ɛndpɔnt

“Nym” dif na wan rɪkwɛst we yu Nostr ki sign, we de dɛskraɪb in sinin akount rikwest. Fɔ di tul wetin de ɔlredi spik dis fɔmat, luk tuls ɛn SDKs, and fɔ koding ejen tɛk sɔm sɛk as Claude Code, Codex an Cline, luk Kodin tuls.