Contenido nisqaman saltay
Nymbot-man kutichiy

Yachaypa sapin Qhapaq ñan kamachikuqkunas

API sumaqta willay

App nisqapi ruraykuna, yarqaykunapas allinpas kachkan, qampa khipuyla rurasqaykiman. API-qa OpenAI nisqapaq hinaspa Anthropic nisqapaq nisqankunata riman, chaymi aswan tukuy yupaykuna hinaspa SDK-kunaqa aswan allinmi llamkan base URLta hinaspa key-ta rikch'aspa.

Imataq API kasqan?

An HTTP API kachkan nymbot.ai chayqa OpenAI icha Anthropic clientqa kutim apamun chay imaynatas, chaytaqa qanqa riqsinki:

Payqakuqmi chay iskay ñawpaqkunamanta. Allin sayaykuna app hina, hinataqmi chawpin. API nisqapiqa manam sapa kutillapaq kashanchu icha qhapaq kashanchu: qaykuykunallataq qullqita rurachkanchik qillqasqaykichikmanta.

API-qaqaqaqaq nishqayqa Nymbotpa sutinwan imatapas manañam añonchu. Qampa willakuykikunaqa modelmanmi chayan, qampa apachkaptaykiman: manam Nymbotpa imatamanta willakuyninichu, manam yuyayninichu, manam p’unchayta o simita yachachiqkunachu. Kutimuşqaykiqa modelpa kutichisqanmi, chaymantapas hayk’aqmi rurasaq kashan chayta ninanmi.

Sapaq URL-kuna

UsarSapa pacha URL
OpenAI SDK-kuna hinaspa OpenAI-wan allinchaq llank'aykunahttps://nymbot.ai/api/v1
Anthropic SDK-kuna hinaspa Claude Codehttps://nymbot.ai/api (SDKmi añon) /v1/messages kunanmi

Chay pacha endpointmi kachkan /api/v1/. Mana yachasqa ñan kutimun 404 hinallataq yachaq ñan huk chaypaq mana allin kuraq ruraywanmi kutichin 405, chayqa JSON nisqapi,

APIqaqa imaymana wasikunamanta pacha cross-origin sut'i rimasqankunata kutichin, chaymi browser nisqapiqa hayariyniyki. Manapas, browserman apasqayki imapas qelqasqaykiqa qelqasqata riqsisqa kanqa qelqasqata qatirinapaq runakunapi, chaymi chayta rurayllayki p'iti kaniypaqmi. Ch'ullu. Qanpa nym-niykiwan qillqasqa endpoint-kuna (keys, account summary, NWC auto-top-up 차 refund redemption) nisqak lliwtan: browser nisqapiqa, Nymbot-pa sutinpiqllata kutichinku. Rikuy qillqasqaykichik account yanapakuypaq tukuykunata.

Chayqa JSON patakuyninkunataqa tukuyta purichiy ✍️ Content-Type: application/json. Huk otherwise hinallataqmi rechazakun» 415, chayqa huk allin HTML ruraychu icha a text/plain huk huk wasimanta paqarimunanchis API-ta mana chaskiyta atispa. cURL nisqawan, apachiy -H "Content-Type: application/json" wanan nispa -d.

API k'uyachakkuna

Killaqkunata apppipi ruranku. Puñuy API web app nisqapi kawsaypa uñachayninpi, chaymanta Android hinallataq iOS nisqapi menu nisqapi, chaymantataq tikray Llave ruraySuti haywarichiy, chaymantapas munankiqqa, huk waskayta hinaspa tukuyta p'acha pacha t'ikrayta.

Llaveqa huk wataqllapam rikuchisqa kan. Qelqata tukuykamaykichispas, pakasqa wasipi qelqaychik: Nymbotqa chay llavepa imayna rurayninllapam churay, chaymi manañam huk wataq rikuchisqaykichu. Llasqan llaveqa manañam kutichisqachu; chayta qasichiy, huk ñawinqantataq ruray.

Huk k'uñiq chay hinam kashan sk-nymbot- tawa chunka huk ñiqiqkuna, yupaykuna, k'anqasqakuna hinaspa t'aqasqakuna risqa. Kay hampinaqa imaymana k'uyuchiykunata sutinwan hinaspa yachaychayta rikuchin, chayna: sk-nymbot-Qm7x…c2Lw.

  • Huk killa qanpa sutinmantam. Qullqi qhipayniykita usuchin, chaymantapas nym-llayki paqarichin, chatsachin icha qichun chayta. Mayqanpas kawsayta (key) kaqqa chaywan qullqita usuchin, chaymi willayniykita (password) hina qatichiy.
  • Caps-kunaqa sats-pi kachkan. Huk k'uyuchiypaqmi qolqeyuqta qatiychwan, chay qolqeyuqtaq p'unchayllapi, p'unchay k'aspaypi (Lunes) icha killapi (ñawpaq p'unchay), 00:00 UTC tiyupim allichan. Payqa iskayninchis qolqeykunatapas yachaynin, huk sumaq qolqeyta 10 sats nispa, hinaspa huk Pro qolqeyta 100 nispa, chayqa chaymi kanqa mayqan qolqeytaqa usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta usqhayta us 403 key_limit_reached, aswanpas chay pachaqa qallarin chayqa; ñiqaykiqa ima kashanmi nipiwan chay hatun k'anqa qhipanpas. Hinaspas hamuy max_tokens chikniyuq kaqta pacha allinata qun. Huk mañakuyqa paypa chaskisqa kachkanmi, chaymi limitata yanapan, chaymi yupayniyuq runaqa qallariq kachkananchispaq aswan tokenkunata sut'iyta apasqan, chaymi huk chayamusqa mañakuyqa limitata chawpinpi chayamun; chaymantapas hukninchisqa qatun.
  • Lluq'isiq qullqiqa qullqita tukuyllan sayachin. Huk kancha cap nisqapiqa chinkaspa pasañanta rikun, kawsayninmanta yachayta qillqan, modelo-kunata listan, token-kunata wanun, qullqita apaspa chayqa qallariqtaq videota rikun.
  • Puchukuyqa mantsay mana allinmi. Qhipa p'unchayta tukuspan, llaveqa mana llamkanchu.
  • Qallariypaqmi chayta qichusqayki, chayqa tukuytaqmi. Chay qunqaychay qallariypaq k'anchaytaqa mana allintachu ruwan. Chayqa listapi kashan, qallariypaq nisqawan, chaymi qullqi rurayninqa allinta kachkan.
  • 25 kanchayniyuq ruksiykunataq qhawariwayki, ida paypataq sutin kachkan. Huk ruksiyta tukuyta munanaykipaq, chaypa pacha kutichisqanqa musuq pacha zero nisqamanta qallarin.

Chay p’unchay qillqasqaqa kawsayninpi maki p’achasqankunata hinaspa tukuyta, chaypi riqsimusqa kananchispaq, imaynatapas qhipa pachapi usqhaylla usqhaylla charikusqaykichispaq, imaynatapas qhipa pachapi usqhaylla usqhaylla charikusqaykichispaq, hinaspa astawan riqsisqa kachkaptinqa, chaypi qillqasqa kachkan: mikhuykunata kamachiy.

Kiñaychay huch'uy rurayta

Chaykunapi huch'uy k'anchaykunamanta (headers) hukllapi charkay. Kaykunaka allinmi, chaymi qanpa rurayniykikunapas (client) pacha chaskin:

Umaq ñawpaqtaQhipanmi kachkan
Authorization: Bearer sk-nymbot-…OpenAI SDKs, aswan kaq kaq lliwtin, Claude Codewan wataunmi ANTHROPIC_AUTH_TOKEN
x-api-key: sk-nymbot-…Anthropic SDK-kuna
api-key: sk-nymbot-…Azure-willay kllay cliyentkuna

Mana kanchaq, manañam riqsichasqa, chinkachisqa icha tukuchisqa killa kachkan 401, k'ana nisqawan missing_api_key, invalid_api_key, revoked_api_key dois expired_api_key. Kuyasqa kawsaykunata, uyarina kawsaykunata, rimaykunata, payqakuypaq ñawpaqtaq kawsaykunatapas mana llaveqa manañam kikinchu.

Llimp’ikuna, vidio, rimay, qillqasqa hinapas embeddings nisqakunapas huk kutichiyllataq Lightning nisqapi kanchik, munaq kuraqtaq mana kachkaptispa: hukta mana apaspa kutichiyta apachiyta, chaymantataq chay qelqasqata willaypi... 402 imaspay. Rikuy lluq’isqa kashaspa lluq’isqa manam kanki.

Qhipakuq ruranakuy, account summary chaymanta automatic top-ups nisqakunataqa manam allichasunchu: nym-ykikichikmanta qillqasqa runakuyta qowanku manam key-llachu, chaymi huk keymi usqhayta saqisqaqaqa huk chapa qhipakuq runakuyta rurichin mana. See qillqasqaykichik account yanapakuypaq tukuykunata.

Qallari rimayniyki

Llaveqa huk environment variable nisqapi churay, chaymantataq huk model nisqata tapuy. Kay patakunapi qillqasqa lliw luraqkunapas chaymantam ñawinchinku 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 Nymbotpa sutinpi ruran, chaski kachkan sumaq qullqiykiwan. Chaypiqa hina hina rurayta, idaq rurana sutinta (catalog model's id) churay: anthropic/claude-sonnet-5, chay modelota usunanapaq Pro saldomanta. Modelokunata listay hinallapi id nisqata qowanchik.

Imaynan huk sut'iyqa qariypunman

APIqa app nisqapas hina hinallapi qarqayta apun.

  • Ima allin even. nymbot/auto qayarin [] sapa ñanain bilay (10 sats qarpay). Huk wataqa hukmi yachay ruranaqa... Pro pacha (100 sats qolqech), Ñawpaqtaq imaymana rikchay rurana nisqapas hinataq ñawpaqtaq rimay rurana nisqapas ñawpaqtaq qolqechkunata machaykun; paykunawanqa imaymana rurana nisqakunapas Pro qolqechkunata machaykun. Embeddings nisqapas ñawpaqtaq qolqechkunata machaykun. Transcription nisqapas ñawpaqtaq qolqechwanmi rurakun, manan chayqa Pro qolqechkunawanmi rurakun. Rikchaykunapa lista nisqanmi nisin masiyachasqa qolqechwanmi imaymana rurana nisqapas machaykun.
  • Hayk'aq. Huk rimanakuyta munasqaykiqa hinataq tukuymi kachkan chay modelqa ñawpaqta rimasqa-qariypas qillqasqa-qariypas tokens nisqapi, unay qullqi chaskiqpa pacha qillqasqan hina. Chay chaninpaqqa 5% nisqata apaspa, 1.5 nisqawan huch'uyta pacha kachkan, chaymi qanqa unay 1.575 nisqata chaskinki unay qullqi chaskiqpa qillqasqanmanta. Chayqa Bitcoin qullqipi sats nisqaman t'ikraykuspa, chunkasqa credit nisqapi charkaykun. Sumaq rikch'aykuna, video nisqapas, rimaypasqa, chaskiykunapi chanin kachkan, huk sut'i pacha nisqapi icha huk qillqasqa sut'i nisqapi, chaymi imaynanmi qullqi apasqayki hina. Sumaq rikch'ayqa 5 standard credits nisqawan, sumaq rimaypasqa 3 nisqawanmi.
  • Qallariy ñan. Chaymi imayman qelqaykunapas huk pachak pachak nisqamanta 0.05 credit nisqata rurini: standard balancepi hampi sat, Pro-pi 5 sats. Credit nisqapa p’acha kawsayninqa qhipamanta chaskikusqa kanqa, manan huk kutimmi upallachisqa kanchu.
  • Chaynataq sayay, chaymantataq tiyay. Huk phiñakuyqa mana purichikunanchispaqtaq, qanpaq qullqiykimanta chay kamachiyqa churan, qanpaq apachisqaykimanta hinaspa chaymi rurayqa sapaq qullqitapas churan. Plain ASCII manañam kanchu, chayqa UTF-8 bytes-manta hamun, hinaspa ASCII qillqakuna hinaspa pichaqkunapas sapaq token hinallam churan, chaymi sapaq qillqaykuna, k’umpi k’umpi kawsaykunapas hinaspa yupaykunaqa churanakusqallam. Chay qullqiqa sapaq creditokunallam churan, hukniyuqpas, chaymi sapaq kamachiyqa chaniq 10 sats standard balance-pi icha 100 sats Pro-pi qallarinanpaq. Chay kamachiypa chaskisqan qullqiqa churan, chaymantapas qhipaqa kachun. Huk hatun kamachiyqa chay qullqita ruraynin kachkan kancha; chay qullqiqapas mana kanchaytaqa, huk yamaymi tukukun. 402 insufficient_balance hallpacha sapaq, chaymi rurasqaqa qarqan. Chay ñawpaq qullqiqa pasasqa qullqimanta aswan kaspanqa, tukuy qullqita apanku, chaymantapas aswan qarqay kachkan (owed_sats pi kaq nymbot pacha, hinaspa huch'uy pacha qullqi (negative balance). Ima paid kanmi chayqa, chay qullqiqa chay pacha chayamuq qullqikunamaychakunmi ñawpaqta pagasqa kanqa. Chay pagakuna tukuykamaqa, chay pacha qullqipiqa imapas mana usuchunqachu: API-llapachu, apppi qelqasqankunapi, transferencia icha lulunapi.
  • Mana hinallapachu qhipay. Chay sumaq kaqqa chay qasqata mana chhayasqataqa, qarpayta qonqaqmi 402 imaymanpas amañakuy kaqtinqa. Huk yakuq kamachiyqa riqsimanmi mayqanmi nanan, hayk'aq satista hinataq yanapakuyniqqa munaynin, chaymanta hayk'aqmi qhipan. Huk aswan [] max_tokens qaqayachisqa kachkan.
  • Llaqtaykuna. Manan llamkayninchispaqmi huk suyusqa kaqmi, manan qullqi mañakuyqa mana imallachus, exceptu kawsayta qarqan chaytaqa, icha web nisqapi maskayta icha... nymbot/auto llamk'ay ruwasqa kanman; chayqa chaytaqa qarqayki, chaysaqa 0.05 credit. Tukuchisqayki streammi, chaypiqa provider nisqan tokenkunata qarqun: Nymbotqa provider nisqanpiqa 25 segundo kachun chaymantapas qayayniykita qelqaspa chay yupayta maskhan. Manan chayqa chayman chaykachu, chayqa qampa qoykusqaykimanta hinallataq ñawpaqta kaqmantapas yupakun, hinallataq yuyayniyuq model kaqpiqa tukuy output nisqata qarqun. Tukuy chaypi tukuy pacha qarquyta tukuchun, hinallataq qarqakun.
  • Willaypaq ñawinchay $0.008 nisqata qallan rimaypi, sats-man t’ikraspa, kachkan chay rimaypaq, chayqa modelqa kutichinkun chayqa ichaqa manam kutichinkunchu. Pay ñawinchasqan pajinakapas modelman kutichiypaq apakun, chaymi paypa tokensninwanmi kachkan.

Tukuy kutichiykuna imaynan chalan nisqanta nin. JSON kutichiykunaqa... nymbot Pagasqa qolqeywan, kredichaykuna ukhupi hinallataq satsichaykunawan, hinaspa qhipaq kaqta riqsisqan kaq:

Allichay imayman

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

Qarqayuq kutichikunapas kaykunata apan, chaypim qarqayuq kutichiykunapa apasqanta mask'an아야, manam JSON kasunchu, hinallataq rimay hina:

Umaq ñawpaqtaTukuy rimaykunapa imaynan kachkan kasqan
X-Nymbot-Cost-SatsKay k'uñiqpi qali, sats nisqapi.
X-Nymbot-Balance-SatsHayk'aqmi qhiparin qanpaq kaq chay qullqi p'anchaymanta, sats nisqapi.
X-Request-IdHuk id, llapan kutichikuykunapi. Kayta qillqarichiy hatun yanapakuyta munankiqtin.

Millon tokenkunapaq apanqaynin, qallariypaqmi pagaspas, kachkan... modelkunapa ñawpaqninpaq lista ninkun dólareswan satswan, hinallataq qullqi qillqana. Chayqa Bitcoin hannaq chaskiyqa manaraq qallariq chayqa, p'achakuy aswan aswan kachkan 503 price_unavailable wanan Retry-After: 60 manam yachay chayraqchu.

Paniyachiykuna

Chay sapa yupaypiqa mayllaymi kachkan, OpenAI rurunaqkunapas yachasqan hina. code qañiypaq sutinmi, chaywanmi takisunki; message runakunapaqmi, chaymantatapas cambiasqa kanman.

Hutsa kurku

{
  "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
  }
}
KayninHayk'aq
400 invalid_request_errorCuerpoqa validu JSON mana kanchu (invalid_json), manqataq qillqanapaq mana kanchu (missing_required_parameter), huk kaqqa huch'uyllam, ichaqa sut'inqa hinataq model o endpoint manañam ruranchu, hinataq hinataq hampina kawsaykunataqa... nymbot/auto (unsupported_tool). param sutichkanchay pacha. Chaywanpas upstream_rejected kay qatunaq wasichaqa mañakuyta mana upachispa.
401 authentication_errorLlank'aypa urqunin mana kaunchu, manan riqsikanchu, qichariychasqa kanchu icha tukuchasqa kanchu, chaymantaq upallay tusuyuq rimayqa mana allinchu icha kutimuytaq kachkan.
402 insufficient_quotaQhipaq qullqiykiqa mañakusqaykita mana chayanmanchu. Koodi insufficient_balance,wan balance, required_sats chaymanta balance_sats.
403 permission_errorKay imaymana rurayqa llavepa kapnina mana tupanmanchu (key_limit_reached,wan limit_sats, used_sats chaymanta reset_at), ichaqa accountqa manapuni serviciota usarachu (account_denied).
404 not_found_errorMana riqsisqa ñan (unknown_endpoint), mana kaqtaq modelo (model_not_found), wenallata manaraq riqsisqa key, pag'uypaq qillqasqa wenallata vidio.
405Ñanqa kashan, ichaqa chay ñanmantaqa manam ₍method_not_allowed). Kay Allow umaykunata qillqan header nisqa.
413Kay kawsay icha hampiqqa aswan hatunmi (payload_too_large, file_too_large), chaymantaq qillqasqaqa manan allinchu icha qografiyayuqqa aswan wataqmi (audio_too_long). Rikuy lindunakuypaqka.
415 invalid_request_errorKurkuqa ... hina manam apachisqa kanchu. application/json (má, qhapaq kachkaspakuq pachaqtaqa, multipart/form-data): unsupported_media_type.
422Rimaykunapas simipasapaspas mana tupanankupaq text to speech nisqapi (voice_language_mismatch, unsupported_language).
429 rate_limit_errorKay k'elpiypaq anchaqa ñanqaqa, kay pacha pacha nisqamanta, o ima k'elpiypaq ruraykunapas manam allin kanchu chayta rikuchispa (rate_limit_exceeded), chayri allichaqqa kanchaq kachkan (upstream_rate_limited). Chaypi iskay ñanqata suyay Retry-After.
500 api_errorNymbotpa ñawpaqninpi huk pacha sapa ñawpaqpas mana allinchu kachkarqan (internal_error).
502 api_errorQatichaqqa kutimuchkarqanchu kutichiyta (upstream_error), chaymantaqa Lightning invoice ruray tapuwan (invoice_unavailable).
503 api_errorRurayqa anchata k'umichkan (upstream_overloaded), Bitcoin allichaq chaninchayta manataq qelqayta atinanchu (price_unavailable), chaymantaq huk parte nisqa kamachiyqa manan kanchu (service_unavailable, media_hosting_unavailable). Retry-After hayk'aqpaq tukuyta rayk'un아야, maypichus yachay kuska kananchik.

Ishkay t'aqasqa:

  • /api/v1/messages Anthropicpa yupayninpi kaq nisqapi kutichikuykuna, chaymi Anthropic llamkayninakuna ñawinchinqa: {"type": "error", "error": {"type": "authentication_error", "message": "…"}}Lulunqa kaqmantapacham panichkan: invalid_request_error, authentication_error, billing_error (402), permission_error, not_found_error, request_too_large, rate_limit_error, api_error dois overloaded_error (503).
  • Ñawpaq byte chayamunankama kutichikuq streaming nisqapiqa, chay aswanpi kachkaq JSON error nisqawanmi kutichikun, manam event stream kanchu. Stream qallarinanpas kutichikuqqa, chay endpoint nisqapa rurayninpi, chay stream nisqapa huk chawpi eventnin hina kachkan.

Yuyaykunawan sasa kawsaykunapas mana qospaqmi huk paypa unanchaynin nisqataqa kanchu. Huk ruraypa unanchayninpas qanman chayamun tapuypas, huk simipi nisqam qispi kachkan.

Límidlukuna

LímiteQullqi ñoqapaq/Allin kaq
Kuska kashan killa nisqapaq chaskikunaMinutu nisqapi 120. Chaymantapas aswan, 429 wanan Retry-After.
Llapa ruraykuna killa mana killa kachkaptinkuqaChay pacha, direcciónmanqa pichqa minutopi huk pachak ishkay, hampina modelo, audio, qelqanakuypaq chay pagakuypaq nisqakunapaq, kutichiy token riqsisqaykunapaq, hinallataq kancha qelqanakuypaq mana kancha kachaw de qallariypaq. Chaymantaqtaq, 429 wanan Retry-After.
Qhipaqman ruray mana allin ruraychuÑawpaqman kachkanmi 30 a minuten address idaqa llavekunapaq, firmas, pagapu ruranapaq yupaykunapaq ima, hinaspa kutichiy tokens kachkan chay mana riqsisqaqkunapaq. Chaymantaq, addressmanta credencial apasqan imapaqpas... 429 wanan Retry-After kancha pacha tukukunaqtikpaq. Credenciales-qa kikin nisqata qallarinanchapaqmi rikuchikun.
Musuq kawsaykunam60 an hour per nym 120 an hour per address.
Qullqi churay pagapu qillkakuna60 an hour per nym 120 an hour per address.
NWC wallet t’inkanakuykunaChunka huk pachakpi nym nisqapaq hinallataq kimsa chunka huk pachakpi address nisqapaq. Wallet relayqa usuchina kan. wss:// pacha purina purinuq kaqpi.
Qulqi k’ik’uy tokensChunka soqta ruraykuna p'unchay punchaw token nisqapaq huk minutu llaqtapi.
WasichakuyninkunaHuk IPv6 addressqa sapa address nisqapi limit-kunapi /64 nisqanwanmi yupakun, hinaspa huk
JSON kaykuna wenan4 MB; 64 KB qanpa nimpawan upiam kachkaq ruranakuykunapaq.
Multipart request k'anchay (qhaykuykuna)32 MB. Allichanaykipaq rikchayqa 20 MB-llapi chayamun, takiy wasqaqa 25 MB-llapi chayamun. Payallataq 64 patakuna, huk hukunmi 8 KB-llataq ruraynin, hinallataq 1 watanmanta 70 watakuna kikinpi; manachu chaytaqa. 400 invalid_multipart.
Tukuy rimasqaypi rikchaykuna huk sapa kutimanta20. Hukmanta hukmi https:// dois http:// kay pacha rurunaqpaq wasinman ñan, chayqa a data:image/… URL.
Qillqaykunapa wataqnin kachun qillqaypaq tukuy ñiqinpihukmantapacha tawa (n)
Lluqsichisqa token-kunaModelpa pacha rurayninpi k'achasqa. Huk aswan allin max_tokens chayman kunasqa, mana qonq'asqachu.
Rimay rimay qelqaqaPaqarinkunaraq rimay kamachisqaqa 800 qillqasqata, Aura 2 nisqapaqqa 2,000 qillqasqata.
Qillqasqaykunata ñawpaqman qillqayKimsa chunka minutu uyarina, iskay chunka pichqa MB. Huk aswan hatun uyarinaqa chaywan qarqun 413 hinataq mana qullqitaqa manañam chaskinchu, Whispermi ruraqtinmi chaypa hatun kayninqa rikun.
Kaypi kachkan riqsisqa kawsayniyuq ukhu ukhuypaqmi100 qallariykuna mañakuy pachapi.
Video llamk'aykunaQelqasqa kachun pachaqa chunka ishkay pacha (24 hours) hina; huk pacha (1 hour) nisqapiqa rurayqa chaskin; huk nym nisqapaqqa chunka ishkay (10) rurayllam huk kutipi.
Tapukuykunapa willakuykuna90 punchawpakama waqaychasqa.
Nym nisqapi kachkaq killaqkunamanta (active keys)25. Ñawpaq kachkanqa allin chayqa, qhipa qichwa chawpi 50 qichwa qichwa kachkanqa.

Llaqtayaypa rikch'ayninpa linkninqa allin kawsaypacha kachkan: hukk kachayqa michay pacha icha nisqapi, ima, Nymbotpa sutinpi kachkanpas, qasqun. Apppi kachkanpaqqa pacha kachasqaykunaqa allintam rurakun, chaymi huk pachaqman pacha wajtanakaqkunataqa ancha manan kachun, aswanqa kachayta waqaychaymanta.

Imatataq API rikunman

APIqa appkunapa hinaqa manam waskhayachasqachu, chaymantapas manañanmi allin kachkan chayta tapuypas hina nispa nispas.

  • Mana qallariypaqmanta tukuykupaq chinkachisqa kanchu. Appkunapi, huk willakuypaq qillqasqa kachkan qampa rikchayniykipi, Nymbotpaq allinmi, chaymantami purin huk... llamkay qelqaypaqAPI mañakuyqa sapa kutin HTTPSllamanmi: Nymbotman riypaqtinqa k'umuy (encrypted) karqan, hinaspa Nymbotpa serverninqa qhicha nispa ñawinchinmi allinchanapaq.
  • Qelqasqaykuna imaymana kutichikuykunapas mana tupuchisqachu. Huk modelo chayman purinmi, hinallataq kutimanta kutichiy chayman kutipun. Paypaqqa chaymi qhipakun: imaynatapas, huk kutimanta pacha, modelo, lliw, token hayk'aq, qullqi, qhipaq qullqi, key hinallataq rurayqa allinchu icha manachu, 90 punchawpaq, chaymiqa tapukuq ñawpaq kawsaynin qanpaq rikchayninta riqsichin. Huk wataqmi chay askhaypa qelqanmanta (pacha, hinaq, modelo, token lulun, chanin, sumaq pacha chaymanta web nisqata usuchasqachu icha allinchasqachu) huch'uy kuska 90 punchawllam qhipakun.
  • Ñawpaqtaqa nym sutichasqaqa michaymi, chaytaq kaypi qillqasqa kachkan. API k'uyachakkuna hash nisqapi tupuchkaku, manam k'umichiy kasqachu, sutinkunawan, aswan chikit'a qatipaywan, qullqi ruraypa mapiwan, kutimuy pachawan, tukuy pachawan, hinaspa imaynan rurasqa kasqanwan hinaspa cutiñan usuchasqa kasqanwan; aswan musuq chinkachisqa 50 k'umichiykunallam qhepakunku. Huk allin pacha qullqi churanapaq wallet nisqapi kawsayqa killkachasqa kachkan, nisqanpa pacha, qaytu nisqanwan, chaymanta qallariy nisqanpa t'uqasqanwan. Video chambaykunaqa 24 p'unchaymanta qhipakun. Pagasqa kawsaykunaqa Lightning payment hash nisqata pacha 7 hunt'aq p'unchaymanta qhipan hinallataq hashed refund token nisqata 30 p'unchaymanta qhipan, mana imataq riqsisqachu. Kawsay mana chayta qapayta atisqanqa pawasqa kachkan, qallariy nisqawan pagakunaqtaq qhipakun.
  • App nisqata qarpuyqa pakasqachusmi. A llikhay k'anchayta API key nisqata tukuyta qichuyta chaninchin, hinaspa tapukuypaq riqsisqata, llikllaykunata, qullqi qhapaqkunata hinaspa video llank'aykunatapas qichun. Qullqi k'anchay hinaspa allin kananchikpaq rantiqkunapas nympi kashan.
  • Modelo ispaktuqqa qhawaykun qantaq ruranaykikita, chayqa app nisqamanta kashan hina. Catalog ruraykunata rurawaqkunapi rurin; standard ñankuna imasqa embedding-kuna paspas Cloudflare nisqapi rurin.
  • Yachay rurana mediaqa llapa runapaqmi. Llaqtapiqa links hina apachasqa sumaq ñawinchaykuna imaymana videokunapas Blossom public file hosts nisqaman churakusqa kashan, chaypiqa huk filepa pachaqa paypa hashninmi. Link nisqata qarqusqa runapas payta qallarin, Nymbotqa manañataq payta qicharinmanchu. Tapuy... b64_json hinataq tukuy rurasqa rikchaymi kutimun kutiypi, chayqa manañam upachikunichu.
  • Chayqa, qantaq qillqasqaykichikqa huk ruranaq kananchu. Huk rikchayta qhapaqta qhichwa ruraypi upallayki allichay, ichayari qhepachiy chay hina data: Generator nisqapaq URL ninkun image_url, public Blossom host nisqamanmi qallariypaq upanchakun, chaynapim paqariyasunqanmi maskhaykun, chaymantapas chaymi kachkan. Tukuyta qillqasqa uñaypi kachkan https:// Link chay link hina apakuy. Chat nisqapi rikchaykuna model-pa qucquyqanmanmi richkan, Blossom-manqa manam.
  • Huk killa nym-ykiman t'inkuypaqmi. Llapa imaymana llavewan ruraymi nym-yki p'akisqa rurarqan, chayraykun API nisqata kamachiyqa manam imaymana kachkasqaChayqa, manan hap'iq kanchu imaynatas qhali kachkanqa imaynatas qispichisqa nym-ykiwan, chayrayku API nisqata usqhayta ruranaykipaq, keys-kunata huk wata nym-manta ruray, chay nym-paqmi huk kutun balance kachun.

Aplicacionkunapa waqaychaynin munankichus, aplicacionkunata usachiy. APIqa modelokunata qanpaq llamkanqkuna ukhupi usachayta munankichu pachaqa.

Imaymana tukuy pacha tukuyta

Tukuypaq chay ukhu p'unchayImatam ruranRiqsinakuy
GET /api/v1/modelsModelkunata qillqan, hukkuna chawpinwanMana pipas
POST /api/v1/chat/completionsChaykunata TukuyK'imi
POST /api/v1/responsesTukuykunapa kutichikunankuna APIK'imi
POST /api/v1/messagesAnthropic WillaykunaK'imi
POST /api/v1/messages/count_tokensYupaychaykunapas rantiykunapasK'imi
POST /api/v1/images/generationsLlikanakunata paqarichinLlave ima Illapa
POST /api/v1/images/editsÑawpaqta k'umuykunata allichanLlave ima Illapa
POST /api/v1/videos, GET /api/v1/videos, GET /api/v1/videos/{id}Qallariy, qillqaywan ruraykunatahinmi qillqaykunatahinmi videokunatahinmi riqsinkiKilla, chaymantaq Illapa hukta qallarinanpaq
POST /api/v1/audio/speechRimayta qillqasqamanta uyariy munaq kayLlave ima Illapa
GET /api/v1/audio/models, GET /api/v1/audio/voicesAudio modelo-kuna imaymanaykunapasMana pipas
POST /api/v1/audio/transcriptions, POST /api/v1/audio/translationsRimaykunata qillqayman, hinaspa Inglés simimanLlave ima Illapa
POST /api/v1/embeddingsKaypi kachkan riqsisqa kawsayniyuq ukhu ukhuypaqmiLlave ima Illapa
GET /api/v1/credits/balance (mana POST)Iskaynin qhipankunaK'imi
GET /api/v1/topup/payment-methodsPakiypaq ñanMana pipas
POST /api/v1/topup/create/btc-lightningLightning qelqayK'imi
GET /api/v1/topup/status/{invoice_id}Kaychayta hinataq chayachin.K'imi
GET /api/v1/queries/historyHuk-huk rimanakuy imataq qarqan?Kallpa imarayku nymchu
GET /api/v1/accountQhapaq sunquypaq willakuykunamNym
/api/v1/keysLlavekunata ruran, muspan, chinkachinpas.Nym
/api/v1/nwc-auto-topupQayna kachaykunaNym
GET /api/v1/l402/refunds, POST /api/v1/l402/refunds/redeemQullqi kachisqayta icha kutichisqayta qillqasqata riqsinanpaq oqharinanpaqQullqi kutichiy tukuy; nym tukuyta maskanapaq

"Nym" ninmi Nostr ki-yki-wan qillqasqa su'yachiy, kaypi rimaykusqa qillqasqaykichik account yanapakuypaq tukuykunata. Kay imaymana rimaykunataqa riqsiq lliwtakuymi, qaymanta riqsimuy: llamk'anaqunaqkuna imaymana SDK-kunawanpas, hinaspa Claude Code, Codex chaywan Cline hina kachaq munasqakunapaq, rikuriy Programay llamkayninakuna.