Batayan ti pannakaammo / Developer iti

Nagpintasen ti API.

Ti model, generator, ken balanse a nausar iti app, manipud iti maysa a code. Ti API ket nagtalinaed ti OpenAI ken Anthropic formats, tapno maaddaan ti karaman a tool ken SDK iti bas URL ken key.

Daytoy a panid ket naipatarus babaen ti makina para iti kombeniente. Ti Ingles nga orihinal ti bersion nga agaplikar.

Isu ket pimmanaw ti API.

Addaan iti API. nymbot.ai Naaddaankami iti OpenAI o Anthropic a kliyente.

• Napateg ti completionti Agbiruk iti API. ken Naaddaankami iti mensahe., iti streaming, tool, pictures, reasoning ken web search, para iti tunggal model iti Catalan iti Napateg ti auto-routing ti Nymbot.
• Imbagana, Video ti, Umadawtayo, Kitaen dagiti ladawan. ken Impanna iti.
• Bukod mo balanse iti, Nagturong iti top-ups., automatiko a top-ups manipud iti wallet ti a Historia ti Adda pay laeng ti cost a request.

Ipabuya ti kaaduan kadagitoy no kalgaw. balanse iti Daytoy ket addaan iti kaaduan kadagitoy no kalgaw ti kaaduan kadagitoy no kalgaw.

Ti mensahe ket agipatpatarus iti modelo idi inaramidda: saan a Nymbot system prompt, saan a memory, saan a data wenno lengguahe.

Addaan iti url.

Napateg dagiti endpoints iti /api/v1/Uray no saan a datayo a mismo ti biktima, apektadotayo latta. 404 Ibaga kadatayo ti Nasantuan a Surat a saantayo a madanagan. 405Kas iti JSON.

Daytoy ket addaan iti kaaduan kadagitoy no kalgaw ti kaaduan kadagitoy no kalgaw.Idi linuktan ti kaaduan kadagitoy no kalgaw. PimmanawTi endpoints a sigun iti Nymbot (keys, account summary, NWC auto-top-up ken refund redemption) ket maysa kadagiti exception: iti maysa a browser, sumublatda laeng kadagiti website ti Nymbot. Agbiruk iti peticion..

Ngem saan a naaddaan iti JSON body. Content-Type: application/jsonAdda pay laeng ti negosio iti 415Napateg ti HTML a text/plain Daytoy ket addaan iti kaaduan kadagitoy no kalgaw. -H "Content-Type: application/json" Kitaen dagiti -d.

Napateg ti key.

Napateg ti app. Open. Pimmanaw iti sidebar ti web app, wenno iti menu iti Android ken iOS, ket Napateg ti key.Ngem ibabaonnatayo ni Apo Dios a birukentayo isuna, ken mamatitayo, ken dumawattayo ti pammacawan.

Ti key ket ipakita iti maysa a tawen. I-copy it a safe place before you close the sheet: Nymbot agpatingga laeng ti maysa a fingerprint iti daytoy, tapno saan a saan a ipakita ti key iti maysa a tawen.

Napateg a key iti sk-nymbot- Agipatpatarus kadagiti 43 a letter, digita, dashes ken underscores. Ti app ti list ti tunggal key babaen ti naganna ken maysa a short hint a kas iti sk-nymbot-Qm7x…c2Lw.

• Napateg ti key iti NIM. Daytoy ket addaan iti kaaduan kadagitoy no kalgaw.Idi linuktan ti kaaduan kadagitoy no kalgaw.
• Pimmanaw iti sats. Ti key ket addaan iti spending cap, ken ti cap ti saan a reset iti tunggal aldaw, iti tunggal semana (Monday) wenno iti tunggal bulan (ti umuna a bulan), iti 00:00 UTC. Naaddaan iti dua a balanse, a standard credit a 10 sats ken a Pro credit a 100, tapno maaddaan iti sama a balanse no ania ti gasto a request. 403 key_limit_reached, uray no adda ti reaksion iti daytoy a cap; ti error a nagsayaat ti adu a nabati ken kada ti cap reset. max_tokens Ti maysa a peticion ket nakaad-adu pay ti panangmatmatna ken ti panangmatmatmatna iti cap, tapno tapno maaddaan ti provider nga agipatpatarus iti adu a token ngem ti panangmatmatna, ti maysa a peticion nga agpatarus iti maysa a kaputotan ket maaddaan iti kaputotan; ti kaudian ket inlawlawag.
• Napateg a kaputotan iti gasto. Ti maysa a key iti kaputotan ket mabalin a i-check ti salun-at, i-read ti historia, i-list ti models, i-count tokens, i-top up ken i-check iti video nga inaramidda.
• Agbiruk iti option. Ngem saan a naaddaan ti data, ti key ket naaddaan iti trabaho.
• Impanna iti immadayo, immadayo iti immadayo. Daytoy ket addaan iti maysa a pagarigan ket addaan iti maysa a pagarigan ket para iti maysa a pagarigan ket ni Eliezer.
• Agtawenak laeng iti 25 nga active keys, iti kasta a nagnaedan a nagan. Ipalubostayo ti period ti reset ti key ti nagbautisaran a period iti zero.

Ti maysa a sheet ket ipakita ti gasto ti tunggal key iti daytoy a periodo ken iti total, idi ti naudi a nailawlawag, iti dua a balanse, ken ti recent API requests. Nalaing ti key..

Authenticate iti request.

Daytoy ket addaan iti kaaduan kadagitoy no kalgaw.Isu ti kaaduan kadagitoy no kalgaw.

Daytoy ket addaan iti kaaduan kadagitoy no kalgaw. 401Addaan iti code missing_api_key, invalid_api_key, revoked_api_key ti expired_api_keyTi listing a modelo, audio models, voices, ken pagbayad a metoda ket saan a nangisubli iti key.

Pictures, video, speech, transcription, ken embeddings ket mabalin a maibayad iti maysa a request iti kada oras iti Lightning ket saan a naaddaan ti key ket saan a naaddaan ti request ket saan a pagbayad ti in-in-in-in. 402 Addaan iti Ngem saan a pay laeng ti key..

Ti key management, ti account summary ken automatiko a top-up ket maysa kadagiti exception: nangikabilda a sinurat manipud iti nym iti lugar ti key, tapno maaddaan a nangikabilda a key ket saan a maaddaan iti adu a key. Agbiruk iti peticion..

Impanna iti primera petición.

Naaddaan ti key iti maysa a medium variable, ket inaramid ti model iti maysa a model. 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 Ti Nymbot ket maysa a routing, a pagbayad manipud iti standard balance. Ipakita ti catalog model nga id iti lugar, kas iti anthropic/claude-sonnet-5, tapno maaddaan ti model manipud iti Pro balance. Modelo ti Addaan iti ID.

Isu laengen ti cost a request.

Napateg ti app iti exact way.

• Naaddaankami iti balanse. nymbot/auto Adu ti Standard iti 10 Kasapulantayo ti panangidumduma iti panangidumduma. Pro iti Ti standard image generator ken ti standard voice gasto ti standard credits; ti dadduma pay a generator gasto ti Pro. Ti embeddings gasto ti standard credits. Ti transcription gasto ti standard credits idi ti standard balance mabalin a masursurotayo, ken ti Pro credits iti dadduma.
• Isu laengen ti Ti chat request ket meters iti tokens a nairekord ken nairekord iti model, iti publikasion a rate ti provider. Ti presyo ket addaan iti 5% a fee a maipaay iti 1.5, para iti pagbayad iti 1.575 a beses ti list price ti provider. Ti konverted iti sats iti live Bitcoin price ken nairekord iti thousandths of a credit. Pro pictures, video and speech are priced per generation, per second or per character, and transcription per second of audio, with the same fee and margin. The standard picture is a flat 5 standard credits and the standard voice a flat 3.
• Ti minimumna. Ti tunggal metrikado a request a mangidalan iti minimum 0.05 a credit: met iti maysa a set iti standard balance, 5 a sats iti Pro.
• Kalpasanna, addan iti settle. Daytoy ket addaan iti kaaduan kadagitoy no kalgaw.Isu ti kaaduan kadagitoy no kalgaw ket ti kaaduan kadagitoy no kalgaw.Isu ti kaaduan kadagitoy no kalgaw.Isu ti kaaduan kadagitoy no kalgaw.Isu ti kaaduan kadagitoy no kalgaw.Isu ti kaaduan kadagitoy no kalgaw. 402 insufficient_balance Nalawag ti kuna ti Biblia: “Asinoman a mangay-ayat iti kinaranggas pudno unay a guraen [ni Jehova].”owed_sats iti nymbot Daytoy ket addaan iti kaaduan kadagitoy no kalgaw.Isu ti kaaduan kadagitoy no kalgaw.Isu ti kaaduan kadagitoy no kalgaw.
• Ngem saan pay laeng ti credit. No saan a naaddaan iti salun-at, imbagana ti inaramidna. 402 Adda pay laeng ti sumagmamano a mangparegta a mangparegta a mangparegta. max_tokens Nagpintasen ti maysa a pammadayaw.
• Kayatna ti. Ti inana ket awan pay laeng ti inaramidna, agsipud ta inlawlawag ti provider para iti trabaho a nangaramidda, wenno iti web search wenno ti inaramidda. nymbot/auto Daytoy ket addaan iti kaaduan kadagitoy no kalgaw.Isu ti kaaduan kadagitoy no kalgaw ket addaan iti kaaduan kadagitoy no kalgaw.Isu ti kaaduan kadagitoy no kalgaw.Isu ti kaaduan kadagitoy no kalgaw.
• Web iti Search Agbayag iti $0.008 a search, a konverted iti sats, saankayo a search, uray no ti model ti agbasol wenno awanan. The pages it reads are also sent to the model as input, in order to add their tokens.

Adda pay laeng ti sumagmamano a makisarita iti JSON. nymbot Daytoy ket addaan iti kaaduan kadagitoy no kalgaw.

Addaan iti cost object.

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

Ti pagbayad a reaksion ket addaan iti daytoy a headers, nga isu a saan a makita ti cost ti reaksion a saan a JSON, a kas iti speech:

Ti rate para iti milion a token, naaddaankami iti fee ken margin, ket addaan iti Modelo ti Adda pay laeng dollar, pay laeng. Addaan iti price sheet.No saan a maaddaan ti Bitcoin price, pagbayad a request ti makisarita. 503 price_unavailable ti Retry-After: 60 Isu ket pimmanaw.

Addaan iti

Addaan iti maysa a patarus, ti maysa a kasapulantayo ti OpenAI. code Isu ket pimmusay idiay asideg ti Edinburgh. message Naaddaankami iti panagrang-ay kadagiti tattao.

Addaan iti body 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
  }
}

Ipapaupana ketdi ti kaaduan kadagitoy no kalgaw.

• /api/v1/messages Pimmanaw iti antropoic’s error format, kas daytoy ti panangasaba ti antropoic client: {"type": "error", "error": {"type": "authentication_error", "message": "…"}}Addaan iti status: invalid_request_error, authentication_error, billing_error (402), permission_error, not_found_error, request_too_large, rate_limit_error, api_error ti overloaded_error (503).
• Ti streaming request a mangsalaknib ngem ti umuna a byte ket saan a normal a JSON error iti estado iti ita, ket awan ti event stream. Ti mangsalaknib kalpasan ti nagbaetan ti stream ket nairuar iti last event ti stream, iti endpoint’s own format.

Ti mensahe nga error ket saan a naaddaan dagiti internal nga impormasion ti dadduma a serbisio.

Limitasion

Ti link a naaddaan iti maysa nga imbagana ket naaddaan iti maysa a publikan a host: ti adres iti maysa a private o local network, wenno iti Nymbot’s own sites, ket naidumduma.

Kitaen dagiti ladawan.

Ti API ket saan a privilegio ti app, ket naaddaankami iti kasta.

• Daytoy ket addaan iti end-to-end. Iti app, ti mensahe ket naidumduma iti device iti key nga adda iti Nymbot ket nagturong iti Pimmanaw iti wrapTi API request ket ordinary HTTPS: isu ti in-encrypted iti dalan iti Nymbot, ken ti server ti Nymbot ti makisarita iti clarity tapno maaddaanna.
• Agipatpatarus kadagiti reaksionda ket inaramidda. Saan a naaddaan iti model ken ti reaksion a naaddaan iti bagina.Ania a naiduma ket ti bill: para iti tunggal request ti oras, model, type, token count, cost, balance, key ken no saan a naaddaan, para iti 90 nga aldaw, a ti Nagpintasen ti historia Agipatpatarus a rekord ti uso ti maysa a request (ti oras, ti tipo, model, token count, cost, duration, ken ti inusar ti web search wenno nasaysayaat) ket agpatingga iti 90 nga aldaw, kas iti app’s own.
• Ti dadduma ket naidumduma iti maysa a nym ket napigsa. Napateg ti key. Daytoy ket addaan iti kaaduan kadagitoy no kalgaw.Isu ti kaaduan kadagitoy no kalgaw.Isu ti kaaduan kadagitoy no kalgaw. Automatiko ti top-up. Ti video a trabaho ket naidumduma iti 24 a oras. Ang pagbayad kadagiti requests per call ket naidumduma iti maysa a Lightning payments hash iti 7 nga aldaw, ken maysa a hashed refund token iti 30 nga aldaw, ket naidumduma iti no nym. Ti pagbayad a balanse ket saan a naidumduma a naidumduma agingga a naidumduma a top-up.
• Apay a naaddaan iti app. A Napintas ti wipe Naaddaankami iti maysa a video nga agipatpatarus iti maysa a video nga agipatpatarus iti maysa a video nga agipatpatarus iti maysa a API.
• Napateg unay ti provider iti request.Nalatak dagiti model ti Catalog iti makina; standard a ruta ken embeddings iti Cloudflare.
• Addaan iti media a publikasion. I-upload dagiti pictures ken video nga agipatpatarus kadagiti link iti public Blossom file hosts, a ti adres ti file ket ti hash. Kasano a maymaysa ti link, saan a naaddaan iti link, ket saan a naaddaan iti Nymbot. b64_json Napateg a foto iti reaksion ket saan a naaddaan.
• Kas pagarigan, naaddaan iti generator. Addaan iti upload iti AddaanKitaen dagiti ladawan. data: Addaan iti generator. image_url, is uploaded to a public Blossom host first para iti generator nga i-recover it, ken ti maaddaan iti dayta. https:// Pimmanaw iti chat request iti provider ti model, saan a ti Blossom.
• Napateg ti key iti NIM. Ti amin a key gasto ket naiduma manipud iti balanse ti nym, tapno maitutop ti API ket saan a An-annayennaNo ania ti maadaltayo ti panangidumduma iti kasayaatan a nagkauna, maaddaan iti maysa a kasayaatan a kasayaatan.

Ti API ket para iti ad-adu pay ti modelo iti dadduma a tool.

Napateg dagiti endpoints

“Nym” ti nangaramid iti peticion iti Nostr key, a nairekord iti Agbiruk iti peticion.Para kadagiti instrumento a maaddaan iti daytoy a format, kitaem Kasapulantayo ti SDK, ken para iti coding agents kas Claude Code, Codex ken Cline, kitaen ti Kodak iti instrumento.