Nimdeɛ a wɔde gyina so / Akanfoɔ a wɔyɛ adwuma a wɔyɛ nneɛma foforɔ

API nkyerɛaseɛ

Wo de mɔdeɛ, mmoa nsuakyerɛfoɔ ne nneɛma a ɛdi mu a wode wɔ app no mu, ɛfiri wo code mu. API no ka OpenAI ne Anthropic kɔmɔ kɔmɔ no, enti adwuma bebree ne SDKs yɛ adwuma sɛ wɔseseɛ base URL ne key bi.

Wɔde mfiri na ɛkyerɛ krataafa yi ase sɛnea ɛbɛyɛ a ɛbɛyɛ mmerɛw. Engiresi kasa mu mfitiase de no ne nkyerɛase a ɛfa ho.

API no ho sɛn ne sɛ?

HTTP API bi wɔ nymbot.ai ɛyɛ deɛ ɛbɛtumi ayɛ adwuma a OpenAI anaa Anthropic client hyɛ aseɛ kɔ sɛɛ. Wobɛnya:

• Kasa Mu Nneɛma, noɔ""" Responses API ne Anthropic Nsɛmfua, ne streaming, nkɔtwɛ, nhwɛsoɔ, adwene mmuaeɛ ne web search, ma model biara a ɛwɔ asɛmmuo nkyerɛkyerɛmu na ɛyɛ Nymbot n'ankasa auto-routing no nso ho.
• Mfoni, vidio, kasamu, atwerɛdeɛ ne embeddings.
• Wo akɔnten, Lightning nnyinasoɔɔ, wo wallet foforo kɔmdeɛ nkyerɛkyerɛmu a ɛyɛ mmerɛwie wɔ wo wallet firi wo wallet firi wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛmu afiri wo wallet mu nkyerɛkyerɛ na nea a kwankyerɛ ahoɔden adeɛ biara a wɔsrɛ no nnyidie mfasoɔ ne ne sɛnea ɛdi kɔ.

Ɛyɛ adeɛ a wɔbɔ no firi ɛnum no mmienu no mu no ara mmoa nnyigyeɛ te sɛ app no, wɔ ɛpono a ɛho hia no ara. Ɛnyɛ subscription na ɛnyɛ mfɛre biara nni wɔ API no so: ɔkɔdi biara yɛ ade a wotua so wɔ kredi a wotɔeɛ mu.

Ɛde a API no annyɛ ne sɛ ɛbɛhyɛ biribi foforɔ a ɛfiri Nymbot hɔ. Wo mpaeɛ no kɔ model no nkyɛn sɛnea wogyee wɔn no: Nymbot system prompt biara nni hɔ, nkaeɛ biara nni hɔ, nnɔkra anaa kasa mu nkyerɛkyerɛmu biara nni hɔ. Nea ɛba no ne model no mmuaeɛ ne nkyerɛkyerɛ a ɛkyerɛ sɛnea ɛkaa wo sika.

Base URL noho dwumadie kwan no

Endpoint biara tena ase wɔ /api/v1/. Akwan a yɛnni nimdeɛ san 404 na ɛyɛ nkɔmɔ a wɔfrɛ no kwan a wɔde kwan a ɛnyɛ no fam na ɛsan 405, ne mmienu te sɛ JSON.

API noa de mmuaeɛ kɔ cross-origin request biara firi site biara, enti browser page bi bɛtumi aka no. Nanso, biribiara a wode kɔ browser mu no, obi a ɔbɛtwe no nyinaa bɛtumi akenkan no, enti ɛyɛ sɛ wode key a ne mfonini nti nnye kɛseɛ bi na woyɛ saa akokoɔduo. Wo nym (keys, account summary, NWC auto-top-up ne refund redemption) a wode asii endpoints no yɛ exception: wɔ browser mu no, Nymbot n'ankasa website biara nko na wɔde bue. Hwɛ akonta nhwehwɛ mmea bi a wɔrehyɛ nwentoma so.

Fa JSON body biara nkyerɛɛkyerɛmu kɔ so Content-Type: application/jsonƆbɔ mmɔden biara foforɔ no yɛ ɛsɛɛ sɛ wɔtwe no wɔ 415, enti HTML form tiawa anaa a text/plain fɛre firi daakoa kɔmɔ foforɔ bi a ɛntumi nkyia API no. Sɛ wode cURL di dwuma a, fa pass -H "Content-Type: application/json" ne nea ɛda so ne -d.

API nkyerɛkyerɛmu mfeɛ no

Abɛɛtɔ no wɔ app no mu yɛ. Ma mu. API web app no sidebar mu no, anaa Android ne iOS menu no mu no, na tap Hyehyɛ akofua. Ma no din na, sɛ wopɛ a, akɛnteɛ ne awieɛ da.

Yei kwan no bɛhyerɛ wo ara koro bi. Fa kɔto wo biase baabi a ɛyɛ fɛ a wubɛtumi akae ansa na woatwa nkyɛn no: Nymbot aka biakoyɛ nko ara fa ho, enti ɛntumi mmuhyɛ wo koro bio. Sɛ wate kwan no a a wanyin a, wubetumi nnya no bio; fa tɔ no ase na ɛwie, na ɛyɛ foforɔ.

Abɛgye bi te sɛ sk-nymbot- na ɛfa nkyerɛwee mmiensa ne adidi mmienu, nɔba ne asubɔnten a ɛwɔ hɔ a ɛda so. App no kyerɛ nkyerɛkyerɛmu biara kɔkɔɔ ne din ne nkɔmmɔ bɛtwɛ nkyerɛkyerɛmu a ɛyɛ mmerɛ te sɛ sk-nymbot-Qm7x…c2Lw.

• Abɛn bi ye wo din. Ɛde wo sika de kɔ, na wo nketewa nko ara na tete, sesa anaa kyerɛ aseɛ. Obiara a ɔwɔ kɔtɔ no mu no ɔbɛtumi de sika di dwuma, enti fa no sɛ apɔnkyerɛ.
• Caps wɔ sats mu. Kae bi nni spending cap, na saa cap no bɛtumi ahyɛ ase da biara, week biara (Memeneda) anaa moonth biara (nkano no), wɔ 00:00 UTC biara. Ɛhyɛ akontaabu mmienu no so, ɛde standard credit nkano 10 sats na ɛde Pro credit nkano 100, ɛneɛ ɛkyerɛ sɛnea ɛteɛ no ne sɛnea akontabuo biara bɛdi dwuma no. Ansa na asɛm bi bɛyɛ, nea ɛbɛtumi akyerɛ dwuma no kɛseɛ paa (de credit nkano kɔ so) no bɛhyɛ nea ɛdi cap no ase so. Sɛ ɛntumi nnye no a, wɔatua asɛm no toɔ sɛ 403 key_limit_reached, sɛ mmuaeɛ no bɛba mfasoɔ kɛseɛ no nti pɛpɛɛpɛ; ɛsɛ kyerɛ sɛ ɛda hɔ sɛn na ɛbɛsi sɛ ɛbɛsakra. Sɛ wɔsesa... max_tokens ɛma ne ɛtɔ mpaebɔ a ɛyɛ mpaebɔ no mu yɛ kakra. Wɔde asɛm a ɛkɔ no mu kyerɛ ne nnyigyeɛ a ɛkyere no, na ɛyɛ adwuma wɔ cap no mu, enti sɛ asɛmfoɔ no bɔ amanneɛ sɛ token no bɔɔ mfeɛ pii a wɔahyɛ hɔ no nkyɛn a, asɛm a ɛtɔɔ hɔ no akyiri no bɛtumi aka key no nkyɛn kakra kɔ cap no nkyɛn; na ɛtɔm asɛm a ɛrebɛba no no wɔbɛrefu no.
• Sika a ɛwɔ nsa mu a ɛakɔ ne nanteɛ no, ɛtumi ma ɛdwene sɛ ɛbɛma wo nanteɛ nko ara. Abɛpɛn bi a ɛwɔ ne nkyɛn no nso bɛtumi asɛe ahomegye, asesa ne amanneɛ, asɛe mmoa akwan ahorow, nkontaa nkyerɛ, de sika nkyɛ, na asɛe video a ɔahyɛ aseɛ no.
• Ɛpɛ sɛ ɛwɔ biara nni hɔ. Ɛda a wopɛ no akyi no, mfuakɔ no gyina ase.
• Ɛkyerɛ nneɛma mu kwan no yɛ ntɛm na ɛyɛ afei. Sɛ wɔahyɛ kɔti kɛseɛ bi a, ɛnyɛ ne mpaebɔ a ɛrebɛba no nyinaa bɛyɛ mpaebɔ a ɛnyɛ nokware. Ɛrennyɛ biara wɔ list no mu, na wɔahyɛ sɛ ɛyɛ kɔti kɛseɛ, na mmom ɛneɛ ne sɛnea ɔdi dwuma daa no bɛtena mu yie.
• Wobɛtumi wɔ active keys 25 kɔsi sɛ ɛreba, nea nea biara wɔ ne din anom. Sɛ wosenya key bi n'atena ne mmerɛ bi ase a, ɛyɛ ne mmerɛ foforo a ɛbea ɛnyina ɛhɔ.

Adeɛ a ɛkyerɛw wɔ nkyerɛw no mu no kyerɛw nkyɛn biara adan nkwatow wɔ saa berɛ yi mu ne ne nyinaa, ne berɛ a wɔahyɛɛ no noɔn, mo nkwatow mmienu nyinaa, ne mo API nkwatow a ɛbɛbaeɛ mmerɛw yi mu. Ɛfiri ɛhɔ na ɛkyerɛ nkyerɛkyerɛmu no wɔ saa kɔmputa yi ase wɔ adeɛ a ɛmmu ho hwɛ.

Hwɛ ɔpɛbusɛm bi ho sɛ ɛyɛ nokware

Ma kɔ adesua no wɔ awa bi a ɛwɔ ɛyi mu biako mu. Wɔ nya pɛpɛɛpɛ, enti fa ne a w’afirifo no de kɔ so no ara:

Sɛ kɔtekɔ a ɛnni hɔ, a yɛnni aseɛ nka ho asɛm, a wɔatwa mmuatɔ, anaa a ɛatwa awieɛ ba a ɛde ɛhyɛ [[returns]] 401, ne kɔdu no nea missing_api_key, invalid_api_key, revoked_api_key annaa expired_api_keyModels, audio models ne nneɛma a wɔde ka kasa, ne akwadifoɔ nneɛma ho nkyerɛkyerɛmu ɛnyɛ nkyerɛkyerɛmu kɛseɛ bi wɔ hɔ a ɛhia.

Mfoni, video, kasa, nkyerɛaseɛ ne embeddings nso bɛtumi awɔ sɛ ade a wɔtɔ no kɔtɔ baako kɔtɔ baako wɔ Lightning so sɛnea ɛte sɛ wɔn no nkyerɛkyerɛmu biara nni hɔ: tumi hyɛ wo asɛm no sɛnea ɛte sɛ wɔn no na to wo mfɛre no wɔ 402 tua. Hwɛ Sika a wɔde hyɛ mpaebɔ biara so sɛ wammɛ kyɛ biara.

Kyerɛw mu mpaebɔ, akonta buom ne mmoa nteteeɛ ne deɛ ɛyɛ nkwasea: wɔhia wo nym nkyerɛw sɛnea ɛte sɛ kɛ (key), enti sɛ kɛ bi bue a, ɛntumi nnye kɛ foforo. Hwɛ akonta nhwehwɛ mmea bi a wɔrehyɛ nwentoma so.

Wo animim mɔborɔdeɛ a ɛdi kan no

Fa kwan a ɛdi so ma key no wɔ environment variable mu, ɛnna frɛ model bi sɛ ɔbɛka biribi kyerɛ wo. Mfatoho a ɛwɔ saa nkyerɛkyerɛ yi mu nyinaa kɔtɔ no firi 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 Ɛne Nymbot nka n'ankasa kwan, a wɔde ɛkyɛnu a ɛwɔ standard balance no na wɔbɔ. Fa katalog model id bi hyɛ hɔ akyi, te sɛ anthropic/claude-sonnet-5, sɛ wɔde saa model no fi Pro balance no mu. Mmoa a wɔn wɔ list mu no ma id biara.

Sɛ ɛyɛ asɛm bi a ɛdi anigyeɛ no, ɛyɛ sɛnea ɛdi anosamu.

API no bɔ wo sika antdodoɔ a app no bɔ wo sika antdodoɔ pɛ.

• Ɛdeɛn mmeae a ɛwɔ hɔ no? nymbot/auto ɔtwe ne... Kanu balance (10 sats a credit). Ɛbiara a ɛkyerɛ adeɛ a ɛdi kan biara kɔ adeɛ no Ɔkyerɛkyerɛfoɔ akɔnten (100 sats a ɛwɔ credit mu). Adaniba a ɛda hɔ no de akɔnten a ɛda hɔ na ɛdi dwuma; afutuo biara a ɛnyɛ adaniba a ɛda hɔ no de Pro na ɛdi dwuma. Embeddings de akɔnten a ɛda hɔ na ɛdi dwuma. Transcription de akɔnten a ɛda hɔ na ɛdi dwuma sɛ akɔnten a ɛda hɔ no bɛtumi ammu no, na sɛ ɛnyɛ saa a ɛde Pro na ɛdi dwuma. Model list no kyerɛ sɛ akɔnten bɛn na model biara di dwuma.
• Ɛyɛ sɛn? Chat asɛm a wopɛ sɛ wosua no, wɔgye ne bo wɔ tokens a model no akenkan ne a ɔatwerɛ no so, sɛnea ɔde asɛe no asɛe. Wɔbɔ 5% fee bɔ ne bo, na ɛnna wɔde 1.5 yɛ no kɛseɛ, enti wopɛ sɛ wopɛ nnyigyei a ɛyɛ 1.575 dwumadie wɔ asɛe no so. Wɔde kɔ sats wɔ Bitcoin dwuma no a ɛkɔ so nnɛ so, na wɔgye wo so wɔ credit a ɛyɛ akyɛdeɛ kakra mu. Pro pictures, video ne asɛm a wɔka no, wɔgye ne bo sɛnea woyɛ no, sɛnea woka no, anaa sɛnea wotwerɛ no, na transcription nso wɔ ne bo sɛnea audio no kɔ so wɔ sekon no mu, wɔde fee ne nsuo no ara. Standard picture no yɛ credit 5, na standard voice no nso yɛ credit 3.
• Minimɛ no. Adeɛ biara a ɛdi awɔden mmeae a ɛyɛ adwuma no, ɛkyerɛ credit 0.05 kɔmɔ: standard balance no so, sat aduasa ntam (half a sat), Pro so nso, sats nwɔtwe. Credit a ɛnyɛ kɔmɔ no kɔ so kɔ mpo, wɔnnyɛ no kɔmɔ kɔ mpo biara ara.
• Gyina, na dwo. Ansa sɛ asɛm bi bɛyɛ adwuma, nea ɛbɛtumi ayɛ nnyigyeɛ kɛseɛ no wɔ hɔ wɔ wo mu nnyigyeɛ mu, ɛfa nea woyɛde abɔ no ne nea nkyerɛwee (tokens) kɛseɛ a ɛbɛtumi ahyɛ no ho. Asɛm a ɛnsɛ mmuaeɛ (plain ASCII) nna mfeɛ no mu, wɔgye ne UTF-8 bytes mu nkyerɛkyerɛmu, na ASCII namba ne nkyerɛwee biara yɛ token baako, enti asɛm biara a ɛwɔ kɔmputa mu, kɔd (code) ne namba nyinaa wɔ hɔ wɔ nnyigyeɛ mu. Nnyigyeɛ no wɔ hɔ wɔ nnyigyeɛ kɛseɛ mu, koraa na ɛnyɛ baako, enti asɛm biara hia nnyigyeɛ (sats) 10 a ɛdi ase wɔ standard balance mu anaa 100 sats wɔ Pro mu sɛnea ɛbɛtumi ahyɛ ase. Nea ɛdi nnyigyeɛ kɛseɛ no nko ara na wɔfa no; nea ɛdɔɔn no nnya no nnyigyeɛ no wɔ hɔ kɔsi sɛ ɛrebɛyɛ adwuma; sɛ nnyigyeɛ a wɔatumi de ayɛ adwuma no nnya nkyerɛkyerɛmu koraa a, stream no bɛba nkyerɛkyerɛmu bi ne a 402 insufficient_balance ɔsɛhwɛ dwumadie, na nea wɔyɛɛ no no, wɔtua nea wɔyɛɛ no nsa. Sɛ kɔtɔ kwan no yɛ kɛseɛ sen sɛ ahonya no bɛtumi atua a, wɔfa ahonya no nyinaa, na ɛdi nkyɛn no no, ɛda wo borɔdeɛ so (owed_sats wɔ no mu nymbot adeɛ a ɛdi mu, ne adeɛ a ɛte mmerɛw. Adeɛ a wɔde n’asɛm nkyɛ a ɛhia no, wɔde n’asɛm nkyɛ a ɛba kɔ anim no na wɔde hyɛ so. Ɛsɛ sɛ wɔhyɛ no so ansa na adeɛ biara a ɛwɔ saa balance no no bɛtena hɔ na yɛatumi adeɛ bi de ayɛ adwuma: ɛnyɛ API, nnyigyei wɔ app no mu, nnyigyei a wɔde kɔ foforɔ anaa adeɛ a wɔde ma obi a ɛyɛ ɔdɔ.
• Akyɛdeɛ nni hɔ a ɛda hɔ. Sɛ akontaabu no ntumi nnye hold no a, asɛm no wɔapa ne 402 adeɛ biara anante ase ansa na ɛnyɛ saa. Error no ka kyerɛ sɛ adanɔɔsan bɛn na ɛno nti, sɛ asɛm no hia sɛn sats na ɛhia ne sɛ ɛda hɔ bɛn. Adeɛ bi a ɛsi kɛseɛ max_tokens Ɛkyerɛ nkataa ketewa.
• Nkabom. A mpaebɔ a ɛnyɛ adwuma biara nni nkyɛm, sɛ provider no nnya nkyɛm wɔ adwuma a ɔyɛe ansa na ɔnhyɛ aseɛ no, anaa web search anaa nea nymbot/auto adwuma asɛm a ɛda mu no, ɛtɔ so; ɛno na wopɛ sɛ wesi, ɛkorɔ kɛseɛ biako anadwo 0.05 credit. Sɛ wopue stream bi a, wɔtwa nkyɛn no, wɔtua mfonini (tokens) a provider no de kyerɛ no nti: Nymbot kɔ so kenkan provider no stream no wɔ sɛnea ɛbɛyɛ a ɛbɛyɛ sɛ ɛrekɔ so wɔ mmienu anum (25) seconds a wofiri hɔ no so na ɔnhu saakyerrɛ no. Sɛ ɛmfa ba a, wɔyɛ adwuma mu nnyigyei (estimate) wɔ nea woyɛeɛ ne nea a wɔatwerɛ no mu, na ɛyɛ model a ɔhyɛ mmereɛ (reasons) a, ɛkyerɛ nea ɛwɔ hold no mu nyinaa. Sɛ wo connection mu tɔ a, asɛm no kɔ so na wɔtua nea ɛwɔ mu.
• Web dwesuapuo Ɛhyɛ $0.008 kwa wɔ hwɛ biara so, a wɔahyɛ no sɛ sats, ɛnyɛ sɛ model no bɛyɛ nkaasɛm anaa ɔbɛyɛ mpan. Afã a ɔsene no nso wɔde kɔ model no ntam sɛ biribi a wɔbɛde adi dwuma, enti ɛhyɛ token no mu.

Mmuaeɛ biara ka nea ɛtɔ ne sɛnea ɛyɛɛ. JSON mmuaeɛ no kura bi ᵃ nymbot nneɛma a ɛwɔ ne mu ne sika a wɔde hyɛɛ no so no, credits ne sats a wɔde hyɛɛ no so no, ne nea ɛda ase no:

Sika a ɛdi adeɛ no

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

Agyaedwuma mmuaeɛ no kura saa nhoma titiriw yi mu, ɛno ne baabi a wɔbɛhwɛ akyerɛwdeɛ a ɛnyɛ JSON no sɛnea ɛsi, te sɛ kasa:

Ɔsika a wɔde hyɛ aseɛ ɛsɛɛm million tokens, a ɛwɔ fee ne margin mu no, wɔ... mmeae kɔntaa dollars ne sats mu, na ɛda so ɔdwom papayɛ no. Sɛ wɔntumi nnya Bitcoin nnuane no adi a, adeɛ a wɔde sika awɔfɛ no hyɛ nkyerɛwee 503 price_unavailable ne ho Retry-After: 60 sɛnea ɛbɛyɛ a yɛbɛnya nkaeɛ, na ɛnyɛ sɛ yɛsu mpaebɔ.

Nkabommuo

Ɔsɛe biara wɔ adeɛ a ɛyɛ koro, ɛno ne de a OpenAI nnamfo nim no ananwu. code ɛyɛ din a ɛtena mu a wubetumi de hyia; message ɛyɛ nnipa nti na ɛtumi asesa.

Nkabom mu mpanin

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

Nneɛma mmienu a ɛnyɛ nea ɛda so:

• /api/v1/messages ebua wɔ Anthropic error format mu, ɛfiri sɛ ɛno ne nea Anthropic klienti sesa: {"type": "error", "error": {"type": "authentication_error", "message": "…"}}. Ei nkyerɛkyerɛmu no di status no akyi: invalid_request_error, authentication_error, billing_error (402), permission_error, not_found_error, request_too_large, rate_limit_error, api_error annaa overloaded_error (503).
• Sɛ streaming request bi sɛe ansa na ne byte a ɛdi kan bɛba a, ɛnya JSON error a ɛyɛ nea ɛda so ne status a ɛwɔ aseɛ yi so, ɛnyɛ event stream. Sɛ stream no asɔɔ ase na ɛsɛe a, wɔhyɛ no sɛ stream no atifi event no, wɔnea endpoint no format mu.

Mfomsoɔ nkan no nnyɛ adeɛ a ɛda beba bi mu nkyerɛkyerɛmu a ɛda ne ho hɔ ho. Wɔsesa Ɔdeɛ no mfomsoɔ asɛm no ansa na ɛbɛba wo nkyɛn.

Nkyɛmu

Asɛm bɔm a ɛfa mfonini bi ho no ɛsɛ sɛ ɛkɔ mpɛn sɛ obiara hu: bɔne a ɛfa aban kɛseɛ bi anaa mpɔtam a ɛne wo nkyɛn bɔ ne ho no, anaa Nymbot n'asɛm mu no, yɛa ɛgye so. Ɔsomfo ne ne ho nneyɛe a ɛwɔ app no mu no ɛbɛyɛ wɔ ha nso, enti sɛ wobɛde asɛm pii kɔ ɔsomfo baako nkyɛn a, wɔbɛtumi akɔ so kɔ ma no kɔmɔ mpo mma mma ɛnyɛ sɛ wɔasɛe no.

Dɛn na API no bɛtumi ahu

API no nyɛ ahosɛm a ɛyɛ kɔkɔɔ sɛnea app no ho te, na ɛsɛ sɛ yɛka kyerɛ ɛdeɛdɛ koraa sɛnea ɛteɛ.

• Ɛnyɛ end-to-end encryption. Wɔ app no mu no, nkyerɛkyerɛmu bi wɔ wo device no mu a Nymbot nko ara wɔ n'akwan mu nkyɛdeɛ no na ɛkɔ so sɛ asɛm fɛfɛ a wɔde hyɛ ɛda ade mu. API mpaebɔ bi yɛ HTTPS a ɛte sɛnea ɛte no: wɔhyehyɛ mu wɔ kwan no so kɔ Nymbot, na Nymbot server no nso tete mu sɛnea ɛte sɛnea ɛbɛtumi ahyɛ aseɛ.
• Nsɛm a wopɛ sɛ woka ne mbuasɛm nnyɛ ne de a wɔde to so. Wɔfa wɔn kɔ mɔdèl no mu na mmuae no nso ba ase. Nea wɔsiesie ne nnuae nnuane no: ɛpono biara a wɔde bɛpɛ no, mmerɛ no, mɔdèl no, nea ɛyɛ no, token nkontaa, ahoɔden, nnuae nkontaa, sika, nea ɛdi n’anim, key no, ne sɛ ɛyɛɛ adwuma anaa, ɛnam nnɔkra nkron (90 days) mu, nea ɛyɛ ne nea asɛm hwɛbea ɛkyerɛ wo. Ɛkyerɛnea wo de komm kyerɛɛ adeɛ no nkyerɛkyerɛmu (berɛ, ne sɛnea ɛyɛ, model, token adidi, ahoɔden a ɛdi ansa na ɛyɛɛ no, ne sɛ ɛde web search dii dwuma anaa ɛyɛɛ adeɛ no) no wɔ hɔ kɔsi nnɔkra adidi, ɛda app no nkyerɛkyerɛmu ne ne nkyerɛkyerɛmu a ɛwɔ hɔ no nkyɛn.
• Nea ɛkɔ so biara a ɛwɔ nym no mu yɛ ketewa na wɔatwerɛ no wɔ ha. API nkyerɛkyerɛmu mfeɛ no Wɔde hash hyɛ so, ɛnyɛ key no ara, ne wɔn din, hint a ɛyɛ ketewa, sika a wɔbɛtu a ɛnyɛ kɛse, berɛ a wɔbɛsesa no, berɛ a ɛbɛba awieɛ, ne berɛ a wɔyɛɛ hɔ ne berɛ a wɔde kɔɔ so mmerɛ a ɛtɔɔ so; key a wɔasɛe a ɛneɛ no mmienu (50) a ɛtɔɔ so titiriw no nko ara na wɔhyɛ so. An deɛ ɛyɛ nokwafoɔ mmerɛ a wɔde mpanin bɔ ho anaa mpanin nnyimpa nkyerɛkyerɛmu wallet kɔkɔɔ kɔmɔ no wɔ dehyɛɛ mu, ne threshold, sika adɔnten, ne ɛda a ɛda akyi no top-up no nti nneɛma no wɔ hɔ. Video adwuma no wɔ hɔ wɔ nnɔnansan (24) nnɔn mu. Sika a wɔde bɔ mpaeɛ wɔ nnɔbaeɛ biara a ɛma Lightning payment hash kɛkɛ wɔ hɔ wɔ nnɔnnsɔn (7) nnɔn mu na hashed refund token kɛkɛ wɔ nnɔn (30) nnɔn mu, na ɛnye obiara din anaa adanfoɔ biara ho asɛm. Sika a ɛnyɛ sɛ ɛbɛtumi akyɛ no, wɔde kɔ mpaeɛ mu sɛ sika a ɛhia kɔsi sɛ top-up bi bɛma wɔn nti.
• Sɛ wopira app no a, ɛtwa no ase. A deɛ ɛwɔ mfonini no nyinaa hwɛ bɔ de asa owia ne API key biara na ɛsesa na ɛyɛ no ase, na ɛyɛ query history, usage records, wallet connection ne video jobs no ase. Sika a ɛwɔ wo aka ne nnuae biara a wode nnuae foforɔ bɛtɔ a ɛka wo ho no, ɛtena nym no so.
• Model no nkyerɛkyerɛfoɔ huu wo asɛm no, sɛnea ɛyɛ firi app no mu. Catalog models yɛ adwuma wɔ wɔn nnwumafoɔ hɔ; standard routes ne embeddings yɛ adwuma wɔ Cloudflare so.
• Agyina mfonini no yɛ amansan nea wɔwɔ. Mfoni ne video a wɔde nkyerɛkyerɛmu (links) de maa no de to Blossom file hosts a ɛyɛ biara mu, ɛhɔ na file no kwan ne ne hash. Ɛyɛ obi a ɔwɔ link no biara enough sɛ ɔbɛtumi abue no, na Nymbot ntumi mmu mu bio. Bisɛ aseɛ b64_json na ɛyɛ adeɛ a wɔayɛ no kɔm sɛ mmuaeɛ no mu na wɔmfa no kɔto kɔ mmɔden mu ara.
• Enti sɛnea woyɛ saa adeɛ yi, ɛyɛ nkyerɛwee mfonini a ɛyɛ adwuma sɛ mfonini akwan? Mfoni a wode to to... Siesie, anaa tumi de ma bi a data: URL wɔ kyerɛwfo bi ne image_url, wɔde to Blossom host a ɛyɛ kɔm mu ansa na generator no nnya no, na ɛno nso ne saa ara. Mfonini a obi de kɔ https:// link no wɔde no sɛ saa link no ara. Pictures a ɛwɔ chat request bi mu kɔ model provider no nkyɛn, na ɛnyɛ Blossom nkyɛn.
• Abakɔsɛm bi wɔ hɔ a ɛkɔ tie wo nkyerɛwee no nso. Ɛhɔ biara a key hwɛ de di dwuma no, ɛfi wo nym balance no mu, enti API use nyɛ anonymoɔ. Sɛ wopɛ sɛ wode API yɛ adwuma a wopɛ sɛ wode no to wo daa nipa din (nym) mu fapem, ma kɛseɛ no fi nipa din (nym) foforɔ a ɔwɔ ne nea ɛwɔ ne mu (balance) mu.

Sɛ wopɛ app no ahoɔden a, ɛnyɛ app no. API no nso yɛ sɛnea wopɛ sɛ wode model no di dwuma wɔ w'ankasa tools mu.

Endpoint biara

"Nym" kyerɛ asɛm a wɔpɛ a wode wo Nostr key asini, a wɔatwerɛ wɔ akonta nhwehwɛ mmea bi a wɔrehyɛ nwentoma so. Ma nneɛma a ɛtumi di saa nkyerɛwee yi ase no, hwɛ nkwan ne SDKs, na coding nneyɛefaa a ɛte sɛ Claude Code, Codex ne Cline no ho, hwɛ nkɔtwe nneɛma a wɔde yɛ coding.