Ба мундариҷа гузаред
Баргаштан ба Nymbot

Пойгоҳи дониш Таҳиягарон

Шарҳи API

Моделҳо, генераторҳо ва тавозуне, ки шумо дар барнома истифода мебаред, аз коди худи шумо мебошанд. API форматҳои OpenAI ва Anthropic-ро мефаҳмад, бинобар ин аксари асбобҳо ва SDK-ҳо тавассути тағйир додани URL-и асосӣ ва калид кор мекунанд.

API чист

API-и HTTP дар nymbot.ai он ки ҳамон дархостҳоеро иҷро мекунад, ки мизони OpenAI ё Anthropic аллакай мефиристад. Шумо мегиред:

Ин аз ҳамон ду таъсид пардохт мешавад балансҳо мисли замима, бо ҳамон нархҳо. Яке аз инҳо, обуна ва квотаи ройгон дар API вуҷуд надорад: ҳар як дархост аз ҳисоби кредитҳои харидаатон пардохт карда мешавад.

Дар он чизе, ки API иҷро намекунад, илова кардани ягон чизи худи Nymbot надорад. Паёмҳои шумо ба модел ҳамон тавр мераванд, ки шумо онҳоро фиристодаед: на супориши системавии Nymbot, на хотира, на ишораҳои таърих ё забон. Он чизе, ки баргашта меояд, ҷавоби модел ва қайди нархномаи он аст.

URL-ҳои асосӣ

Истифода карданСуроғаи асосӣ
SDK-ҳои OpenAI ва абзорҳои мувофиқ бо OpenAIhttps://nymbot.ai/api/v1
SDK-ҳои Anthropic ва Claude Codehttps://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-ро дорад, ки дар кадом баланс дархост иҷро шавад. Пеш аз иҷрои дархост, нархи максималии эҳтимолӣ (ба кредитҳои пурра ба боло раундшуда) нисбат ба боқимондаи маҳдудият муайян карда мешавад. Агар он мувофиқ наояд, дархост бо зери ин рад карда мешавад: 403 key_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 лозим аст. Танҳо арзиши воқеӣ пардохт карда мешавад; боқимонда пас аз анҷом ёфтани он озод карда мешавад. Дархости тӯлонӣ маблағи нигоҳдошташударо то вақте ки иҷро мешавад, нигоҳ медорад; агар кредитҳои нигоҳдошташуда ба ҳар ҳол дастрас набошанд, ҷараён бо 402 insufficient_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-IdID барои дархост, дар ҳар як посух. Агар ба дастгоҳи дастгирӣ муроҷиат кунед, онро иқтибос кунед.

Нархҳо барои ҳар миллион токен, ки аллакай ҳариҷоти хизматҳо ва маржаро дар бар мегиранд, дар... рӯйхати моделҳо бо доллар ва сатс, ва дар боло варақаи нархҳо. Агар нархи Биткоин хонда нашавад, дархостҳои пулокиаш пардохтшуда баргардонанда мешаванд 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 дар соат барои ҳар як суроға.
Пайвастшавии қамфати NWC10 дар соат барои ҳар як nym ва 30 дар соат барои ҳар як суроға. Рилэйи коши (wallet relay) бояд истифода барад wss:// дар порти стандартӣ.
Бозгарони токенҳо60 дархост дар дақиқа барои ҳар як токен.
СуроғаҳоСуроғаи IPv6 дар ҳар як маҳдудияти барои ҳар як суроға ҳамчун тамоми /64-и худ ҳисоб мешавад ва суроғаи IPv6-и ба IPv4 хариташуда ҳамчун суроғаи IPv4-и худ.
Бадани дархости JSON4 МБ; 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 рӯз нигоҳ дошта шуд.
Калидҳои фаъол барои ҳар як nym25. Танҳо 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/responsesAPI ҶавобҳоКалид
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, бинед асбобҳои барномасозӣ.