Пойгоҳи дониш Таҳиягарон
Шарҳи API
Моделҳо, генераторҳо ва тавозуне, ки шумо дар барнома истифода мебаред, аз коди худи шумо мебошанд. API форматҳои OpenAI ва Anthropic-ро мефаҳмад, бинобар ин аксари асбобҳо ва SDK-ҳо тавассути тағйир додани URL-и асосӣ ва калид кор мекунанд.
Ин саҳифа барои роҳат бо мошин тарҷума шудааст. Нусхаи аслии англисӣ версияи татбиқшаванда аст.
API чист
API-и HTTP дар nymbot.ai он ки ҳамон дархостҳоеро иҷро мекунад, ки мизони OpenAI ё Anthropic аллакай мефиристад. Шумо мегиред:
- Таммими чат, он API Ҷавобҳо ва Паёмакҳои Anthropic, бо стриминг, асбобҳо, аксҳо, мулоҳиза ва ҷустуҷӯи веб, барои ҳар як модел дар каталог ва барои автомаршрутизагории худи Nymbot.
- Тасвирҳо, видео, Нутқ, транскрипсия ва векторҳои ҷойгиршавӣ.
- шумо тавозун, Тарҳҳои тезпур much, пур кардани автоматикии маблағ аз ҳамён ва як таърих арзаши ҳар як дархост чанд аст.
Ин аз ҳамон ду таъсид пардохт мешавад балансҳо мисли замима, бо ҳамон нархҳо. Яке аз инҳо, обуна ва квотаи ройгон дар API вуҷуд надорад: ҳар як дархост аз ҳисоби кредитҳои харидаатон пардохт карда мешавад.
Дар он чизе, ки API иҷро намекунад, илова кардани ягон чизи худи Nymbot надорад. Паёмҳои шумо ба модел ҳамон тавр мераванд, ки шумо онҳоро фиристодаед: на супориши системавии Nymbot, на хотира, на ишораҳои таърих ё забон. Он чизе, ки баргашта меояд, ҷавоби модел ва қайди нархномаи он аст.
URL-ҳои асосӣ
| Истифода кардан | Суроғаи асосӣ |
|---|---|
| SDK-ҳои OpenAI ва абзорҳои мувофиқ бо OpenAI | https://nymbot.ai/api/v1 |
| SDK-ҳои Anthropic ва Claude Code | https://nymbot.ai/api (SDK илова мекунад /v1/messages худаш) |
Ҳар як нуқтаи парванда дар зери ... ҷойгир аст /api/v1/. Як роҳи номаълум бармегардад 404 ва як
су пути маълум, ки бо усули нодуруст даъват мешавад, баргардонда мешавад 405, ҳарду ҳамчун JSON.
API дархостҳои байни-сайтҳоро (cross-origin) аз ҳар як сайт қабул мекунад, бинобар ин саҳифаи браузер метавонад онро дахл кунад. Аммо ҳар чизе, ки шумо ба браузер мефиристед, метавонад аз ҷониби ҳар кӣ онро кушояд, хонда шавад, бинобар ин танҳо бо калиде ин корро анҷом диҳед, ки дорои як хурд... капНуқтаҳои ниҳоят, ки бо nym-и шумо имзо шудаанд (калидҳо, хулосаи ҳисоб, пур кардани автоматикии NWC ва ивазкунии маблағҳои баргашт) истисно ҳастанд: дар браузер онҳо танҳо ба сайтҳои худи Nymbot ҷавоб медиҳанд. Бинед имзо кардани дархостҳои ҳисоб.
Ҳар як ҷисми JSON-ро бо фиристед Content-Type: application/jsonҲар гуна навъи дигар
бо мардӯд шудааст 415, пас як шакли оддии HTML ё а... text/plain дархост аз
як сайти дигар наметавонад ба API ворид шавад. Бо cURL, гузаронед
-H "Content-Type: application/json" дар канори -d.
Калидҳои API
Калидҳо дар замима сохта мешаванд. Кушодан API дар панели паҳлӯи барномаи веб, ё дар меню дар Android ва iOS, ва пахш кунед Калидро созедБа он ном гузоред ва агар хоҳед, маҳдудият ва санаи анҷом диҳед.
Калид танҳо як бор нишон дода мешавад. Пеш аз он ки саҳифаро пӯшед, онро дар ҷои бехатар нусхабардорӣ кунед: Nymbot танҳо ангушти моро (fingerprint) нигоҳ медорад, бинобар ин он наметавонад онро ба шумо боз нишон диҳад. Калиди гумшударо барқарор кардан имконнопазир аст; онро бекор кунед ва калиди дигар созед.
Калид чунин менамояд sk-nymbot- пайдучаи 43 ҳарф, рақам, тире ва
аломатҳои зеркаш. Замима ҳар як тугмаро бо номаш ва ишораи кӯтоҳ, ба монанди, рӯйхат мекунад
sk-nymbot-Qm7x…c2Lw.
- Калид ба nym-и шумо тааллуқ дорад. Он маблағи шуморо сарф мекунад ва танҳо nym метавонад онро созад, тағйир диҳад ё бекор кунад. Ҳар касе, ки калидро дорад, метавонад бо ёрии он сарф кунад, бинобар ин бо он мисли раъй (password) муносибат кунед.
- Капсулаҳо дар сатҳо ҳастанд. Калид метавонад сарфи маҳдуд дошта бошад ва ин маҳдудият метавонад
ҳар рӯз, ҳар ҳафта (душанбе) ё ҳар моҳ (рӯзи аввал) дар соати 00:00 UTC аз нав эътибор пайдо кунад. Он ҳарду
балансро ҳисоб мекунад: кредити стандартиро ҳамчун 10 сат ва кредити Pro-ро ҳамчун 100, бинобар ин ин маънои як thing-ро дорад,
ки дар кадом баланс дархост иҷро шавад. Пеш аз иҷрои дархост, нархи максималии эҳтимолӣ
(ба кредитҳои пурра ба боло раундшуда) нисбат ба боқимондаи маҳдудият муайян карда мешавад. Агар он мувофиқ наояд,
дархост бо зери ин рад карда мешавад:
403key_limit_reached, ҳатто агар ҷавоб бояд аз сатҳи маҳдудӣ камтар меомад; хатогӣ мегӯяд, ки чанд қисм боқӣ мондааст ва сатҳи маҳдудӣ кай вазъиятро бармегардонад. Коҳиш доданиmax_tokensин ҳолати бадтаринро кам мекунад. Барои дархост ҳамон қадар маблағ пардохт карда мешавад, ки он воқеан арзиш дорад ва ин ба меъёр ҳисоб мешавад, бинобар ин, агар провайдер токенҳои бештар аз он чизе, ки ҷудо шуда буд, гузориш диҳад, охирин дархосте, ки мувофиқ буд, метавонад калидро каме аз меъёр гузаронад; дархости навбатӣ пас аз он рад карда мешавад. - Шарб охир мешавад, танҳо сарф карданро медонад. Калид дар сарчашма метавонад боз тавонад балансро санҷад, таърихро бихонад, моделҳоро рӯйхат кунад, токенҳоро ҳисоб кунад, маблағ кунад ва видеоеро, ки аллакай оғоз кардааст, назорат кунад.
- Мӯҳлати анҷом ихтиёрӣ аст. Пас аз санае, ки шумо муайян кардед, калид кор намекунад.
- Лағв кардан фавранӣ ва ниҳоӣ аст. Калиди ботил дар дархости навбатӣ нобарор мешавад. Он дар рӯйхат бо қайди ботил мемонад, то таърихи сарфкориаш то ҳол мантиқӣ бошад.
- Шумо метавонед то 25 калиди фаъол дошта бошед, ки ҳар кадоми онҳо номи худро доранд. Тағйир додани давраи такрори калид давраи навро аз сифр оғоз мекунад.
Ҳамон ҷадвал сарфоти ҳар як калидро дар ин давра ва дар маҷмӯъ, вақти охирин истифодааш, амволи ҳардуи шумо ва дархостҳои охирини API-ро нишон медиҳад. Нуқтаҳои иснодӣ (endpoints) дар паси он дар зер ҳуҷҷатгузорӣ шудаанд: идора кардани калидҳо.
Тасдиқи дархост
Калидро дар яке аз ин сарлавҳаҳо фиристед. Онҳо муодил мебошанд, бинобар ин кадомеро, ки мизоби шумо ба таври пешфарз мефиристад, истифода баред:
| Сарлавҳа | Фиристода шудааст аз |
|---|---|
Authorization: Bearer sk-nymbot-… | SDK-ҳои OpenAI, аксари асбобҳо, Claude Code бо ANTHROPIC_AUTH_TOKEN |
x-api-key: sk-nymbot-… | SDK-ҳои Anthropic |
api-key: sk-nymbot-… | Клиентҳои услуби Azure |
Калиди гумшуда, номаълум, ботилшуда ё эътибор надошта баргардонида мешавад 401, бо код
missing_api_key, invalid_api_key, revoked_api_key ё
expired_api_keyРӯйхати моделҳо, моделҳои аудио ва садоҳо, ва усулҳои пардохт
калид намехоҳад.
Суратҳо, видео, нутқ, транскриптсия ва эмбеддингҳоро инчунин метавон барои як дархост дар як вақт тавассути Lightning бидуни ягон калид пардохт кард: дархостро бидуни калид фиристед ва ҳисобномаро дар 402 ҷавоб. Бинед пардохт барои ҳар як дархост бидуни
калид.
Идоракунии калидҳо, хулосаи ҳисоб ва пур кардани маблағ ба таври худкор истисно ҳастанд: онҳо ба ҷои калид имзоро аз nym-и шумо мегиранд, бинобар ин калиди фошшуда наметавонад калидҳои бештар созад. Нигоҳ кунед имзо кардани дархостҳои ҳисоб.
Дархости аввалини шумо
Саромиро ба тағйирёбандаи муҳит (environment variable) гузоред, баъд аз модел чизе пурсед. Мисолҳо дар давоми
ин саҳифаҳо онро аз чӣ мехонанд 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 маршрутсозии худи Nymbot мебошад, ки аз тавозуни стандарт пардохт карда мешавад. Ба ҷои он ID-и модели каталогро гузоред, масалан: anthropic/claude-sonnet-5, барои истифодаи он модел
аз тавозуни Pro. Рӯйхати моделҳо ҳамаи ID-ро медиҳад.
Арзиши як дархост чӣ қадар аст
Пардохти API маҳз ҳамон тавр аст, ки замима.
- Кадом тарозу.
nymbot/autoсарф мекунад стандартӣ баланс (10 sats ба кредит). Ҳар як модели дигари чат вақтро сарф мекунад Профессионал баланс (100 sats ба кредити шумо). Генератори стандарти тасвир ва овози стандарти кредитҳои стандартӣ сарф мекунанд; ҳамаи генераторҳои дигар кредитҳои Pro-ро сарф мекунанд. Embeddings кредитҳои стандартӣ сарф мекунанд. Transcription вақте ки баланси стандартӣ метавонад онро пӯшонад, кредитҳои стандартӣ ва дар ғайри ин ҳолат кредитҳои Pro-ро сарф мекунад. Рӯйхати моделҳо мегӯяд, ки ҳар як модел кадом балансро сарф мекунад. - Чанд пул. Дархости чат мувофиқи миқдори токенҳое, ки модел воқеан хондааст ва навиштааст, бо нархҳои нашркардаи провайдер ҳисоб карда мешавад. Ба ин нарх 5% пардохти иловагӣ илова карда шуда, сипас дар 1.5 зарб зада мешавад, бинобар ин шумо 1.575 маротиба зиёдтар аз нархи рӯйхати провайдер пардохт мекунед. Он ба нархи намунавии Bitcoin дар сатҳи воқеӣ ба sats табдил дода шуда, бо ҳазордиҳамҳои як кредит пардохт мегардад. Расмҳои касбӣ, видео ва нутқ барои ҳар як генерация, ҳар як сония ё ҳар як аломат нархгузорӣ мешаванд, ва транскрипсия барои ҳар як сонияи аудио бо ҳамон пардохт ва маржа ҳисоб карда мешавад. Расми стандартӣ 5 кредити стандартии сахт ва овози стандартӣ 3 кредити сахт аст.
- Ҳамаgera аз ҳама камтар. Ҳар як дархости ҳисобшуда, ки иҷро мешавад, ҳадди ақал 0.05 кредит арзиш дорад: ним сато дар тавозуни стандартӣ, 5 сато дар Pro. Қисмҳои кредит ба навбат гузаронида мешаванд, на дар ҳар бор ба боло раунд карда мешаванд.
- Тармуш кун, сипас ҷой ба ҷой кун. Пеш аз иҷрои дархост, маблағи мумкинни пешгиранда аз боланси шумо, дар асоси он чизе ки шумо фиристодаед ва максимал миқдори токенҳое, ки он метавонад нависад, нигоҳ дошта мешавад. Матни берун аз ASCII оддӣ аз байтҳои UTF-8 ҳисоб карда мешавад, ва рақамҳо ва аломатҳои ASCII ҳар кадоме ҳамчун як токен ҳисобида мешаванд, бинобар ин матн дар ҳар намуди навишт, код ва рақамҳо пурра нигоҳ дошта мешаванд. Маблағи нигоҳдошташуда дар кредитҳои пурра, ҳадди ақал яке, мебошад, бинобар ин ҳар дархост барои оғоз ҳадди ақал 10 sat дар боланси стандартии холӣ ё 100 sat дар Pro лозим аст. Танҳо арзиши воқеӣ пардохт карда мешавад; боқимонда пас аз анҷом ёфтани он озод карда мешавад. Дархости тӯлонӣ маблағи нигоҳдошташударо то вақте ки иҷро мешавад, нигоҳ медорад; агар кредитҳои нигоҳдошташуда ба ҳар ҳол дастрас набошанд, ҷараён бо
402insufficient_balanceҳодисаи хато, ва он чизе ки тавлид шудааст, ҳаққи он сурат гирифта мешавад. Агар хароҷоти воқеӣ аз маблағи боқимонда зиёд бошад, тамоми маблағи боқимонда гирифта мешавад, боқимондаи он қарз ҳисоб мешавад (owed_satsдарnymbotобъект ва сармояи манфӣ). Он чизе ки қарз аст, аввал аз ҳисоби кредити навбатӣ, ки ба он сармоя мерасад, пардохт карда мешавад. То вақте ки он пардохт нашудааст, ҳеҷ чиз аз он сармоя сарф карда намешавад: на тавассути API, на ҷавобҳо дар замима, на интиқоли маблағ ва на тӯҳфа. - Мизони қарз кофӣ нест. Агар маблағи боқимонда натавонад маблағи байн (hold) -ро пӯшонад, дархост бо
402пеш аз он ки чизе иҷро шавад. Хатогӣ мегӯяд, ки кадом тавозун кам аст, дархост ба чӣ қадар сатҳо ниёз дорад ва чӣ қадар озод аст. Як хурдтарmax_tokensмаънои нигоҳдории хурдтарро дорад. - Шикастҳо. Дархосте, ки нобарор мешавад, чизе наметавонад, магар ин ки таъминкунанда барои коре, ки то нобарор шудан иҷро кардааст, пардохт талаб кунад, ё ҷустуҷӯ дар веб ё...
nymbot/autoсупориш санҷиш аллакай иҷро шуда буд; пас шумо ҳамонро пардохт мекунед, ҳадди ақал 0.05 кредит. Ба стриме, ки шумо қатъ кардед, барои токенҳое, ки провайдер ҳисобот медиҳад, ҳақ пардохт карда мешавад: Nymbot барои гирифтани он ҳисоб то 25 сония пас аз он ки шумо рафтаед, хондани стрими провайдерро давом медиҳад. Агар он нарасад, ҳақ аз он чизе, ки шумо фиристодаед ва он чизе, ки навишта шудааст, баҳогузорӣ мешавад ва барои модели мулоҳизакор (reasoning) он тамоми имконияти натиҷаи нигоҳдоштиро дар бар мегирад. Дархосте, ки пайвандаш устувор нест, бошад ҳам анҷом ёфта, ҳақ ба он ҳисоб карда мешавад. - Ҷустуҷӯи веб арзиши ҳар як ҷустуҷӯ 0.008 доллар аст, ки ба satoshi табдил дода мешавад, ҳар вақте ки ҷустуҷӯ анҷом дода мешавад, хоҳ модел ҷавоб диҳад ва хоҳ нотарсбарор шавад. Саҳифаҳое, ки он мехонад, инчунин ба модел ҳамчун воридӣ фиристода мешаванд, бинобар ин онҳо токенҳои худро илова мекунанд.
Ҳар як ҷавоб мегӯяд, ки он чӣ қадар арзиш дорад. Ҷавобҳои JSON дорои... nymbot объект бо
балансе, ки аз он пардохт шудааст, маблағи пардохт дар кредитҳо ва сатсҳо ва он чизе, ки боқӣ мондааст:
Объекти хароҷот
"nymbot": {
"balance": "pro",
"charged_credits": 0.162,
"charged_sats": 16.2,
"balance_credits": 412.425,
"balance_sats": 41242.5
}
Ҷавобҳои пардохтшуда интлоҳоти зеринро низ доранд, ки дар он ҷо бояд арзиши ҷавоберо ҷустуҷӯ кард, ки JSON нест, ба монанди нутқ:
| Сарлавҳа | Маъно |
|---|---|
X-Nymbot-Cost-Sats | Ин дархост чанд сатс арзиш дорад? |
X-Nymbot-Balance-Sats | Дар боқияи чӣ қадар сатсӣ (sats) мондааст, ки аз он пардохт шудааст? |
X-Request-Id | ID барои дархост, дар ҳар як посух. Агар ба дастгоҳи дастгирӣ муроҷиат кунед, онро иқтибос кунед. |
Нархҳо барои ҳар миллион токен, ки аллакай ҳариҷоти хизматҳо ва маржаро дар бар мегиранд, дар...
рӯйхати моделҳо бо доллар ва сатс, ва дар боло
варақаи нархҳо. Агар нархи Биткоин хонда нашавад,
дархостҳои пулокиаш пардохтшуда баргардонанда мешаванд 503 price_unavailable бо
Retry-After: 60 ба ҷои тахмин кардан.
Хатоҳо
Ҳар як хато ҳамон шаклро дорад, ки муштариёни OpenAI аллакай мефаҳманд. code номи устуворест, ки шумо метавонед бо он мувофиқат кунед; message барои одамон аст ва метавонад тағйир ёбад.
Ҷисми хатогӣ
{
"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
}
}
| Ҳолат | Кай |
|---|---|
400 invalid_request_error | Бадан JSON-и воқеӣ нест (invalid_json), майдони ҳатмӣ мавҷуд нест (missing_required_parameter), қимати нодуруст аст, ё дархост чизеро талаб мекунад, ки модел ё нуқтаи терминал (endpoint) иҷро намекунад, ба монанди асбобҳо дар nymbot/auto (unsupported_tool). param номми майдонро мегузорад. Инчунин upstream_rejected вақте ки провайдер дархостро рад кард. |
401 authentication_error | Калид гум шудааст, номаълум аст, бекор шудааст ё муҳлати амалашро гум кардааст, ё дархости имзошуда нодуруст аст ё такрор шудааст. |
402 insufficient_quota | Баланс наметавонад дархостро пӯшонад. Code insufficient_balance, бо balance, required_sats ва balance_sats. |
403 permission_error | Дархост ба қобилияти калид мувофиқат намекунад (key_limit_reached, бо limit_sats, used_sats ва reset_at), ё шояд ҳисоб аз хизматрасонӣ истифода набарад (account_denied). |
404 not_found_error | Роҳи номаълум (unknown_endpoint), модел, ки вуҷуд надорад (model_not_found), ё калиди номаълум, фактура ё видео. |
405 | Роҳ мавҷуд аст, аммо на бо ин усул (method_not_allowed). Он Allow сарлавҳа методҳоеро, ки он қабул мекунад, рӯйхат мекунад. |
413 | Бадан ё файл хеле калон аст (payload_too_large, file_too_large), ё сабт хеле дароз аст (audio_too_long). Бинед маҳдудиятҳо. |
415 invalid_request_error | Бадан ҳамчун ... фиристода намешавад application/json (ё, барои нуқтаҳои ниҳояи боргузорӣ, multipart/form-data): unsupported_media_type. |
422 | Овоз ва забоне, ки дар матн ба суханронӣ (text to speech) бо ҳам мувофиқат намекунанд (voice_language_mismatch, unsupported_language). |
429 rate_limit_error | Дар ҳамин калид, аз ҳамин суроға ё бо маълумоти тасдиқкунандае, ки санҷишро гузашта натавонист, дархостҳои аз ҳад зиёд мавҷуданд (rate_limit_exceeded), ё провайдер маҳдудияти суръатро (rate-limiting) гузоштааст (upstream_rate_limited). Дар сонияҳо интизор шавед Retry-After. |
500 api_error | Дар тарафи Nymbot чизе хато шуд (internal_error). |
502 api_error | Тамдидкунанда ҷавобро баргардонд надид (upstream_error), ё ин ки ҳисоби Lightning содир карда нашуд (invoice_unavailable). |
503 api_error | Тамдидкунанда борро тавоноӣ надорад (upstream_overloaded), нархи Биткоин хонда намешавад (price_unavailable), ё қисме аз хидматрасонӣ кор намекунад (service_unavailable, media_hosting_unavailable). Retry-After мегӯяд, ки кай дубора кӯшиш кунад, дар ҷое, ки маълум аст. |
Ду истисно:
/api/v1/messagesҷавобҳо дар формати хатогии Anthropic, зеро ин он чизест, ки мизоҷони Anthropic таҳлил мекунанд:{"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).- Фармоиши стриминг, ки пеш аз гирифтани аввалин байт ноком мешавад, бо хатогии оддии JSON бо ҳолати дар боло зикршуда меояд, на ҳамчун потоки воқеа (event stream). Нокомӣ пас аз оғози стрим ҳамчун охирин воқеаи стрим дар формати худи он нуқтаи терминалӣ (endpoint) фиристода мешавад.
Паёмҳои хато ҳеҷ гоҳ маълумоти дохилии хизматрасони дигарро дар бар намегиранд. Хатогии худи провайдер пеш аз он ки ба шумо расад, аз нав таҳия карда мешавад.
Чордӯбҳо
| Маҳдуд | Арзиш |
|---|---|
| Хоҳишҳо барои ҳар як калид | 120 дар як дақиқа. Аз он боло, 429 бо Retry-After. |
| Дархостҳо бе калид | 120 дар як дақиқа барои ҳар як суроға, барои рӯйхатҳои модел, аудио ва усули пардохт, санҷиши токенҳои баргардонидани маблағ, ва нуқтаҳои терминалҳои пардохтшудае, ки бидуни калид ё пардохт даъват шудаанд. Аз он боло, 429 бо Retry-After. |
| Тасдиқи ҳувият нобарор шуд | 30 дар дақиқа барои ҳар як суроға барои калидҳо, имзоҳо, маълумоти пардохт ва токенҳои баргардонидани маблағ, ки тасдиқ намешаванд. Аз он ҳам зиёд, ҳар як дархост аз суроғае, ки маълумоти тасдиқшаванда дорад, мегирад 429 бо Retry-After то вақте ки дақиқа тамом нашавад. Ҳуҷҷатҳои тасдиқ пеш аз хондани бадан санҷида мешаванд. |
| Калидҳои нав | 60 дар соат барои ҳар як nym ва 120 дар соат барои ҳар як суроға. |
| Ҳисобномаҳои пули иловагӣ | 60 дар соат барои ҳар як nym ва 120 дар соат барои ҳар як суроға. |
| Пайвастшавии қамфати NWC | 10 дар соат барои ҳар як nym ва 30 дар соат барои ҳар як суроға. Рилэйи коши (wallet relay) бояд истифода барад wss:// дар порти стандартӣ. |
| Бозгарони токенҳо | 60 дархост дар дақиқа барои ҳар як токен. |
| Суроғаҳо | Суроғаи IPv6 дар ҳар як маҳдудияти барои ҳар як суроға ҳамчун тамоми /64-и худ ҳисоб мешавад ва суроғаи IPv6-и ба IPv4 хариташуда ҳамчун суроғаи IPv4-и худ. |
| Бадани дархости JSON | 4 МБ; 64 КБ барои дархостҳое, ки бо nym шумо имзо шудаанд. |
| Бади вродии дархости Multipart (юплоадҳо) | 32 МБ. Сурати вобаста ба таҳрир метавонад то 20 МБ бошад, файли аудиоӣ то 25 МБ. Беш аз 64 қисм, ки ҳар кадоме дорои намахҳои қисматӣ то 8 КБ ва ҳудиди 1 то 70 а矛ттор мебошад; дар ғайри ин ҳолат 400 invalid_multipart. |
| Расмҳо дар як дархости чат | 20. Ҳар кадоме як https:// ё http:// линке ба хости оммавӣ, ё як data:image/… URL. |
| Тасвирҳо барои ҳар як дархости генерация | аз 1 то 4 (n) |
| Токенҳои баромад | Дар сатҳи ниҳоии худи модел маҳдуд шудааст. Калонтар max_tokens ба он паст карда мешавад, на рад карда мешавад. |
| Воридоти нутқ | 800 аломат барои овози стандартӣ, 2,000 барои Aura 2. |
| Транскрипсия | 30 дақиқа аудио, 25 МБ. Сабти дарозтар рад карда мешавад бо 413 ва напулида мешавад, ҳатто вақте ки давомнокиаш танҳо пас аз он ки Whisper онро шунид, маълум мегардад. |
| Векторҳои эътимодӣ (Embeddings) | 100 воридҳо барои ҳар як дархост. |
| Ҷойҳои кории видеоӣ | Пас аз пешниҳод шудан барои 24 соат нигоҳ дошта мешаванд; рендер пас аз як соат дода мешавад. Ҳозиро барои ҳар nym на бештар аз 10 рендер. |
| Таърихи пурсишҳо | Барои 90 рӯз нигоҳ дошта шуд. |
| Калидҳои фаъол барои ҳар як nym | 25. Танҳо 50 калиди ботилшудаи навтарин нигоҳ дошта мешаванд. |
Во `=`равнаки акс бояд ба хости мардумӣ нишон диҳад: суроға дар шабакаи хусусӣ ё маҳаллӣ, ё дар сайтҳои худи Nymbot, рад карда мешавад. Танзими суръати провайдер, ки дар замима истифода мешавад, дар ин ҷо низ амал мекунад, бинобар ин, як ҷустуҷӯи зич ба як провайдер метавонад ба ҷои рад шудан, суст карда шавад.
API чӣ чизро метавонад бубинад
API ба мисли барномаҳо махфӣ нест ва арзиш дорад, ки дар бораи он чӣ гуна ин тавр аст, дақиқ гуфта шавад.
- Он шифргузории аз туро ба ту (end-to-end) надорад. Дар замимаҳо, паём дар дастгоҳи шумо маҳкам карда мешавад, то танҳо Nymbot калидҳоро дошта бошад ва ҳамчун ... интиқол ёбад балех барои тӯҳфа. Дархости API ҳамон HTTPS-и оддӣ мебошад: он ҳангоми рафтан ба сӯи Nymbot рамзгузорӣ мешавад ва сервери Nymbot онро барои коркард дар шакли кушода мехонад.
- Супоришҳо ва ҷавобҳо захира намешаванд. Онҳо ба модел мегузаранд ва ҷавоб баръакс меояд. Он чизе, ки нигоҳ дошта мешавад, ҳисобнома аст: барои ҳар як дархост вақт, модел, намуд, шумораи токенҳо, арзиш, боломонди, калид ва он ки оё он бомуваффақият анҷом ёфт, барои 90 рӯз, ки ин ҳамон аст тарихи пурсишҳо ба шумо нишон медиҳад. Сабти истифодаи ҳамон дархост (вақт, навъ, модел, шумораи токенҳо, хароҷот, давомнокӣ ва он ки оё ҷустуҷуи веб истифода шудааст ё муваффақ буд) инчунин барои 90 рӯз, дар баробари сабтҳои худи замима, нигоҳ дошта мешавад.
- Ҳамаи чизҳои дигар, ки барои nym нигоҳ дошта шудаанд, хурданд ва дар ин ҷо рӯйхат шудаанд. Калидҳои API ҳамчун хеш захира мешаванд, на худи калид, бо ном, ишораҳои кӯтоҳ, маҳдудияти сарф, давраи навсозӣ, мӯҳлати эътибор ва вақти сохтан ва охирин истифодаи онҳо; танҳо 50 калиди нави лағвшуда нигоҳ дошта мешаванд. Як пур кардани автоматикӣи маблағ unnecessarily connection-и кошели маҳфуз, бо ҳадди арзиш, миқдор ва натиҷаи охирини пур кардани маблағ нигоҳ дошта мешавад. Корҳои видеоӣ барои 24 соат нигоҳ дошта мешаванд. Дархостҳои пардохтшуда барои ҳар як даъват танҳо хеши пардохти Lightning-ро барои 7 рӯз ва токени кӯтоҳшудаи (hashed) баргардонидани маблағро барои 30 рӯз нигоҳ медоранд, ки ба ҳеҷ номи дастгир (nym) пайваст нестанд. Хароҷотҳое, ки болои маблағ мавҷуд буданд ва маблағи мавҷуда онҳоро фаро нагирифт, то вақте ки пур кардани маблағ онҳоро пардохт накунад, ҳамчун қарз нигоҳ дошта мешаванд.
- Тоза кардани барнома онро нест мекунад. A шабакаи дастгоҳро тоза кардан калитҳои API-ро бекор ва нест мекунад, ва тарихи саволномаҳо, сабтҳои истифода, пайвасти ҳамён ва корҳои видеоиро нест мекунад. Баланс ва ҳар гуна пардохтҳои боқимонда дар nym мемонанд.
- Таъминкунандаи модел дархости шуморо мебинад, ҳамон тавре ки аз барнома мебарояд. Моделҳои Каталог дар серверҳои созандаҳояшон иҷро мешаванд; роҳҳои стандартӣ ва эмбедингҳо дар Cloudflare иҷро мешаванд.
- Медиаи сохташуда ҷамҳориятист. Расмҳо ва видеоҳое, ки ҳамчун пайвандҳо фиристода мешаванд,
ба хостҳои файлии кушоди Blossom бор карда мешаванд, ки дар он ҷо суроғаи файл ҳэш (hash) мебошад. Ҳар касе, ки
пайвандро дорад, метавонад онро кушояд ва Nymbot наметавонад онро боз аз кор берун кунад. Дархост кунед барои
b64_jsonва сурати тавлидашуда дар ҷавоб меояд ва ҳеҷ гоҳ боргузорӣ намешавад. - Пас, оё аксҳое, ки шумо медиҳед, генератор ҳастанд? Сурате, ки шумо боргузорӣ мекунед ба
таҳрир, ё ҳамчун ... фиристодан
data:URL дар созандаimage_url, аввал ба хости-и оммавии Blossom боргузорӣ карда мешавад, то генератор тавонад онро гирад, ва ҳамин тавр барои он низ ҳаст. Сурате, ки аз ҷонибиhttps://пайванд ҳамчун ҳамон пайванд интиқол дода мешавад. Суратҳо дар дархости чат ба таъминкунандаи модел мераванд, не ба Blossom. - Калид ба nym-и шумо пайваст аст. Ҳама чизе, ки калид сарф мекунад, аз тавозуни nym-и шумо кам мешавад, бинобар ин истифодаи API нест беномАгар шумо хоҳед, ки API аз номи маъмулии шумо ҷудо бошад, калидҳоро аз як номи алоҳида бо тавозуни худаш созед.
Агар ба шумо ҳифзи замимаҳо лозим бошад, аз замимаҳо истифода баред. API барои ҳолатҳоест, ки шумо моделҳоро дар асбобҳои худатон истифода бурдан мехоҳед.
Ҳамаи нуқтаҳои терминалӣ
| Нуқтаи терминалӣ | Чи кор мекунад | Аутентификатсия |
|---|---|---|
GET /api/v1/models | Рӯйхати моделҳо, бо нархҳо | Ҳеҷ |
POST /api/v1/chat/completions | Таммими чат | Калид |
POST /api/v1/responses | API Ҷавобҳо | Калид |
POST /api/v1/messages | Паёмакҳои Anthropic | Калид |
POST /api/v1/messages/count_tokens | Тахмини токенҳои воридотӣ | Калид |
POST /api/v1/images/generations | Тасвирҳо тавлид мекунад | Калид ё Барқ |
POST /api/v1/images/edits | Тасвирро таҳрир мекунад | Калид ё Барқ |
POST /api/v1/videos, GET /api/v1/videos, GET /api/v1/videos/{id} | Оғозҳо, рӯйхатҳо ва санҷиши видеоҳо | Калид, ё Барқ барои оғоз кардани яке |
POST /api/v1/audio/speech | Матн ба сухан | Калид ё Барқ |
GET /api/v1/audio/models, GET /api/v1/audio/voices | Моделҳои аудио ва садоҳо | Ҳеҷ |
POST /api/v1/audio/transcriptions, POST /api/v1/audio/translations | Суханронӣ ба матн ва ба англисӣ | Калид ё Барқ |
POST /api/v1/embeddings | Векторҳои эътимодӣ (Embeddings) | Калид ё Барқ |
GET /api/v1/credits/balance (ё POST) | Ҳам ҳарду бақия | Калид |
GET /api/v1/topup/payment-methods | Усулҳои пардохт | Ҳеҷ |
POST /api/v1/topup/create/btc-lightning | Счет-фактураи Lightning | Калид |
GET /api/v1/topup/status/{invoice_id} | Санҷиш ва ба суратҳисоб ворид кардан | Калид |
GET /api/v1/queries/history | Арзиши ҳар як дархост чӣ қадар аст? | Kalid ё nym |
GET /api/v1/account | Хулосаи суратҳисоб | Nym |
/api/v1/keys | Калидҳоро месозад, тағйир медиҳад ва мекунад | Nym |
/api/v1/nwc-auto-topup | Танзими шарҳгузории худкор | Nym |
GET /api/v1/l402/refunds, POST /api/v1/l402/refunds/redeem | Санҷиш ё иваз кардани токени иртироени маблағ | Токени барқароршавӣ; nym барои иваз кардан |
“Nym” маънои дархостеро дорад, ки бо калиди Nostr-и шумо имзо шудааст, ки дар ... тавсиф мешавад имзо кардани дархостҳои ҳисобБарои асбобҳое, ки аллакай бо ин форматҳо кор мекунанд, бинед асбобҳо ва SDK-ҳо, ва барои агентҳои кодинг мисли Claude Code, Codex ва Cline, бинед асбобҳои барномасозӣ.