וויסן באַזע / אַוועקלייגן

אַפּערייטינג אַפּערייטינג

די מאָדעלס, גאַנדרערז און סוואַקלייגן וואָס איר נוצן אין די אַפּפּ, פון דיין מאַכן קוד. The API speaks the OpenAI and Anthropic formats, so most tools and SDKs work by changing a base URL and a key.

דער בלאַט איז מאַשין איבערגעזעצט פֿאַר קאַנוויניאַנס. דער ענגלישער אָריגינעל איז די ווערסיע וואָס אַפּלייז.

איך בין א אש

אַ HTTP API nymbot.ai עס איז געפונען די באקאנטע דרישות פון אַ OpenAI או Anthropic client already sends.

• צאָלן סיוםאון ענטפער איך און אַנטראָפּאָסינג Messages, מיט סטרימינג, tools, pictures, reasoning and web search, פֿאַר יעדער מאָדעל אין די קאַטאַל און די נייע רעקאָמאַטור.
• און, וידאו, די, טראַנספּערימענט און ביידע.
• דיין איז, דעריבער Top-ups, אַוטומטיש טאָפּ-אַפּס פון דיין פאָוט און א היסטוריה וואס איז כל בקשה?

די משכורות זענען באותו שניים. איז איז ווי די אַפּ, אין אַ פּרייַזאָגן און אין אַ פּאָטער אַוועקלייגן אויף די API: Every request is paid for from credits you bought.

וואָס אין די אַפּי איז צו אַרייַנננעמען יעדער פון נימבאָט אַפּ. Your messages go to the model as you sent them: no Nymbot system prompt, no memory, no date or language hints. What comes back is the model's answer and a note of what it costs.

און URLs

יעדער געשעפט אויף /api/v1/און א חוסר דרך חוזר. 404 כ'האף די ווען (מיטן דרייווער) זאלן מארך ימים זיין. 405איך בין איז JSON.

די API ענטפער צו cross-origin requests from any site, so a browser page can call it. anything you ship to a browser can be read by who opens it, however, so only do that with a key that has a small קערThe endpoints signed with your nym (keys, the account summary, NWC auto-top-up and refund redemption) are the exception: in a browser they answer only Nymbot's own sites. דרישות צו חשבון.

יעדער גאַמעס זענען Content-Type: application/jsonיעדער אנדערע מין איז דיך. 415איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב. text/plain אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן אַוועקלייגן. -H "Content-Type: application/json" מיט -d.

און מפתח

זיי זענען געגרינדעט אין די אַפּ. און אין די ברעף פון די וועב אַפּ, אָדער אין די מינוט אויף אַנדרויד און אַאָוס, and tap לייענען מפתחדעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער

די מפתח איז געפֿונען א פעם אחת. קאָפּיידינג עס אַרייַננעמען אַוועקלייגן ענטפער איך איר געפֿונען די בלאַט: Nymbot keeps only an fingerprint of it, so it cannot show it to you again. A lost key cannot be recovered; revoke it and make another.

און א מפתח איך sk-nymbot- און 43 אותיות, דיגיטלעך, דאַשעס און אַדסקאָרס. The app lists each key by its name and a short hint such as: sk-nymbot-Qm7x…c2Lw.

• א מפתח שייך צו דיין נימ. עס איז געניצט דיין סוואַך, און רק דיין נימ קענען צו מאַכן, שונה אָדער רעקאָד it. Anyone holding the key can spend with it, so treat it like a password.
• ס'איז דא א קאפ אין sats. אַ קליי קענען האָבן אַ באַזוכן קאַפּ, און די קאַפּ קענען ראַסטאַד יעדער טאָג, יעדער וואָך (שני) אָדער יעדער חודש (שני) בייַ 00:00 UTC. עס באַזוכן צוויי סוואַקלעס, אַ סטאַרדייד קרעדיט ווי 10 סאַט און אַ פּרו קרעדיט ווי 100, אַזוי עס מיינט די ווידעא וואָס סוואַקל אַ באַזוכן באַזוכן. Before a request runs, the most it could cost (rounded up to whole credits) is set against what is left of the cap. If it does not fit, the request is rejected with 403 key_limit_reachedאון דעריבער, איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך האָבּ איך max_tokens A request is charged what it actually costs and that counts against the cap, so if the provider reports more tokens than were set aside, the last request that fit can take the key a little past its cap; the next one is then rejected.
• אַ געשעפט קאַט איז פשוט געשעפט די הוצאות. A key at its cap can still check the balance, read its history, list models, count tokens, top up and check on a video it already started.
• עס איז א פוטנציאל. נאָך די תאריך וואָס איר געפירט, די מפתח יפסיק לעבוד.
• כ'האף די ווען (מיטן דרייווער) זאלן מארך ימים זיין עס איז געגרינדעט אין די רשימה, געגרינדעט געגרינדעט, so its spending history still makes sense.
• איר קענען האָבן אַרויף צו 25 אַקטיוו קלייז, יעדער מיט אַ פאַרשידענע נומער. Changing a key's reset period starts a new period at zero.

עס איז געווען א באקאנטע טעמפּעראַטור, און עס איז א באקאנטע טעמפּעראַטור, און א באקאנטע טעמפּעראַטור. באַקומען Key.

אַוועקלייגן אַ בקשה

און מיך [חלילה, נישט מיך - איך מיין די רעכטע] אויך נישט!

א טעמפּעראַטור, אַנודע, אַוועקלייגן אָדער אַפּערייטד Key Returns 401מיט די קוד missing_api_key, invalid_api_key, revoked_api_key און expired_api_keyרעקאָרדינג מאָדעלז, אַודיו מאָדעלז און קולס, און באַצאָלונג מעטהאָדס זײַנען אין קליי.

בילדס, וידאו, רעש, טראַנסיפאָריפּ און אַביידינגז קענען אויך זיין אַפּלייסיד פֿאַר אַ באַשטימען אויף אַ זאך איבער Lightning אין אַ קויל: send the request without one and pay the invoice in the lightning. 402 ענטפער איך באַצאָלן אויף באַצאָלן אין מפתח.

Key management, the account summary and automatic top-ups are the exception: they take a signature from your nym instead of a key, so a leaked key cannot make more keys. דרישות צו חשבון.

היפּש א בקשה

עס איז געווען א באקאנטע געשעפט, און א באקאנטע געשעפט, און א באקאנטע געשעפט און א באקאנטע געשעפט, און א באקאנטע געשעפט. 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 עס איז אַ נומבאָט פון נומבאָט, פּרייַז פון די סטאַנדאַרד סוואל. Putting a catalog model's id there instead, such as: anthropic/claude-sonnet-5איך בין נישט דעם Pro Balance. לייענען מאָדעלס יעדער איינער האט א ID.

וועלכע העלות של בקשה?

די API באַשטימען די צייַט ווי די אַפּ.

• איז א איזון. nymbot/auto עס איז סטאַנדאַרד אַוועקלייגן (10 sats a credit). Every other chat model spends the פּער די סטאַנדאַרד בילד גנרטער און די סטאַנדאַרד ווויל געניצט סטאַנדאַרד קרעדיטס; יעדער אנדערע גנרטער געניצט פּראָ. באַרדדדינגס געניצט סטאַנדאַרד קרעדיטס. טרנסקריפּיישאַן געניצט סטאַנדאַרד קרעדיטס ווען די סטאַנדאַרד סוואל קענען געניצט עס, און פּראָ קרעדיטס אנדערע. The model list says which balance each model spends.
• וועלכע A chat request is metered on the tokens the model actually read and written, at the provider's published rates. That price has a 5% fee added and is then multiplied by 1.5, so you pay 1.575 times the provider's list price. It is converted to sats at the live Bitcoin price and charged in 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.
• די מינימום יעדער מאַטערד פאָרשלאָגן וואָס רירעוודיק קוינט מינימום 0.05 קרעדיט: half a sat on the standard balance, 5 sats on Pro. Fractions of a credit are carried over, not rounded up each time.
• דעריבער אז ישיבה. אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּער 402 insufficient_balance און מיך [חלילה, נישט מיך - איך מיין די רעכטע] אויך נישט!owed_sats אין די nymbot און דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער.
• אין די קרדיט. If the balance cannot cover the hold, the request is rejected with 402 די טעות איז א טעות וואָס איז קצר, כמה סטאַץ די ביקוש זקוקן, און כמה זענען פּאָטער. max_tokens יעדער איינער האט א קטן.
• און א כישלונות. A request that fails costs nothing, unless the provider billed for the work it did before failing, or a web search or the nymbot/auto טעלעפאָנירן שרייַבן איז געגרינדעט; אז עס איז וואָס איר באַקומען, מינימום 0.05 קרעדיט. A stream you cut off is charged for the tokens the provider reports: Nymbot keeps reading the provider's stream for up to 25 seconds after you leave to get that count. If it doesn't arrive, the charge is estimated from what you sent and what was written, and for a model that reasons it includes the entire output allowance of the hold. A request whose connection drops still ends and is charged.
• WEB דעריבער $0.008 פּרייַז אַ פאָרשונג, קאַמפּערד צו סאַטס, whenever a search ran, whether the model then answers or fails. The pages it reads are also sent to the model as input, so they add their tokens.

יעדער ענטפער איז א ענטפער.JSON responses carry a nymbot עס איז געפונען מיט די סאַלאַגן וואָס איז געפונען פון, די באַצאָלן אין קרעדיטז און סאַטס, און וואָס איז געפונען:

עס איז א Object

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

PAYED RESPONSES also carry these headers, which is where to look for the cost of a response that is not JSON, such as speech:

פּער מיליאָן טאָקאַנץ, אַרייַנננעמען די פּערמיט און מאַריאַ, זענען אין די מאָל. רשימה אַוועקלייגן, אַוועקלייגן, און אַוועקלייגן דער פּרייַזIf the Bitcoin price can't be read, באַזוכן באַזוכן באַזוכן באַזוכן 503 price_unavailable און Retry-After: 60 אין די געשעפטן.

טעות

כל שגיאה האט די אותו צורה, איינער אַז OpenAI קלייאַנץ אַוואַך מבין. code און מיך [חלילה, נישט מיך - איך מיין די רעכטע] אויך נישט! message יעדער איינער כפי יכולתו, and may change.

טעות גוף

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

וועגן 2 Exceptions:

• /api/v1/messages ענטפערז אין Anthropic's error format, ווי עס איז וואָס Anthropic Clients פּאַרס: {"type": "error", "error": {"type": "authentication_error", "message": "…"}}און איך בין דער סטאַטן: invalid_request_error, authentication_error, billing_error (402), permission_error, not_found_error, request_too_large, rate_limit_error, api_error און overloaded_error (503).
• אַ סטרימינג אָפּשטימאַן וואָס געשלעכט אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּער

טעלעפאָנירן אין אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַפּערייטינג אַ

געשעפט

אַ לינק צו אַ בילד זײַנען צו אַ ציבור הוסט: אַ אַדרעס אויף אַ פּריוואַטיוו אָדער מקומי נעט, אָדער אויף Nymbot's own sites, איז געניצט. Provider pacing that applies in the app app also applies here, so a burst of requests to one provider can be slowed down rather than failed.

איך האב איך געקומען

די API איז לא פּריוואַטיווע אין די צייַט פון די אַפּס, און עס איז שווה זיין ספּעציעל וועגן איך.

• עס איז אין סוף צו צופרידן. אין די אַפּס, אַ אָנזאָג איז געפירט אויף דיין מכשיר צו טייַז only Nymbot holds and travels as a key. דעריבער Wrapאַ API request איז רגיל HTTPS: עס איז סקיפטיד אויף די וועג צו Nymbot, און Nymbot's server reads it in the clear to handle it.
• ס'איז דא א באקאנטע שאלות ולא תשובות. איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב איך האָב דעריבער היסטוריה A usage record of the same request (time, type, model, token counts, cost, duration and whether it used web search or succeeded) is also kept for 90 days, alongside the app's own.
• כל דבר אחר געגרינדעט פֿאַר אַ נימ איז קטן און רשימה כאן. און מפתח זענען שטעלן ווי אַ hash, never the key, with their name, a short hint, spending cap, reset period, expiration and when they were made and last used; only the latest 50 revoked keys are retained. אַוטומאַטיש טאָפאָפּ ווידאו אַרבעטז זענען באַקומען פֿאַר 24 שעה. באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען באַקומען
• אַפּ אַפּ אַפּ אַפּ אַפּ אַפּ אַפּ אַפּ אַפּ אַפּ. A באַקומען WIPE דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער, דעריבער.
• דער פּראָבלעם פון דעם מאָדעל זען דיין בקשהCatalog models run at their makers; standard routes and embeddings run on Cloudflare.
• די מדיה זענען ציבור. די בילד און וידאו געפירט ווי לינקס זענען אַפאָרדעד צו ציבור Blossom file hosts, where a file's address is its hash. Anyone with the link can open it, and Nymbot cannot take it down again. b64_json און אַ בילד געגרינדעט איז געגרינדעט צוריק אין די ענטפער און איז לעולם לא העלפן.
• און אז זענען די תמונות איר צו אַ גנרטער. אַ פאַרווודיק פון you upload to לייענעןאון איך בין א data: URL אין אַ גנרטער image_url, איז העלפן צו אַ ציבור Blossom הוסט ערשטער אַזוי די גאַנדרער קענען אַוועקלייגן עס, and the same applies to it. A picture sent by https:// די בילדער אין אַ צ אט באַזוכן אַרויף צו די מאָדעל פון אַ פּראָוואַדרער, לא צו Blossom.
• א מפתח איז צוגעשטעלט צו דיין נימ. Everything a key spends comes out of your nym's balance, אַזוי API use is not אַנאָניוםIf you want API use kept apart from your everyday nym, make the keys from a separate nym with its own balance.

If you need the protection of the apps, use the apps. The API is for when you need the models in your own tools.

יעדער סוף

“Nym” מיינט אַ פאָרשלאָגן געגרינדעט דורך דיין Nostr key, דעפּריסיד אין דרישות צו חשבוןפֿאַר עקספּעראַמאַנץ וואָס האָבן אַוועקלייגן די פורמטז, זען סענטימעטער און SDKs, און פֿאַר קודינג אַגאַנץ אַזאַ ווי Claude Code, Codex און Cline, זען קאָדינג Tools.