Kev paub hauv paus Cov neeg tsim software
API cov ntsiab lus tseem ceeb
Cov qauv (models), cov tsim (generators) thiab tus xyoo (balance) uas koj siv hauv lub app, los ntawm koj tus code. Lub API hais txog cov OpenAI thiab Anthropic formats, yog li cov cuab yeej thiab SDKs feem ntau ua hauj lwm los ntawm kev hloov cov base URL thiab ib lub key.
Nplooj ntawv no yog tshuab txhais kom yooj yim. Cov lus Askiv thawj yog cov version uas siv.
API yog dab tsi
Ib HTTP API rau nymbot.ai uas teb cov thov zoo ib yam uas ib tug OpenAI lossis Anthropic
tus neeg siv twb xa mus lawm. Koj yuav tau:
- Kev Teb Lus hauv Kev Sib Txuas Lus, tus API Kev Teb thiab Anthropic Cov Teeb Txheej, nrog rau streaming, cov cuab yeej, cov duab, kev xav thiab kev nrhiav hauv web, rau txhua lub model hauv lub ntawv tshawb fawb thiab rau Nymbot qhov kev teem kev taug kev nws tus kheej.
- Cov duab, video, lus hais, kev sau ntawv thiab embeddings.
- Koj kev sib npog, Ntxiv nyiaj Lightning, nrog qhov tso dag ntxiv nyiaj tsis tu ncua los ntawm koj lub hlwv nyiaj thiab ib keeb kwm tsaug zog txhua qhov thov nqi yog dab tsi.
Nws yog them los ntawm ob tus tib yam nkaus cov nqi tshuaj nqi zoo li lub app, ntawm tus nqi tib yam. Tsis muaj kev nrog lus (subscription) thiab tsis muaj kev pub dawb rau API: txhua qhov thov (request) yog them nyiaj los ntawm cov credits uas koj tau yuav.
Qhov uas API tsis ua yog ntxiv dab tsi ntawm Nymbot tus kheej. Koj cov lus mus rau lub model zoo li koj tau xa mus: tsis muaj Nymbot system prompt, tsis muaj kev nco, tsis muaj cov lus qhia txog hnub tim lossis hom lus. Qhov uas rov qab los yog lub model tus teb thiab cov ntaub ntawv qhia txog tus nqi uas nws tau siv.
URL Lub hauv paus
| Siv | URL Lub hauv paus |
|---|---|
| OpenAI SDKs thiab cov cuab yeej uas muaj peev xwm siv tau nrog OpenAI | https://nymbot.ai/api/v1 |
| Anthropic SDKs thiab Claude Code | https://nymbot.ai/api (lub SDK ntxiv nrog rau /v1/messages tus kheej |
Txhua endpoint nyob hauv qab /api/v1/. Ib txoj kev tsis paub meej rov qab los 404 thiab ib txoj kev uas paub uas raug hu nrog txoj hauj lwm tsis yog yuav rov qab los 405, ob yam li JSON.
API no teem tswv yim los ntawm txhua qhov chaw, yog li ntawd ib lub nplooj ntawv hauv browser tuaj yeem hu tau nws. Txawm li ntawd los, txhua yam uas koj xa mus rau hauv browser yuav raug nyeem los ntawm leej twg los yog nws qhib, yog li ntawd tsuas ua li ntawd nrog ib lub chaw uas muaj... lub tshoobCov qhov chaw kawm uas muaj koj npe (keys, lub ntsiab lus ntawm tus xyeev, NWC auto-top-up thiab refund redemption) yog qhov tsis zoo: hauv ib lub browser, lawv teb rau Nymbot tus kheej lub vev xaib xwb. Saib ua npe thov kev koom tes nrog tus account.
Xa txhua JSON body nrog Content-Type: application/json. Txhua hom lwm yam yog
tswv nrog 415, yog ib qho HTML form tsis muaj dab tsi lossis ib qho text/plain thov ntawm
lwm lub vev xaib tsis tuaj yeem txog API. Siv cURL, xa mus
-H "Content-Type: application/json" thiab nrog rau -d.
API cov chaw tswj keys
Cov chaw tsim nyob hauv lub app. Qhib API hauv qab ntawm lub web app, lossis hauv lub menu rau Android thiab iOS, thiab tap Tsim lub npe tshoov keys. Muab rau nws ib lub npe thiab, yog tias koj xav, ib lub hau thiab ib hnub uas yuav tas sijhawm.
Lub luag haujlwm no yuav tshwm sim rau ib zaug xwb. Muab copy mus rau qhov chaw uas muaj kev nyab xeeb ua ntej koj yuav kaw daim ntawv no: Nymbot tsuas khaws cia ib daim fingerprint ntawm nws xwb, yog li ntawd nws yuav tsis tuaj yeem qhia rau koj tau ntxiv. Yog tias poob lub luag haujlwm no, yuav tsis muaj kev rov qab tau; yuav tsum tshem nws mus thiab tsim ib yam tshiab.
Ib lub pob txiab zoo li sk-nymbot- tshuab ntawm 43 cov ntawv, tus xyoo, cov nraud thiab
cov qauv ntai. Lub app tso qhia txhua lub chuam raws li nws lub npe thiab ib lo lus qhia luv luv xws li
sk-nymbot-Qm7x…c2Lw.
- Ib lub nchuav yog ib tug niam ntawm koj lub npe. Nws siv koj tus nqi nyiaj, thiab tsuas yog koj npe ntxiv (nym) thiaj li tuaj yeem tsim, hloov, lossis tshem tawm nws. Txhua tus uas tuaj yeem tuaj held lub tuav chav (key) yuav siv tau nws, yog li ntawd thov saib nws zoo nkaus li ib tug password.
- Caps nyob rau hauv sats. Ib lub chaw tso cai (key) tuaj yeem muaj qhov tswj hwm qhov nqi siv (spending cap), thiab qhov tswj hwm ntawd tuaj yeem rov qab mus tshiab
tsaug zog txhua hnub, txhua lim tiam (Monday) lossis txhua lub hlis (hnub thib ib), thaum 00:00 UTC. Nws suav nrog ob hom
tus nqi (balances), ib lub credit txoos (standard credit) suav ua 10 sats thiab ib lub Pro credit suav ua 100, yog li nws txhais tau tias yuav zoo ib yam nkaus
kev txawv ntawm qhov nqi siv rau txhua qhov kev thov (request). Ua ntej ib qho kev thov yuav run, qhov nqi siab tshaj plaws uas nws yuav siv tau
(yuav nce mus rau lub credit tag) yuav raug suav nrog qhov uas tshuav ntawm lub tswj hwm (cap). Yog tias nws tsis txaus,
qhov kev thov yuav raug tsis pub zoo nrog
403key_limit_reached, txawm tias yog lub teeb meem yuav tau txais hauv qhov tshuaj tsis tshav; qhov yuam kev qhia tias tseem nqis npaum li cas thiab thaum twg lub tshuaj tshiab yuav pib dua. Kev txo qismax_tokensua rau qhov teeb meem pib pib txog qhov pib qis dua ntawd. Ib qho kev thov yuav raug them nyiaj raws li qhov ntawm txhua yam uas nws siv tiag thiab qhov ntawd yuav raug suav nrog lub hli, yog li ntawd yog tias tus neeg muab cov ntaub ntawv qhia tias muaj ntau cov tokens tshaj qhov uas tau npaj tseg, qhov kev thov kawg uas tseem tshuav chaw tuaj yeem coj lub hauv paus mus dhau qhov tshuaj xyuas me ntsis; qhov tom ntej ntawd yuav raug tsis pub mus. - Ib lub hwjchim uas tau siv tas lawm tsuas yog tsum txoj kev siv xwb. Ib lub chav ntawm nws lub suab tseem tuaj yeem tshawb xyuas tau qhov sib luv, nyeem nws keeb kwm, faib cov qauv, suav cov lus, ntxiv nyiaj thiab tshawb xyuas ib daim video uas nws tau pib tsis ntev.
- Kev kawm hnub kawm hnub yog tsis tsim nyog yuav tsum tau ua. Tom qab lub hnub uas koj teev, lub npe tsis ua hauj lwm lawm.
- Kev tshem tawm yog tam sim ntawd thiab tsis rov muaj dua. Ib lub tshuab (key) uas raug tshem tawm yuav tsis ua tau ntej thov dua. Nws tseem nyob hauv daim ntawv, uas muaj tsav ntsuas qhia tias raug tshem tawm, kom nws cov keeb kwm siv nyiaj tseem muaj nuj nqis.
- Koj tuaj yeem muaj txog 25 lub tswv yim uas tseem siv tau, txhua lub muaj nws lub npe rau nws tus kheej. Kev hloov lub sijhawm rov qab (reset period) ntawm ib lub tswv yim yuav pib tshiab ntawm 0.
Lub nplooj ntawv *@the same sheet* ntawd qhia txhua lub meej mom txoj kev siv nyob rau lub sijhawm no thiab nyob rau lub sijhawm tag nrho, thaum nws raug siv kawg, ob lub hluav taws xob ntawm koj, thiab koj cov API thov uas tsis ntev los no. Cov endpoints tom qab nws yog raug sau tseg nyob rau hauv tsav cov chaw tswj fwm lub tes thib (keys).
Xyuas kom tseeb ib thov nug
Xa lub hauv paus hauv ib qho ntawm cov headers no. Lawv muaj nuj nqis sib lub, yog li ntawd thov siv qhov uas koj tus neeg siv (client) xa tuaj raws li lub tswv yim uas lawv siv:
| Lub npe saum toj | Xa los ntawm |
|---|---|
Authorization: Bearer sk-nymbot-… | OpenAI SDKs, cov cuab yeej tshaj plaws, Claude Code nrog ANTHROPIC_AUTH_TOKEN |
x-api-key: sk-nymbot-… | Cov Anthropic SDKs |
api-key: sk-nymbot-… | Cov Azure-style cov neeg siv |
Ib lub chav uas tsis tau nrhiav tau, tsis paub, raug tshem tawm, lossis tas sijhawm yuav rov qab los 401, nrog tus code
missing_api_key, invalid_api_key, revoked_api_key los yog
expired_api_keyNtxiv cov qauv tshawb fawb, cov qauv suab thiab cov suab, thiab cov txoj hauv kev them nyiaj
tsis tas yuav muaj tus kauj ruam (key).
Duab, video, lus hais, kev sau ntawv thiab embeddings kuj tuaj yeem them nqi rau ib thov (request) ib zaug ntawm Lightning yam tsis siv key li: xa thov ntawd mus tsis muaj key thiab them invoice hauv 402 teb. Saib them nqi raws li txhua zaum kev thov
tsis muaj
key.
Kev tswj hwm cov chaw tseeb, cov ntaub ntawv xov xwm ntawm tus account thiab kev ntxiv nyiaj tsis tu ncua yog cov uas tsis tswj raws li qhov qub: lawv siv ib qho kev tso cai los ntawm koj nym tsis yog siv ib lub key, yog li ntawd ib lub key uas raug tso tawm tsis tuaj yeem tsim tau ntxiv lwm cov key. Saib ua npe thov kev koom tes nrog tus account.
Koj thib thawj thov tau
Muab lub key rau hauv ib lub environment variable, tom qab ntawd nug ib yam dab tsi rau ib lub model. Cov piv txwv hauv
cov nplooj ntawv no nyeem nws los ntawm 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 yog Nymbot txoj kev routing ntawm nws tus kheej, uas yog them los ntawm tus xyeev (standard balance). Hloov mus rau ntawm qhov ntawd siv catalog model id, xws li anthropic/claude-sonnet-5, siv lub model ntawd
los ntawm Pro balance. Ntau cov qauv muab txhua lub id rau.
Ib thov yuav nqi npaum li cas
Lub API them nqi zoo nkaus li lub app ua.
- Lee cas lub hloov pauv.
nymbot/autotsiv tau cov lub qauv tus xyoo (10 sats tswm) . Txhua lwm qhov chat model siv nqi Kev tshaj lijyim tsiaj xim (100 sats yog ib qho credit). Lub tshuab tsim duab ntawm qauj hauv (standard image generator) thiab lub tshuab tsim suab ntawm qauj hauv (standard voice) yuav siv cov credit ntawm qauj hauv; txhua lub tshuab tsim lwm yam yuav siv Pro. Cov Embeddings yuav siv cov credit ntawm qauj hauv. Kev teeb tsa lus (Transcription) yuav siv cov credit ntawm qauj hauv thaum cov credit ntawm qauj hauv muaj txaus, thiab siv Pro credits yog tias tsis txaus. Daim ntawv qhia cov models yuav qhia tias txhua lub model yuav siv cov credit twg. - Nqi npaum li cas. Kev thov kev sib tham yog raug ntsuas raws li cov tokens uas lub model tau nyeem thiab sau tiag, raws li tus nqi uas tus neeg muab kev pab tau tso tawm. Tus nqi ntawd muaj ntxiv 5% fee thiab raug ntxiv 1.5, yog li koj yuav them 1.575 npaum li tus nqi uas tus neeg muab kev pab tau tso tawm. Nws raug hloov mus rau sats raws li tus Bitcoin nqi tam sim ntawd thiab raug them hauv qib ib txhiab feem ntawm ib qho credit. Cov duab pro, video thiab lus raug nqi raws li txhua qhov tsim tawm, txhua feeb, lossis txhua tus ntawv (character), thiab kev txhais lus raws li txhua feeb ntawm suab, nrog rau cov nqi them thiab margin uas ib yam nkaus. Cov duab standard yog 5 standard credits thiab lub suab standard yog 3.
- Qhov qis tshaj. Txhua qhov kev thov (metered request) uas khiav yuav nqi ntxiv ib txhia 0.05 credit: ib nrab ntawm ib sat rau cov standard balance, thiab 5 sats rau Pro. Cov feem ntawm credit yuav raug muab tshuav tseg rau ntxiv, tsis yog raug ntxiv nce txhua zaus.
- Tuav, ces nws tso siab. Ua ntej ib qho thov (request) yuav pib ua hauj lwm, qhov nqi siab tshaj plaws uas nws yuav nqi yuav raug tseg ntawm koj tus xyeev (balance), raws li qhov koj tau xa thiab qhov ntau tshaj plaws ntawm cov tokens uas nws yuav sau. Cov ntawv uas tsis yog plain ASCII yuav raug ntsuas raws li nws cov UTF-8 bytes, thiab cov ASCII digits thiab cov cim (punctuation) yuav suav ua ib lub token txhua yam, yog li ntawv hauv txhua hom script, code thiab cov lej yuav raug tseg tag nrho. Qhov kev tseg yog siv cov credit tag nrho, ntxiv rau ib lub, yog li txhua qhov thov yuav tsum muaj nqis tsawg tshaj 10 sats dawb ntawm standard balance lossis 100 sats ntawm Pro thiaj pib tau. Tsuas yog qhov nqi tiag tiag xwb thiaj raug them; qhov uas tseg tshuav yuav raug tso mus thaum nws tiav. Ib qho thov uas ntev yuav tswj nws qhov kev tseg tsis tu ncua thaum nws tseem tab tom ua hauj lwm; yog tias cov credit uas tseg tsis muaj nyob lawm, ib qho kev xa (stream) yuav tsum tsum rau ib qho
402insufficient_balanceyuav tsum tau txais qhov xwm txheej yuam, thiab qhov uas tau tsim tawm los yog raug them nyiaj. Yog tias nqi tiag tiag nhiu dua qhov nyiaj uas muaj hauv tus nqi tshuav, txhua lub nqi tshuav yuav raug muab mus, thiab qhov tshuav yuav tsum tau them (owed_satshau hauvnymbot(yog ib lub ntsiab lus, thiab ib lub nqi tsis tau txiaj ntsig). Qhov uas yuav tsum them yog qhov uas yuav tau them ua ntej los ntawm cov nqi tshiab uas tuaj rau lub nqi ntawd. Txog thaum nws raug them, tsis muaj dab tsi hauv lub nqi ntawd uas yuav tau siv tau: tsis yog los ntawm API, cov lus teb hauv app, kev xa pauv, lossis ib yam dab tsi uas muab plig. - Tsis txaus nyiaj. Yog tias tus nqi tshuav tsis txaus them tus nqi uas tseg cia, thov nug yuav raug
tsiv tshem nrog
402ua ntej txhua yam yuav pib mus. Qhov xwm txheej qhia tias yog peb lub hnab nyiaj twg tsis txaus, yuav tsum tau xaus sad sats npaum li cas thiab muaj nyiaj dawb npaum li cas. Ib yam me zogmax_tokenstxhais tau tias yog muaj kev tuav me zog dua. - Kev tsis vam meej. Ib qho kev thov uas tsis tiav tsis muaj nqi, tsis yog tus neeg muab kev pab ntawd them nqi rau cov hauj lwm uas nws tau ua ua ntej nws tsis tiav, los yog kev nrhiav hauv internet los yog
nymbot/autoTxoj haujlwm tshawb xyuas tau khiav lawm; ces ntawd yog yam koj yuav tsum them, ntau tshaj 0.05 credit. Ib qho kev xa ntawv (stream) uas koj tshem tseg yuav raug them raws li cov tokens uas tus neeg muab (provider) qhia: Nymbot yuav tswj kev nyeem cov ntawv ntawm tus neeg muab mus txog 25 feeb tom qab koj tawm mus thiaj li tau cov lej ntawd. Yog tias nws tsis tau txog, qhov them yuav raug tshuaj xyuas los ntawm qhov koj tau xa thiab qhov uas tau sau tseg, thiab rau ib hom model uas ua kev xav (reasoning), nws yuav suav nrog tag nrho cov output uas raug tseg. Ib qho kev thov (request) uas kev txuas (connection) poob nws tseem yuav tiav thiab yuav raug them nqi. - Nrhiav hauv web pheej nqe lus $0.008 rau txhua kev nrhiav, hloov ua sats, thaum txhua qhov kev nrhiav tsim tawm, txawm tias lub model teb tau lossis tsis tau. Cov nplooj ntawv uas nws nyeem kuj raug xa mus rau lub model ua input thiab, yog li ntawd lawv yuav ntxiv lawv cov tokens.
Txhua qhov teb qhia tias nws nqi npaum li cas. JSON cov teb muaj ib nymbot lub ntsiab lus uas muaj
tus nqi uas tau them los, tus nqi uas yog credits thiab sats, thiab qhov uas tshuajเหลือ:
Lub hom phiaj nqi
"nymbot": {
"balance": "pro",
"charged_credits": 0.162,
"charged_sats": 16.2,
"balance_credits": 412.425,
"balance_sats": 41242.5
}
Cov teb uas tau them nqi los kuj muaj cov npe xam (headers) no thiab, uas yog qhov chaw yuav tsum saib seb nqi ntawm ib qho teb uas tsis yog JSON, xws li kev hais lus:
| Lub npe saum toj | Lub ntsiab lus |
|---|---|
X-Nymbot-Cost-Sats | Cov thov no yuav nqi npaum li cas, nyob rau hauv sats. |
X-Nymbot-Balance-Sats | Dab tsi tshuav hauv tus nqi uas yog tshuav ntawm qhov uas tau them los, nyob rau hauv sats. |
X-Request-Id | Ib tus id rau qhov thov, rau txhua lub teb. Haiv nws yog tias koj hu rau cov neeg pab. |
Nqi ntawm txhua feem uas muaj txhiab tus tokens, uas muaj nqi tswv yim thiab nqi ntxiv rau lawm, yog nyob rau hauv
cov npe qauv hauv cov nqi dollar thiab sats, thiab ntawm
lub nqi nqe ntawvYog tias Bitcoin tus nqi tsis tau nyeem tau,
cov kev thov uas tau them lawm yuav rov qab tuaj 503 price_unavailable nrog
Retry-After: 60 tsis yog kev xav tsis meej
Cov qhov yuam kev
Txhua qhov yuam (error) muaj ib yam duab zoo, yog qhov uas cov OpenAI neeg siv twb nkag siab lawm. code yog
ib lub npe uas ruaj khov uas koj tuaj yeem nrhiav tau; message yog rau tib neeg thiab tej zaum yuav hloov pauv.
Lub cev ntawm kev yuam kev
{
"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
}
}
| Qhov xwm txheej | Thaum twg |
|---|---|
400 invalid_request_error | Lub cev tsis yog JSON uas tsim nyog (invalid_json), tsis muaj ib lub qhov uas yuav tsum tau sau (missing_required_parameter), ib nqe lus tsis yog, lossis qhov kev thov thov ua dab tsi uas qauv lossis endpoint tsis ua, xws li cov cuab tam rau ntawm nymbot/auto (unsupported_tool). param hais lub npe ntawm lub chaw. Ntxiv rau qab upstream_rejected thaum tus neeg muab kev pab tsis pom zoo rau qhov kev thov. |
401 authentication_error | Lub tes tsis pom, tsis paub, raug tshem tawm lossis lawm, lossis ib qho thov tau muaj npe tsis zoo lossis siv dua. |
402 insufficient_quota | Lub nqi tshuav tsis txaus rau qhov kev thov. Code insufficient_balance, nrog balance, required_sats thiab balance_sats. |
403 permission_error | Qhov kev thov tsis haum rau lub luam ntawm lub pob zeb (key_limit_reached, nrog limit_sats, used_sats thiab reset_at), los yog lub account yuav tsis tau siv lub kev pabcuam (account_denied). |
404 not_found_error | Ib txoj kev tsis paub (unknown_endpoint), ib lub model uas tsis muaj (model_not_found), los yog ib lub pob tseeb uas tsis tau paub, nqi them nqi lossis video. |
405 | Txoj kev ntawd muaj tab sis tsis yog nrog txoj hauv kev ntawd (method_not_allowed). Tus Allow Lub header qhia cov txoj kev uas nws siv. |
413 | Lub cev los yog lub ntawv loj dhau (payload_too_large, file_too_large), los yog ib qho suab luag dhau ntev (audio_too_long). Saib cov kev txwv. |
415 invalid_request_error | Lub cev tsis raug xa ua application/json (los yog, rau cov upload endpoints, multipart/form-data): unsupported_media_type. |
422 | Ib lub suab thiab ib hom lus uas tsis haum ua ke hauv text to speech (voice_language_mismatch, unsupported_language). |
429 rate_limit_error | Muaj kev thov ntau dhau mus rau lub key no, los ntawm lub chaw ceev xwb, los yog nrog cov credentials uas tsis ua raws li kev tshawb fawb (rate_limit_exceeded), los yog tus neeg muab kev pab tab tom txwv tus nqi kev siv (upstream_rate_limited). Tos rau cov sawv daws nyob rau hauv Retry-After. |
500 api_error | Muaj teeb meem tshwm sim ntawm Nymbot's sab (internal_error). |
502 api_error | Tus neeg muab kev pab tsis tau rov xa ib lo teb (upstream_error), loss yog tsis ua tau Lightning invoice (invoice_unavailable). |
503 api_error | Lub neeg muab kev pab zoo nkauj dhau txiaj ntsig (upstream_overloaded), nqi Bitcoin tsis nyeem tau (price_unavailable), loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss loss lossservice_unavailable, media_hosting_unavailable). Retry-After hais tias thaum twg yuav sim dua, qhov uas tau paub tias yog. |
Ob qhov tsis taug cai:
/api/v1/messagescov teb hauv Anthropic's error format, vim tias ntawd yog qhov Anthropic cov neeg siv thiaj li tshuaj xyuas tau:{"type": "error", "error": {"type": "authentication_error", "message": "…"}}. Hom ntawd raug raws li qhov xwm txheej:invalid_request_error,authentication_error,billing_error(402),permission_error,not_found_error,request_too_large,rate_limit_error,api_errorlos yogoverloaded_error(503).- Ib qhov kev thov streaming uas tsis ua tiav ua ntej nws thim tau thawj byte, nws yuav tau txais ib qho JSON error zoo li qub nrog status saum toj no, tsis yog ib qho event stream. Ib qho kev tsis ua tiav tom qab cov stream tau pib lawm yuav raug xa mus ua cov event kawg ntawm cov stream ntawd, raws li nws qhov endpoint li qub.
Cov lus qhia qhov tsis ua tau zoo tsis tau muaj lwm qhov kev pab cuam lwm qhov cov ntaub ntawv ntawm lawv lub siab. Ib tug neeg muab kev pab cuam uas muaj teeb meem yuav raug hloov cov lus ua ntej nws yuav mus rau koj.
Cov Kev Txwv
| Txwv | Nqi |
|---|---|
| Kev thov rau txhua lub key | 120 ib tsav txhia feem. Ntawm qhov ntawd, 429 nrog Retry-After. |
| Cov kev thov tsis muaj ib daim pov thawj | 120 ib nqe lus ib feeb ntawm txhua chaw, rau qhov model, cov ntsiab lus ntawm audio thiab payment method, kev tshawb xyuas refund token, thiab cov paid endpoints uas hu yam tsis muaj key lossis payment. Thaum dhau qhov ntawd, 429 nrog Retry-After. |
| Tsis tau txais kev tso cai | 30 ntawm ib been txhua lub chaw rau cov chaw tswj fwm, kev koom tes, kev them nqi thiab cov refund tokens uas tsis raug kev tshawb fawb. Lawm li ntawd, txhua qhov kev thov los ntawm lub chaw uas muaj cov chaw tswj fwm yuav tau txais 429 nrog Retry-After txog thaum feem ntawd tag. Cov ntaub ntawv tseem ceeb raug tshawb xyuas ua ntej lub cev raug nyeem. |
| Tshiab cov nplooj ntawv | 60 ib lub teev ib teev rau txhua nym thiab 120 ib lub teev ib teev rau txhua chaw nyob. |
| Cov nqi them ntxiv rau nqi nrog rau cov ntawv them nqi | 60 ib lub teev ib teev rau txhua nym thiab 120 ib lub teev ib teev rau txhua chaw nyob. |
| NWC wallet kev txuas lus | 10 ib teev ib txhia ntawm nym thiab 30 ib teev ib chaw. Lub wallet relay yuav tsum siv wss:// ntawm lub chaw nrog (port) ntawm qhov tsim nyog. |
| Tshuab txim cov token | 60 kev thov ib feeb ntawm txhua token. |
| Chaw nyob | Ib qho IPv6 address raug suav ua nws tag nrho /64 hauv txhua qhov per-address limit, thiab ib qho IPv4-mapped IPv6 address raug suav ua nws IPv4 address. |
| JSON thov nqis tshiab | 4 MB; 64 KB rau cov thov uas muaj koj cov npe. |
| Yog keeb kwm ntawm cov ntaub ntawv (uploads) | 32 MB. Ib daim duab uas yuav kho tau txog 20 MB, ib daim suab txog 25 MB. Muaj ntau tshaj plaws 64 feem, txhua feem muaj ntau tshaj plaws 8 KB ntawm cov feem xyuas (part headers), thiab ib lub rhuav (boundary) ntawm 1 txog 70 cov ntawv; yog tsis yog 400 invalid_multipart. |
| Duab hauv ib thov chat | 20. Txhua txhua yam yog ib lub https:// los yog http:// txuas rau ib qho public host, lossis ib data:image/… URL. |
| Cov duab rau txhua zaum thov tsim | 1 mus rau 4 (n) |
| Cov tokens tawm | Txiav txim siab ntawm qhov siab tshaj plaws ntawm tus qauv tus kheej. Ib qho loj dua max_tokens raug ua rau qis mus rau nws, tsis yog tsis lees txais. |
| Kev nqis suab lus | 800 tus cov ntawv rau lub suab tsis tshua, 2,000 rau Aura 2. |
| Kev Sau Ntawv | 30 feeb nplooj suab, 25 MB. Kev thaum ntxiv ntev raug tsis tso cai nrog 413 thiab tsis raug them nyiaj, txawm tias nws tus ntev yuav raug paub thaum Whisper mloog nws tag lawm xwb. |
| Embeddings | 100 cov cov tso cai rau txhua thov. |
| Hav luag hauj lwm ntawm video | Yuav khaws cia rau 24 teev tom qab lawv raug xa mus; ib daim render yuav raug tso tseg tom qab ib teev. Nyob rau hauv ib niam (nym), muaj tsuas yog 10 daim rendering ib zaug xwb. |
| Kev nco ntawm cov lus nug | Khaws cia rau 90 hnub. |
| Cov niam tswj tuaj ntawm niam tswj txhua tus | 25. Tsuas yog cov chav tes rov qab tshiab tshaj plaws 50 lub yog uas raug khaws cia. |
Ib txoj kev txuas mus rau ib daim duab yuav tsum mus rau ib qho chaw pub rau pej xeem siv: yog ib lub chaw nyob hauv ib lub network ntawm tus kheej lossis qhov chaw hauv Nymbot tus kheej, yuav raug tsis pub siv. Kev tswj hloov tswj kev thov (pacing) uas siv hauv app kuj yuav siv rau ntawm no thiab, yog li ntawd, kev thov ntau dhau mus rau ib tus neeg muab kev pab (provider) tuaj yeem raug ua rau chậm mus rau qhov tsis tau ua tiav.
API ntawd tuaj yeem pom dab tsi
API tsis yog qhov uas tsis pub ntawm sab nraud zoo li cov app, thiab nws tsim nyog yuav tsum piav kom meej txog qhov zoo li cas.
- Nws tsis yog kev kaw ntawv los ntawm ib tog mus rau ib tog. Nyob hauv cov app, ib zaj xov xwm raug muab kaw rau ntawm koj lub khoom siv uas tsuas yog Nymbot thiaj li muaj cov chaw qhib thiab mus ua ib qho tshoob tshawb tshoob. Ib thaj API thov tsis yog yam tshwj xeeb: nws yog encrypted thaum mus rau Nymbot, thiab Nymbot's server nyeem nws meej rau kev ua hauj lwm.
- Cov lus nug thiab cov lus teb tsis raug khaws cia. Lawv dhau mus rau hauv qauv (model) thiab cov lus teb dhau rov qab los. Qhov uas raug khaws cia yog nqi: rau txhua qhov kev thov (request) lub sij hawm, qauv (model), hom, token counts, nqi, hmoo (balance), tus qhia (key) thiab seb nws tau ua tiav, rau 90 hnub, uas yog qhov keeb kwm nug qhia rau koj. Ib daim ntawv sau teeb meem ntawm tsis yog qhov thov (lub sijhawm, hom, model, token counts, nqi, lub sijhawm siv thiab seb nws puas siv web search los yog tiav) kuj raug khaws cia rau 90 hnub, nrog rau daim ntawv ntawm tus app nws tus kheej.
- Txhua yam uas tshuav rau ib npe yog me me thiab raug teev ntawm no. API cov chaw tswj keys raug khaws cia ua ib hom hash, tsis yog lub chav (key) li, nrog rau lawv lub npe, ib lo lus qhia luv luv, qhov tshuaj txiav txiaj (spending cap), lub sij hawm tshiab (reset period), lub sij hawm tag, thiab thaum lawv raug tsim thiab thaum kawg siv; tsuas yog 50 lub chav uas tsis zoo siv (revoked keys) uas tshiab tshaj plaws raug khaws cia. An ntxiv nyiaj tswm Kev txuas ntawm lub hnab nyiaj raug khaws cia ua hom code (encrypted), nrog rau nws lub qib tswj, npaum npaum, thiab qhov tshwm sim ntawm qhov pib tshiab kawg. Cov hauj lwm video raug khaws cia rau 24 teev. Cov kev thov uas them raws li txhua hu tshuav tsuas tso qhov Lightning payment hash rau 7 hnub thiab ib lub hashed refund token rau 30 hnub, uas tsis txuas nrog lub npe (nym) li. Cov nqi uas lub hnab nyiaj tsis muaj nyiaj them yuav raug khaws cia ua nuj nqi mus txog thaum muaj kev ntxiv nyiaj tshiab los them.
- Kev so kom huv ntawm lub app yuav tshem nws mus. A nuam lub tshuab tshaj tawm thiab muab tshem tawm txhua API key, thiab tshaj tawm thiab tshem tawm cov lus nug keeb kwm, cov ntaub ntawv siv, wallet connection thiab video jobs. Lub nqi thiab txhua yam nqi uas tseem tshuav nyob tsis hloov pauv ntawm nym.
- Lee tus tus neeg muab qauv pom koj qhov kev thov, raws li nws ua los ntawm
- Media uas tsim tawm los yog rau pej xeem. Cov duab thiab video uas xa tuaj los ntawm cov link yog
tus ntxhiab rau Blossom public file hosts, uas qhov chaw ntawm lwm qhov yog nws tus hash. Txhua tus uas muaj
tus link tuaj yeem qhib nws, thiab Nymbot tsis tuaj yeem tshem tawm nws tau ntxiv. Nrhiav
b64_jsonthiab ib daim duab tsim los ntawm computer yuav rov qab los hauv cov lus teb thiab tsis raug ntim mus li. - Yog li cov duab uas koj pub yog ib lub tshuab tsim duab (generator) lov? Ib daim duab uas koj tso rau
Kho, loss yog xa ua ib
data:URL hauv ib tus tsimersimage_url, yog raug ua rau rau ib lub Blossom host pej xeem ua ntej thiaj li tus generator yuav tuaj nqa tau nws, thiab qhov zoo nkaus li ntawd rau nws. Ib daim duab uas xa los ntawmhttps://txoj link raug xa mus li ntawd txoj link ntawd. Cov duab hauv ib qho kev thov kev sib tham yuav mus rau tus neeg muab model, tsis mus rau Blossom. - Ib lub nplta raug txuas rau koj tus nym. Txhua yam uas ib lub key siv los yog yuav tsum muaj nyiaj ntawm koj nym balance, yog li ntawd kev siv API tsis yog tsis paub npeYog tias koj xav siv API uas tsis txhob sib ntxuas nrog koj lub npe (nym) uas koj siv txhua hnub, tsim cov chaw tswj (keys) los ntawm ib lub npe (nym) txawv uas muaj nws tus yog (balance) tus kheej.
Yog koj xav tau kev tiv thaiv ntawm cov apps, siv cov apps ntawd. API yog rau thaum koj xav tau cov models hauv koj cov tools xwb.
Txhua lub chaw kawg
| Lub chaw kawm | Nws ua li cas | Kev tso cai |
|---|---|---|
GET /api/v1/models | Tsab cov qauv, nrog cov nqi | Tsis muaj dab tsi |
POST /api/v1/chat/completions | Kev Teb Lus hauv Kev Sib Txuas Lus | Lub Chaw Tseg |
POST /api/v1/responses | API Kev Teb | Lub Chaw Tseg |
POST /api/v1/messages | Anthropic Cov Teeb Txheej | Lub Chaw Tseg |
POST /api/v1/messages/count_tokens | Nqi tshuaj xyuas cov input tokens | Lub Chaw Tseg |
POST /api/v1/images/generations | Tsim cov duab | Chaw tshiab lossis Hluav taws xob |
POST /api/v1/images/edits | Kho cov duab | Chaw tshiab lossis Hluav taws xob |
POST /api/v1/videos, GET /api/v1/videos, GET /api/v1/videos/{id} | Tsim, tshuaj xyuas thiab xyuas cov yeeb yaj kiab | Chaw, los yog Hluav taws xob pib ib yam |
POST /api/v1/audio/speech | Kev hais lus los ntawm ntawv | Chaw tshiab lossis Hluav taws xob |
GET /api/v1/audio/models, GET /api/v1/audio/voices | Cov qauv suab thiab cov suab lus | Tsis muaj dab tsi |
POST /api/v1/audio/transcriptions, POST /api/v1/audio/translations | Kwv faj lus mus rau ntawv, thiab mus rau lus Askiv | Chaw tshiab lossis Hluav taws xob |
POST /api/v1/embeddings | Embeddings | Chaw tshiab lossis Hluav taws xob |
GET /api/v1/credits/balance (los yog POST) | Ob lub nqi tshuaj ntsim | Lub Chaw Tseg |
GET /api/v1/topup/payment-methods | Cov txoj hauv kev them nqi | Tsis muaj dab tsi |
POST /api/v1/topup/create/btc-lightning | Ib daim Lightning invoice | Lub Chaw Tseg |
GET /api/v1/topup/status/{invoice_id} | Saib thiab tso nyiaj rau nws | Lub Chaw Tseg |
GET /api/v1/queries/history | Txhua qhov kev thov nqi yog dab tsi | Key loss yog nym |
GET /api/v1/account | Nqe lus xov xwm ntawm tus nqi kwv yhm | Nym |
/api/v1/keys | Tsim, hloov, thiab tshem tawm cov chaw tseem ceeb (keys) | Nym |
/api/v1/nwc-auto-topup | Ntxiv nyiaj tsis tas kev ua manual | Nym |
GET /api/v1/l402/refunds, POST /api/v1/l402/refunds/redeem | Saib lossis hloov pauv ib lub npe tshuav nyiaj (refund token) | Tus nqi them rov qab; nym txhawm rau yog/los yog nrog |
"Nym" txhais tau tias yog ib qhov thov uas muaj koj Nostr key kos npe, uas raug piav qhia hauv ua npe thov kev koom tes nrog tus account. Rau cov cuab yeej uas twb nkag siab cov nuj nqis no, saib cov cuab yeej thiab SDKs, thiab rau cov coding agents xws li Claude Code, Codex thiab Cline, saib cov cuab yeej tsim code.