Aqbeż għall-kontenut
Lura għal Nymbot

Bażi ta 'għarfien Żviluppaturi

Taħdiss tal-API

Il-modelli, il-ġeneraturi u l-ibvilupp fuq xogħol li tuża fl-app, mill-kodiċi tiegħek stess. Il- API jitkellem fil-formatijiet OpenAI u Anthropic, għalhekk la maggioranza tal-għodod u SDKs jaħdmu billi tbiddel URL bażi u chiave.

X'inhu l-API

An HTTP API fuq nymbot.ai li jwieġeb l-istess talba li klijent ta' OpenAI jew Anthropic juża diġà. Inti tikseb:

Il-ħlas qed jiġi mitlaq mill-istess tnejn bilanci bħall-app, bi l-istess prezzijiet. M'hemm l-ebda सब्सkripsjoni u l-ebda allokazzjoni gratis fuq l-API: kull talba hija mixtrata b'krediti li xtaqqajt.

Dak li l-API ma jagħmilx huwa li jżid xejn mill-parti ta' Nymbot stess. Il-messaġġi tiegħek imorru għall-mudell kif xtaqqithom: l-ebda prompt tas-sistema ta' Nymbot, l-ebda memorja, l-ebda suġġerimenti ta' data jew lingwa. Dak li jerġa' jmorri huwa l-risposta tal-mudell u nota ta' kemm kosta.

URLs ta' Bażi

UżaURL tal-Bażi
SDKs tal-OpenAI u għoddan kompatibbli mal-OpenAIhttps://nymbot.ai/api/v1
SDKs ta' Anthropic u Claude Codehttps://nymbot.ai/api (l-SDK iżid /v1/messages stessu)

Kull endpoint jinsab taħt /api/v1/Triq mhux magħrufa tirritorna 404 u path magħruf imsejjaħ bil-metodu l-𝗶ġġuriet jirritorna 405, it-tnejn bħala JSON.

L-API twieġeb mistieba cross-origin minn kull sit, għalhekk paġna tal-browser tista' tepċiha. Iżda, kull şey li tibgħat għal browser tista' tinqara minn kull min jiftaħha, għalhekk agħmel dan biss b'ċwieċella li għandha limitazzjoni żgħira kapL-endpoints imsignati bil-nym tiegħek (keys, it-sommarju tal-kont, l-auto-top-up tal-NWC u r-redemption tal-refund) huma l-esċezjoni: f'browser huma jirrispondu biss għas-sitijiet proprji ta' Nymbot. Xoff taħsig tal-joni tal-akkunttijiet.

Ibgħat kull JSON body b' Content-Type: application/json. Kull tip ieħor jiġi rifiżat b' 415, maka fformularju HTML sempliċi jew 🙃 text/plain talba minn sit ieħor ma jistax jilħaq l-API. B'ċURL, passa -H "Content-Type: application/json" flimkien ma -d.

Keys tal-API

Il-klaviijiet huma magħmula fl-app. Iftaħ API fil-sidebar tal-app tal-web, jew fil- menù fuq Android u iOS, u tgħaqqab Tħoliq ta' klaviĠżejjituha b'isem u, jekk tixtaq, kap u data ta' skadenza.

Il-klavijiet tidher darba biss. Kopjaha f'post sigur qabel ma tagħlaq il-folja: Nymbot iżomm biss fingerprint tagħha, għalhekk ma tista' turiha lil kif għaliqha. Klavijiet mitluba ma jistgħu jinstabux; revokaha u agħmel oħra.

Fenkata tidher bħal sk-nymbot- dejta segwita minn 43 ittra, numri, dażijiet u underscores. L-app lista kull klavijiet bl-isem tagħhom u suġġeriment qasir bħal sk-nymbot-Qm7x…c2Lw.

  • Ċav le jappartieni lill-nym tiegħek. Huwa juża l-ibdal tiegħek, u biss in-nym tiegħek jista' jagħmel, ibiddel jew jiddeċiedi għalih. Kullox li għandu l-klavijiet jista' juża bil tiegħu, għalheku ittrattah bħala password.
  • Il-caps qegħdin fis-sats. Il-klavijiet jistgħandhom ikollhom limit ta' spese, u l-limit jista' jiġi riċċetta kull jum, kull వార (L-Etna) jew kull xahar (l-ewwel), às 00:00 UTC. Huwa jikkalkula Żewġ bażi, kreditu standard bħala 10 sats u kreditu Pro bħala 100, quindi Dan jibni l-istess ir-riżultat inkluż kemm jkun il-bażi li telfu r-requistjoni. Qabel ma r-requistjoni timxi, l-aktar li tista' tikostja (immaffuta għal krediti sħiħi) tiġi ssetgħa kontra dak li għadu baqi mill-limit. Jekk ma tiffittrax, ir-requistjoni tiġi rifiċuta b' 403 key_limit_reached, anke jekk il- risposta kienet se tiġi taħt il-limit; l-errore jgħid kemm għadu baqi u meta l-limit jirissetta. Innersar max_tokens itnahetta dak il-każ l-aktar terbbuħ. Ritruv tal-ħlas jiġi ċċarġat bi dak li kkostaw fil-fatt u dan jinqasas mill-limitu, għalhekk jekk il-fornitur jirrapporta aktar tokens minn dawk li kienu maħsieba, l-aħħar ritruv liffiċja jista' jieħu l-klavijiet ftit oqreb mill-limitu tiegħu; ir-ritruv li jmiss dinhar jiġi rifjutat.
  • Kap maħsuda biss twaqqaf is-separazzjoni tal-ħlas. Ċav tal-kapaċċini tiegħu still jista' jiċċekkja l- bilanċ, jaqra l-istorju tiegħu, jlietja mudelli, jgħażżel tokens, jibża' u jiċċekkja videw meta ijaqsam wisq.
  • L-iskadenza hija Wara d-data li ħareġt, il-klavijiet tiegħu jieqaf ta' jaħdem.
  • Ir-revoka hija immedjata u finali. Ċaviet revokat iħwievi li r-rigadu tiegħu jfajja. Jidħol fil-lista, immarkat bħala revokat, sabiex l-istorja tal-infaq tiegħu tibqa' tiskriva ħelu.
  • Tista' jkollu sal‐aħħar 25 keys attiv, kull wieħ b'isimu stess. Il-bidla fil-periyodu ta' reset ta' kisi tbda periyodu ġdid minn zero.

Il-istess folja turi l-infirmar ta' kull klavijiet f'dan il-periodu u totalment, meta kienet muta l-aħħar darba, iż-żewġ saldi tiegħek, u r-requisiti API reċenti tiegħek. L-endpoints waraha huma dokumentati taħt ġestjoni tal-klaviets.

Awtentikazzjoni ta' talba

Ibgħat il-klavijiet f'xi waħda minn dawn il-headers. Huma ekwali, għalhekk uża kwalunkwe li l-klijent tiegħek ibgħat b'mod awtomatiku:

KapitalSent minn
Authorization: Bearer sk-nymbot-…OpenAI SDKs, l-aktar għodod, Claude Code ma' ANTHROPIC_AUTH_TOKEN
x-api-key: sk-nymbot-…SDKs ta' Anthropic
api-key: sk-nymbot-…Klijenti b'stil Azure

Ċewġ, mhux magħruf, revokat jew skadut jirritorna 401, bil-kodiċi missing_api_key, invalid_api_key, revoked_api_key jew expired_api_keyIl-lista tal-modelli, il-modelli tal-awdjo u l-vuċċi, u l-metodi ta' pagament ma teħtieġ nothing key.

Ritratti, videw, diskors, transkrizzjoni u embeddings jistgħu wkoll jiġu mħalsuş għal każ-każ fuq Lightning mingħajr l-ebda klavijiet: ibgħat ir-requiest mingħajr wieħed u ħallas l-fattura fil- 402 tweġib. Xogħol ħlas għal kull talba mingħajr ċwieċ.

Il-ġestjoni tal-klavi, is-sommarju tal-kont u t-top-ups awtomatiċi huma l-istess eċċezzjoni: they jieħdu sigatura mill-nym tiegħek minflok klavi, għalhekk klavi li ntabbaħ ma tista'xxepp ma twieleġ ebda klavi oħra. Tara taħsig tal-joni tal-akkunttijiet.

Ir-rigwiż tiegħek l-ewwel

Put il-klavijiet f'varjabbli ambjentali, imbagħad istaqsi mudell xi ħaġa. L-eżempji minnufih dawn il-paġni jaqrawha minn 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 huwa r-routing proprju ta' Nymbot, ippagħata mill-bażi tal-livell standard. Put an id tal-mudell tal-katalogu hemm, bħal anthropic/claude-sonnet-5, biex tuża dawk il-mudell mill-balanċ Pro. Lista tal-modelli jagħti kull ID.

Kemm iħkost talqauda waħda

L-API taċċipja l-fatturi eżattament kif tagħmel l-app.

  • Liema bilanċ. nymbot/auto iqspent il- standard bilanċ (10 sats u kredit). Kull mudell ta' chat ieħor iqatta' l- Pro bilanċ (100 sats kreditu). Il-ġeneratur tal-immaġni standard u l- ħarfiena tal-leħen standard jusejnu krediti standard; kull ġeneratur ieħor juża Pro. L-Embeddings jużaw krediti standard. It-Transkrizzjoni tuża krediti standard meta l-bilanċ standard jista' jikkoveriha, u krediti Pro otherwise. Il-lista tal-modelli tgħid liema bilanċ kull mudell juża.
  • Kemm? Il-chat request huwa ikalkulat fuq it-tokens li l-mudell qalaq u kiteb, fuq ir-rati mapplikati mill-fornitur. Dak il-prezz għandu fee ta' 5% miżjat u mbagħad jiġi mmultiplikat b'1.5, għalhekk tħallas 1.575 ż fois il-prezz tal-lista tal-fornitur. Huwa jiġi konvertit għal sats fuq il-prezz live tal-Bitcoin u jiġi ċċarat f'milja partijiet mill-kreditu. Ritratti pro, video u diskors huma prezzati għal kull ġenerazzjoni, għal kull sekonda jew għal kull karakter, u t-transkrizzjoni għal kull sekunda ta' awdyo, b'l-istess fee u margin. Ir-ritratt standard huwa 5 krediti standard fiss u l-leħen standard huwa 3 fiss.
  • Il-minimun. Ħarġa kull talba immetrata li tmexxi tiksiż ít-tlieta mill-inqas 0.05 kredit: nofs sat fuq il-baċċit standard, 5 sats fuq il-Pro. Frazzjonijiet ta' kredit jiġu mġarrra, mhux imġabbbin kull darba.
  • Żomm, imbagħad settla. Qabel ma gira talba, l-akbar ammont li tista' jikkostta jiġi żżomm mill-bażi tiegħek, ibbażat fuq dak li göndert u l-massimum ta' tokens li tista' tikteb. It-test barra mill-plain ASCII huwa miżen fuq il-bytes UTF-8 tiegħu, u d-difiċit u l-punteggjazzjoni ASCII każda kontaw bħala token wieħed, għalhekk it-test f'sistemi ta' skriptiijiet kullwiegħed, kodiċi u numri huma żżommom għal kollox. Il-qbid huwa f' krediti sħiħi, mill-inqas wieħed, għalhekk kull talba teħtieġ mill-inqas 10 sats ħielsa fuq il-bażi standard jew 100 sats fuq Pro biex tibda. Solamente l-kost attwali jiġi ċċarġat; il-bqija jiġi rilassat meta tispiċċa. Talba twiega żżomm il-qbid tagħha għall-konsegwenza li tkun qed tiġri; jekk il-krediti mażżomom jieppu disponibbli għal xi raġuni oħra, stream jieqaf b'a 402 insufficient_balance avvent ta' żball, u dak li ġie ġenerat huwa ċċarġat. Jekk il-kost attwali huwa aktar minn quello li l-bażi tista' tħallas, il-bażi kollha tieħu, il-bqija tkun dovuta (owed_sats fil- nymbot oġġett, u bilanċ negattiv). Dak li jkun dovut jiġi pajat l-ewwel mill-krediti li jkunw għadhom jaslu għal dak il-bilanċ. Sakemm ma jiġišx pajat, xejn fuq dak il- bilanċ ma jistax jiġi spese: lanqas mill-API, risposti fl-app, trasfert jew rigal.
  • M'hemmx kreditu biżżejjed. Jekk il-bażi ma tistaxx cover il-hold, id-talba tiġi رفض b' 402 qabel ma r-run jidħol. L-error jgħid li liema bilanċ huwa naqs, kemm sats jeħtieġ il-requiest u kemm hemm ħielsa. Xi wieħed iżgħar max_tokens tifsid holdiりħs hơn.
  • Fallimenti. Talba li ma taħdimx ma tikollx konsegwenzi, ħlief jekk il-fornitur iċċajja għall-xogħol li għamlet qabel ma tfaċċja l-ħnien, jew tfriġa fuq il-web jew il- nymbot/auto task ċekk ifaħdt; imbagħad dak hu li tħallas, mill-inqas 0.05 credit. Stream li tnaqqas ti ħallas għall-tokens li r-rapporta l-fornitur: Nymbot ikompli jaqra l-stream tal-fornitur għal saħħa ta' 25 sekundiet wara li titlaq biex iġib dik il-kontanza. Jekk ma tasalx, il-charge jiġi stimat mill-post li lestijiet u dak li kien miktub, u għal mudell li jagħmel reżonament jinkludi l-limitu kollu tal-output tal-hold. Request li tinstab tieqaf il-konnessjoni tagħha għadu jtemm u jiġi ċċarġat.
  • Ispazju tal-web ikostja $0.008 għal kull ħarċa, konvertita għal sats, kull meta ħarċa ġiet imdejja, kemm jekk il-mudell iwieġeb jew joffri l-ebda risposta. Il-paġni li jaqra huma wkoll imkejja lill- mudell bħala input, għalhekk huma jżiddu l-tokens tagħhom.

Mhux kull risposta tgħid x'kienet il-kostijiet tagħha. Risposti JSON iġġibu a nymbot oġġett b' l-osservazzjoni li nħallset minnha, l-prezz f'krediti u sats, u x'hemm fuqha:

L-oġġett tal-kost

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

Risponsijiet maħsubs ġġorbu wkoll dawn il-headers, li hija fe trid tfittex il-kost ta' rispons li mhux JSON, bħal diskors:

KapitalMeaning
X-Nymbot-Cost-SatsKemm iħallas din ir-requesta, fis-sats.
X-Nymbot-Balance-SatsKemm għandek f'resto fuq il-balanċ li npayat minnu, fis-sats.
X-Request-IdID għall-joni tal-joni, fuq kull risposta. Iċcitaha jekk tkontattja l-appoġġ.

Ir-rati għal kull miljun token, li huma ewlement inklużi l-ħarfien u l-margini, huma fil- lista tal-modelli f'dollars u sats, u fuq il-lista tal-prezzijiet. Jekk il-prezz tal-Bitcoin ma jistax jitqara, talbija magħdija tirritorna 503 price_unavailable ma' Retry-After: 60 minflok ma tgħammel tqatta' ġesti.

Erruri

Ħarba kull żball għandu l-istess x Malta, dak li l-klijenti ta' OpenAI jużaw wisq. code huwa isem stabbli li tista' tużah biex timmatchja; message hu għal nies u jista' jinbidel.

Body tal-error

{
  "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
  }
}
StatusMeta
400 invalid_request_errorIl-body mhux JSON validu (invalid_json), kamp fejmpjat huwa nież 부족 (missing_required_parameter), valur huwa ħażin, jew it-talba titlob xi ħaġa li l-mudell jew l-endpoint ma jagħmilux, bħal għodod imdaqqa nymbot/auto (unsupported_tool). param isem il-qasam. Ukoll upstream_rejected meta l-fornitur irrifjuta t-talba.
401 authentication_errorIl-klavijiet mhux preżenti, mhux magħrufa, revokati jew skaduti, jew talba imxemmla mhux validi jew riużata.
402 insufficient_quotaIl-bażi ma tista'x cover it-talba. Code insufficient_balance, b' balance, required_sats u balance_sats.
403 permission_errorId-talba ma taqgax fil-kapa tal-klavixxura (key_limit_reached, b' limit_sats, used_sats u reset_at), jew l-account jista' ma jużawax is-servizz (account_denied).
404 not_found_errorTriq mhux magħrufa (unknown_endpoint), mudell li ma jkunxxistenti (model_not_found), jew klavijiet mhux magħrufa, fattura jew videw.
405Il-path jesisti imma mhux b'dak il-metodu (method_not_allowed). Il- Allow il-header jiddindikkar il-metodi li jieħu.
413Il-body jew il-fajl huwa żgħir wisq (payload_too_large, file_too_large), jew reġistrazzjoni hija tul wisq (audio_too_long). Tara limiti.
415 invalid_request_errorIl-ġisem ma jiġiex sentri bħala application/json (jew, għall-endpoints tal-upload, multipart/form-data): unsupported_media_type.
422Leħen u lingwaġġ li ma sejrinx flimkien f'test għal leħen (voice_language_mismatch, unsupported_language).
429 rate_limit_errorSiti tal-kotijiet wisq fuq din il-klavijiet, minn dan l-indirizz, jew b'kredenzjali li żammew biex jiġu verifikati (rate_limit_exceeded), jew il-fornitur qed jagħmel rate-limiting (upstream_rate_limited). Waitar is-sekondi f' Retry-After.
500 api_errorŻamm xi ħtul sar minn naħa ta' Nymbot (internal_error).
502 api_errorIl-fornitur ma raddxxax tweġiba (upstream_error), jew ma setgħetx tiġi magħmula fattura ta' Lightning (invoice_unavailable).
503 api_errorIl-fornitur huwa sovrachkantat (upstream_overloaded), l-prezz tal-Bitcoin ma jistax jitqara (price_unavailable), jew parti mis-servizz hija waqfa (service_unavailable, media_hosting_unavailable). Retry-After jgħid meta jipprova mill-ġdid, fejn huwa magħruf.

Żewġ esċezzjonijiet:

  • /api/v1/messages tweġibiet f'format ta' error ta' Anthropic, poiché huwa dak li l-klijenti ta' Anthropic janalizzaw: {"type": "error", "error": {"type": "authentication_error", "message": "…"}}. It-tip issegwi l-status: invalid_request_error, authentication_error, billing_error (402), permission_error, not_found_error, request_too_large, rate_limit_error, api_error jew overloaded_error (503).
  • Riqjesta ta' streaming li tfajjet qabel ma l-ewwel byte tiegħha jiġi rċevut iġġib error JSON ordinarju b' l-istatus fuq, mhux event stream. Ftal wara li l-stream jibda jiġi bagħat bħala l-l-aħħar event tal- stream, fil-format proprju ta' dak l-endpoint.

Ir-rectoli tal-error qatt ma jinkontrazzaw dettalji interni ta' servizzIEħor. L-error proprju ta' fornitur jiġi rippubblikat qabel ma jasal għandek.

Limiti

LimitValur
Talbet għal kull ċav120 kwaċċata fiduċi. Fuq dak, 429 ma' Retry-After.
Talpeti mingħajr ċav120 għal minuta għal kull indirizz, għall-lisings tal-mudell, tal-awdjo u tal-metodu ta' pagament, checks tal-token tal-refund, u endpoints multiplikati mingħajr chiave jew pagament. Fuq dak, 429 ma' Retry-After.
Autentikazzjoni fallita30 għal minuta għal kull indirizz għal keys, signatures, payment credentials u refund tokens li ma jiċċertifikawx. Fuq dak, kull talba mill-indirizz li terbbu credential tirċievi 429 ma' Retry-After sakka' l-minuta tispiċċa. Il-kredenzjali jiġu verifikati qabel ma jinqara' l-body.
Ċwieki ġodda60 skali siegħa għal kull nym u 120 skali siegħa għal kull indirizz.
Fatturi ta' top-up60 skali siegħa għal kull nym u 120 skali siegħa għal kull indirizz.
Konnessjonijiet tal-wallet NWC10 flus fis-siegħda għal kull nym u 30 flus fis-siegħda għal kull indirizz. Il-wallet relay għandu juża wss:// fuq il-port standard.
Refund tokens60 talba kwal minuta għal kull token.
IndirizziL-indirizz IPv6 huwa kontabbiliti bħala l-kollox /64 tiegħu f'kull limit għal kull indirizz, u indirizz IPv6 mappat għal IPv4 bħala l-indirizz IPv4 tiegħu.
Body tal-িanket JSON4 MB; 64 KB għal talbiji imxemmija bil-nym tiegħek.
Body tal-talba multipart (tal-upload)32 MB. Immaġni għat-editjoni tista' tinmaxxi għal 20 MB, fajl tal-awdjo sal-25 MB. Mass importantly 64 partijiet, kull waħda b'mass ta' 8 KB ta' headers tal-parti, u limit ta' 1 għal 70 karakteri; otherwise 400 invalid_multipart.
Ritratti f'rejista ta' chat waħda20. Kull wieħ huwa https:// jew http:// link għal host pubbliku, jew isang data:image/… URL.
Immaġni għal kull talba ta' ġenerazzjoni1 għal 4 (n)
Tokens tal-outputLimitat għall-massimu proprju tal-mudell. Xi akbar max_tokens inqass lejh, mhux irrifjutat.
Input tal-kliem800 karakteri għall-leħen standard, 2,000 għal Aura 2.
Traskrizzjoni30 minuti ta' audio, 25 MB. Rekordazzjoni aktar twila hija rfiduta b' 413 u mhux iċċarġat, anke meta t-tul tagħha jkun magħruf biss malli Whisper ikun semgħuha.
Embeddings100 inputijiet għal kull talba.
Xogħolijiet ta' videwjuMiżżum għal 24 sigħat wara li jiġu sottomettuti; render wieħed jiġi rilegat wara siegħa. Massimu ta' 10 rendering flimkien għal kull nym.
Istorja tal-queryMiħżum għal 90 ġurnata.
Ċavijiet attivi għal nym25. Doċi biss l-aħħar 50 keys revokati jiġu żżommu.

Link għal ritratt għandu jagħti lejn host pubbliku: indirizz fuq netwerk privat jew lokali, jew fuq is-sitijiet stess ta' Nymbot, jiġi rfiżut. Il-pacing tal-fornituri li japplika fl-app japplika hawnhekk ukoll, għalhekk burst ta' reqqiesta lil fornitur wieħed jista' jiġi rallenta minnxijen li jinfaċċja żżmien ta' żmien.

Dak li l-API tista' tara

L-API mhux privata bħal kif huma l-applikazzjonijiet, u worth li tkun eżatt dwar kif.

  • Mhuwiex enkriptat minn estrem għal estrem. Fl-applikazzjonijiet, messaġġ huwa sigillat fuq l-apparat tiegħek b'klaviżijiet li biss Nymbot iżżommu u jivvjaġġa bħala bwraping rigal. Request tal-API huwa HTTPS ordinarju: huwa encrypted fit-triq lejn Nymbot, u s-server ta' Nymbot jaqrah b'test açık biex jifhdimh.
  • Prompts u rispondi mhumiex maħżuna. Huma jgħaddu through għall-mudell u l- tweġiba tgħaddi lura. Dak li jiġi żżomm huwa l-fattura: għal kull talba l-ħin, il-mudell, it-tip, l-għadd tat-tokens, il-kost, il-bażi, il-klavijiet u jekk suksess iva, għal 90 jum, li huwa x'e tal-istorja tal-istampa jurik. Rekord tal-użu tal-istess talba (ħin, tip, mudell, kontijiet tat-token, prezz, durata u jekk uża x search fuq il-web jew suksess) huważ ugliż miżmum għal 90 ijjem, flimkien ma' dak tal-app stess.
  • Kollox l-oħra li żomm għal nym huwa żgħir u huwa rlistat hawn. Keys tal-API jitżammu bħala hash, qatt mhux il-key, b' isemhom, ħhint qasir, limit tal-ħarsiexa, perjodu ta' reset, skadenza u meta saru u l-aħħar darba użaw; biss l-aħħar 50 keys li nkablu jiġu żżammija. An top-up awtomatiku il-konnessjoni tal-wallet hija mistokja enkriptata, b'il-threshold tiegħu, l-ammont u r-riżultat tal-aħħar top-up. L-impjiegi tal-vidjow huma miżmumin għal 24 sigħa. Nirazzjonijiet maħqudin għal kull sejħa jħallu biss hash ta' pagament Lightning għal 7 ijiem u token ta' refund hashed għal 30 ijiem, ma jkunx marbut ma' n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n ника n
  • Meta tmeħxa l-app, tmeħha wkoll. A tħassir tad-device jirrevoka u jiddelite kull API key, u jiddelita l-istorik tal-query, ir-rekords tal-użu, il-konnessjoni tal-wallet u l-xogħolijiet tal-vidjow. Il-bażi u kwalunkwe ħlas li għadu jkun dovut jibqgħu fuq in-nym.
  • Il-fornitur tal-mudell jara r-requesta tiegħek, kif tagħmel mill-app. Modelli tal-katalog ġewwa l-makers tagħhom; rotte standard u embeddings jiġu iffurmati fuq Cloudflare.
  • Il-media generat huwa pubbliku. Ir-ritratti u l-vidjows ipprovduti bħala links huma imniet fuq host ta' files pubbliċi ta' Blossom, fejn l-indirizz ta' file huwa l-hash tiegħu. Kullox ma għandu l- link jista' jiftaħu, u Nymbot ma jistax jneħħih mill-ġdid. Istaqsi għal b64_json u r- ritratt ġenerat jiġi lura fir-risposta u qatt ma jitgħallef.
  • Għalhekk, ir-ritratti li tagħti huma generator? Immaġni li tniżżel fuq edit, jew ibgħat bħala a data: URL f' ġeneratur ta' image_url, jiġi ttajata fuq host pubbliku ta' Blossom l-ewwel sabiex il-ġeneratur ikun jista' jġibha, u l-istess japplika għalih. Ritr bagħat minn https:// il-link jiġi passa 'l quddiem bħala dak il-link. Il-foto f'talba ta' chat imorru għand il-fornitur tal-mudell, mhux għand Blossom.
  • Ċwieċa hija marbuta mal-nym tiegħek. Kollox li tużah chiave jiġi nqas minn l-assi tal-nym tiegħek, għalhe Rez, l-użu tal-API mhux anonymus. Jekk trid li l-API jkun separat mill-nym tädijewwa, agħmel il-klavi minn nym separat b'bilanċ proprju.

Jekk għandek bżonn il-protezzjoni tal-apps, uża l-apps. L-API huwa għal meta għandek bżonn il-modelli f'l-għodod tiegħek stess.

Mhux kull endpoint

EndpointX'tagħmelAwtorizzazzjoni
GET /api/v1/modelsLista tal-modelli, b'prezzijietNone
POST /api/v1/chat/completionsChat CompletionsĊwiev</li>
POST /api/v1/responsesAPI tal-RisponsijietĊwiev</li>
POST /api/v1/messagesMessaġġi ta' AnthropicĊwiev</li>
POST /api/v1/messages/count_tokensStima tal-tokens tal-inputĊwiev</li>
POST /api/v1/images/generationsĠenera immaġniĊwievka jew Mili
POST /api/v1/images/editsEditra immaġniĊwievka jew Mili
POST /api/v1/videos, GET /api/v1/videos, GET /api/v1/videos/{id}Bidu, listi u checks ta' vidjowsĊavet, jew Mili biex tibda wieħed
POST /api/v1/audio/speechTest għal leħenĊwievka jew Mili
GET /api/v1/audio/models, GET /api/v1/audio/voicesModelli tal-awdjo u vuċiNone
POST /api/v1/audio/transcriptions, POST /api/v1/audio/translationsMixi l-kliem għal test, u għall-IngliżĊwievka jew Mili
POST /api/v1/embeddingsEmbeddingsĊwievka jew Mili
GET /api/v1/credits/balance (jew POST)It-tnejn saldiĊwiev</li>
GET /api/v1/topup/payment-methodsModi kif tħallasNone
POST /api/v1/topup/create/btc-lightningFattura LightningĊwiev</li>
GET /api/v1/topup/status/{invoice_id}Iċċekkja u jiddebitahĊwiev</li>
GET /api/v1/queries/historyKemm jikkostja kull talbaĊwiek jew nym
GET /api/v1/accountSommarju tal-kontNym
/api/v1/keysJipproduċi, ibiddel u jneħħi l-klavi sabħorNym
/api/v1/nwc-auto-topupTop-ups awtomatiċiNym
GET /api/v1/l402/refunds, POST /api/v1/l402/refunds/redeemIċċekkja jew iċċiedi token ta' rimborzuToken ta' rimborsu; nym biex jiġi rredimiet

Nym" tfisser talba imxemmija mill-klavijiet Nostr tiegħek, deskritta f taħsig tal-joni tal-akkunttijiet. Għal għodod li diġà jitkellmu dawn il-formatijiet, xogħol fuq taħdima u SDKs, u għal aġenti tal-kodifikazzjoni bħal Claude Code, Codex u Cline, xogħol fuq taħtim tal-kodifikazzjoni.