सामग्रीं प्रति गच्छन्तु
Back to Nymbot

ज्ञानाधारः विकासकाः।

ए पी ऐ अवलोकनं

भवान् आप्-मध्ये उपयुज्यमानानि माडेल्स्, जनरेटर्स्, ब्यालेन्स् च स्वस्य कोड्-द्वारा उपयुज्यते। ए. पि. ऐ. ओपन्-ए. ऐ. तथा एन्थ्रोपिक्-स्वरूपं वदति, अतः अधिकांशाः टूल्स् तथा एस्. डी. के. इत्येते बेस्-यू. आर्. एल्. तथा की च परिवर्त्य कार्यं कुर्वन्ति।

ए. पि. ऐ. किम् अस्ति?

एकः HTTP API उपरि nymbot.ai यः ओपन् ए. ए. ऐ. अथवा एन्थ्रोपिक् ग्राहकः पूर्वमेव प्रेषितान् एव अनुरोधान् प्रत्युत्तरं ददति। भवन्तः प्राप्नुयुः।

तयोः उभयोः एव सा प्रदास्यते। सन्तुलनानि एप्-रूपेण, समानमूल्येषु। ए. पि. ऐ. इत्यत्र न सदस्यता अस्ति, न निःशुल्कः भत्ताः अस्ति, प्रत्येकं याचना भवतः क्रीडितात् क्रेडिट्-द्वारा दीयते।

What the API does not do is add anything of Nymbot's own. Your messages go to the model as you sent them: no Nymbot system prompt, no memory, no date or language hints. What comes back is the model's answer and a note of what it cost.

मूल URL-नामानि

उपयोगः करोतु।आधार-यू. आर्. एल्.
OpenAI SDKs तथा OpenAI-अनुकूलतयाः साधनानिhttps://nymbot.ai/api/v1
Anthropic SDKs च क्लौड् कोड्https://nymbot.ai/api (एस्. डी. के. योजयति। /v1/messages स्वयमेव)

प्रत्येकं अन्तिमबिन्दुः अधः जीवति। /api/v1/अज्ञातमार्गः प्रत्यावर्तते। 404 तथा एकः ज्ञातः मार्गः यः अशुद्ध-विध्या आहूतः भवति सः प्रतिफलति 405, उभयम् अपि JSON रूपेण।

एषा API अन्यैः सर्वैः स्थानेभ्यः cross-origin requests इति प्रेषितैः उत्तरं ददाति, अतः ब्राउज़र-पृष्ठं (browser page) एतत् आह्वयितुं शक्नोति। तथापि, यत् किमपि त्वं ब्राउज़र-मध्ये प्रेषयसि, तत् यः अपि तं उद्घाटयति सः पठितुं शक्नोति, अतः केवलम् एतदेव तस्मिन् कुञ्जेन कुरुयत् यस्य अधिकारः न्यूनः। केप्. The endpoints signed with your nym (keys, the account summary, NWC auto-top-up and refund redemption) are the exception: in a browser they answer only Nymbot's own sites. See खाताअनुरोधनां हस्ताक्षरम्.

प्रत्येकं JSON body सह प्रेषयतु Content-Type: application/jsonअन्यः कश्चन प्रकारः निषिद्धः भवति 415, अतः एकः सामान्यः HTML रूपः वा text/plain अन्येनात्मनः स्थलेन अनुरोधः APIं प्राप्तुं न शक्नोति। cURL इत्यनेन, प्रेषयतु -H "Content-Type: application/json" सहैव -d.

ए. पि. ऐ. कुञ्जीः

आप्-मध्ये चाबिः निर्मीयन्ते। उद्घाटयतु। ए. पि. ऐ. वेब्-आप् इत्यस्य पार्श्वपट्टिकायां, अथ वा एण्ड्रोयिड् तथा ऐ. ओ. एस्. इत्येतयोः सूचीषु, ट्याप् कुर्वन्तु। की इतीदं निर्मातु।तस्य नाम निर्दिशतु, यदि भवान् इच्छति तर्हि क्याप्, समाप्ति-दिनाङ्कः च दीयन्तु।

The key is shown once. Copy it somewhere safe before you close the sheet: Nymbot keeps only a fingerprint of it, so it cannot show it to you again. A lost key cannot be recovered; revoke it and make another.

कुञ्चिका इव दृश्यते sk-nymbot- तदनन्तरं 43 अक्षराणि, अङ्कानि, डैशस्, अण्डर्स्कोर्स् च भवन्ति। आप्-मध्ये प्रत्येकं की इत्यस्य नाम, लघु-सङ्केतः च दीयते यथा - sk-nymbot-Qm7x…c2Lw.

  • एकः कुञ्जी तव नाम्ना सह संबद्धः अस्ति। एतत् भवतः शेषं व्ययति, केवलं भवतः निम् एव तत् निर्मातुं, परिवर्तयितुं वा निरस्तुं वा शक्नोति। यः कश्चित् चाबि धरति सः तेन सह व्ययं कर्तुं शक्नोति, अतः तत् कूटशब्दम् इव आचरतु।
  • केप्स् इतीमानि स्याट्स् मध्ये सन्ति। एकस्मिन् की इत्यस्य व्ययपरिमितिः भवितुम् अर्हति, तथा च प्रतिदिनं, प्रतिसप्ताहं (सोमवासरं) अथवा प्रतिमासं (प्रथमं), 00:00 यू. टी. सी. इत्यत्र, परिमितिः पुनः निर्धारिता भवितुम् अर्हति। एतत् उभयोः शेषान् गणयति, 10 स्याट्स् इति मानक-क्रेडिट्, तथा प्रो-क्रेडिट् च 100 इति गण्यते, अतः तस्य अर्थः यः अनुरोधः व्ययते सः एव शेषः इति। अनुरोधस्य चालनात् पूर्वं, तस्य अधिकतमं मूल्यं (सम्पूर्ण-क्रेडिट्स् पर्यन्तं पूर्णं), परिमितेः अवशिष्टस्य विरुद्धं निर्धारितं भवति। यदि तत् न उपयुक्तं भवति तर्हि अनुरोधः निराकृतः भवति। 403 key_limit_reached, यद्यपि उत्तरं सीमायाः अन्तः आगमिष्यत्; त्रुटिः कथयति किञ्चित् अवशिष्टम् अस्ति तथा च सीमा कदा पुनः प्रस्थाप्यते इति। न्यूनकरोति... max_tokens तस्मात् महत्तमं संकटं न्यूनं भवति। अनुरोधस्य शुल्कं तस्य वास्तविकलाभात् ग्रहीयते यत् सीमायाः विरुद्धं गण्यते, अतः यदि प्रदाता अधिकान् टोकन् गणयति ये केनचित् आरक्षितान् टोकन् अपि, तर्हि अन्तिमः अनुरोधः यः समाहितः अभवत्, सः कुञ्जीं सीमातः किञ्चित् अधिकं गन्तुं शक्नोति; ततः परं अन्यः अनुरोधः न स्वीक्रियते।
  • व्ययस्य परिमितिः केवलं व्ययं स्थगयति। तस्य शिरस्त्राणे एकं की इदानीमपि शेषस्य परीक्षणं कर्तुं शक्नोति, तस्य इतिहासं पठितुं शक्नोति, प्रतिरूपाणां सूचीं कर्तुं शक्नोति, टोकन्-गणनां कर्तुं शक्नोति, टाप्-अप् कर्तुं शक्नोति तथा च पूर्वमेव आरभत वीडियो इत्यस्य निरीक्षणं कर्तुं शक्नोति।
  • समाप्तिः वैकल्पिका अस्ति। त्वया निर्धारितः दिनाङ्कः अनन्तरं कुञ्जी कार्यं न करोति।
  • रक्षणं तात्कालिकं अन्तिमं च अस्ति। रद्दकथिता कुञ्जी तस्याः आगामिन्याः अनयाः अभ्यर्थनायाः विफलह्यु भवति। सा सूचीयां रद्दकथिता इति चिह्निता तिष्ठति, येन तस्याः व्ययइतिहासः अद्यापि तर्कसंगतः भवति।
  • भवतः समीपे 25 यावत् सक्रिय-की-विशेषाः भवेयुः, प्रत्येकस्य स्वकीयं नाम स्यात्। की-इत्यस्य पुनःनिर्धारण-कालस्य परिवर्तनेन शून्ये नूतनः कालः आरभ्यते।

समानं पत्रकं प्रत्येकस्य की इत्यस्य व्ययस्य अस्मिन् कालावधिं दर्शयति तथा च समग्रतया, यदा तस्य अन्तिमप्रयोगः कृतः, भवतः शेषराशिः, भवतः सद्यः एव कृतानि ए. पि. ऐ. निवेदनानि च दर्शयति। तस्य पृष्ठे विद्यमानानि अन्तिमबिन्दुः अधः अभिलेखितानि सन्ति। कुञ्जीनां प्रबन्धनं करोतु।.

अनुरोधस्य प्रमाणनं कुर्वन् अस्ति।

एतेषु कस्मिन् अपि शीर्षके की प्रेषयतु। तानि समानानि सन्ति, अतः भवतः ग्राहकः पूर्वनिर्धारितरूपेण यत् प्रेषयति तस्य उपयोगः करोतु।

शीर्षकम्द्वारा प्रेषितम्।
Authorization: Bearer sk-nymbot-…OpenAI SDKs, बहुशालाः अवजाराः, Claude Code सह ANTHROPIC_AUTH_TOKEN
x-api-key: sk-nymbot-…एन्थ्रोपिक् एस्. डि. के. एस्.
api-key: sk-nymbot-…Azure-शैली के ग्राहकौ

अनुपस्थितः, अज्ञातः, निरस्तः अथवा कालातीतः की रिटर्न्स्। 401, कूटलेखनेन सह missing_api_key, invalid_api_key, revoked_api_key अथवा expired_api_keyप्रतिमानानां, श्रव्य-प्रतिमानानां, स्वरानां, देय-पद्धत्यां च सूचीकरणार्थं की इत्यस्य आवश्यकता नास्ति।

चित्रेषु, दृश्यचित्रेषु, भाषणेषु, प्रतिलेखेषु, अन्तर्निर्मितेषु च एकस्मिन् अनुरोधस्य कृते लैट्निङ्ग्-माध्यमेन दातुं शक्यते, यत्र चाबिः सर्वथा न भवन्तिः अनुरोधं विना प्रेषयन्तु, मुद्रापत्रे च शोधनं कुर्वन्तु। 402 प्रत्युत्तरं ददातु। पश्यतु। चाबि विना प्रति-अनुरोधस्य शोधनं करोतु।.

कुञ्जी-प्रबन्धनम्, खात्यानां सारांशः तथा च स्वयमेव धनसञ्चयः अपवादौ सन्ति: ते तव nym इत्यस्य हस्ताक्षरं कुञ्जी-स्थाने स्वीकुर्वन्ति, अतः प्रकटीकृता कुञ्जी नवन्याः कुञ्जीः निर्मातुं न शक्नोति। पश्यतु खाताअनुरोधनां हस्ताक्षरम्.

तव प्रथमः अनुरोधः

कुञ्चिकां परिवेशचरमध्ये स्थापयतु, ततः प्रतिरूपं किमपि पृच्छतु। एतेषु पृष्ठेषु उदाहरणेषु तत् ततःैव पठ्यते। 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 is Nymbot's own routing, paid from the standard balance. Put a catalog model's id there instead, such as anthropic/claude-sonnet-5, प्रो-ब्यालेन्स् इत्यतः तस्य माडेल् इत्यस्य उपयोगं कर्तुं। प्रतिरूपाणां सूचीकरणम्। प्रत्येकं ऐ. डि. ददति।

अनुरोधस्य किं मूल्यं भवति

ए. पि. ऐ. इतीदं यथा प्रकारेण आप् करोति तथैव बिल् करोति।

  • कः सन्तुलनः? nymbot/auto व्ययति। मानकः। शेषः (१० सट्स ऋणम्)। अन्यः प्रत्येकः वार्तालाप-प्रतिरूपः व्ययते प्रो सन्तुलनं (क्रेडिट् प्रति 100 सेट्स्)। मानक-चित्र-जनरेटर् तथा मानक-ध्वनि-व्ययः मानक-क्रेडिट्स्-कृते भवति; प्रत्येकं जनरेटर् प्रो-कृते व्ययः करोति। एम्बेडिङ्ग्स् मानक-क्रेडिट्स्-कृते व्ययः करोति। प्रतिलेखनं मानक-क्रेडिट्स्-कृते व्ययः करोति यदा मानक-शेषं तत् आच्छादयितुं शक्नोति, अन्यथा प्रो-क्रेडिट्स्-कृते व्ययः भवति। प्रतिरूप-सूची सूचयति यत् प्रत्येकं माडेल् व्ययं सन्तुलनं करोति इति।
  • कियत्। यः प्रतिरूपः वस्तुतः पठति, लिखति च तस्य टोकन्-मध्ये वार्तालाप-निवेदनं प्रदायकस्य प्रकाशितमूल्येन मापितं भवति। तस्मिन् मूल्ये 5 प्रतिशतं शुल्कं योजितं भवति, ततः 1.5 गुणितं भवति, अतः भवान् प्रदायकस्य सूचीमूल्यस्य द्विगुणितं ऐ. डि. 1 ददति। तत् प्रत्यक्ष-बिट्कायिन्-मूल्येन स्याट्-रूपेण परिवर्त्यते तथा च क्रेडिट् इत्यस्य सहस्रभागेषु शुल्कं विधते। प्रो-पिक्चर्स्, वीडियो तथा स्पीच् इत्येतयोः मूल्यं प्रतिजननं, प्रति सेकेण्ड अथवा प्रति-अक्षरं भवति, तथा च प्रति सेकेण्ड ध्वनिमुद्रणस्य मूल्यं, समानशुल्केन मार्जिन् इत्यनेन सह भवति। मानकचित्रं समतलं 5 मानक-क्रेडिट्स् भवति तथा मानक-स्वरः समतलं 3 भवति।
  • न्यूनतमम्। प्रत्येकं मीटर्-युक्त-अनुरोधस्य मूल्यं न्यूनातिन्यूनं 0.05 क्रेडिट्-मूल्यं भवति-मानक-शेषे अर्ध-सेट्, प्रो-मध्ये 5 सेट् इति। क्रेडिट्-इत्यस्य अंशानां वहनं भवति, प्रतिसमयः पूर्णरूपेण न भवति।
  • तिष्ठतु, ततः स्थिरीकरणं करोतु। अनुरोधस्य सञ्चालनात् पूर्वं, भवान् यत् प्रेषयति तस्य तथा सः लिखितस्य अधिकतमानां टोकन्-विशेषाणां आधारेण, तस्य अधिकतमं मूल्यं भवतः शेषात् धार्यते। सादा ए. एस्. सि. ऐ. ऐ. तः बहिः लिखितं पत्रं तस्य यू. टि. एफ्.-8 बैट्-तः परिमाणितं भवति, तथा च ए. एस्. सि. ऐ. ऐ. अङ्कान् विरामचिह्नान् च प्रत्येकतः टोकन्-रूपेण गण्यते, अतः कस्मिन् अपि लिप्यां, कोडे, सङ्ख्यासु च पाठं पूर्णरूपेण धार्यते। होल्ड इति सम्पूर्ण-क्रेडिट्-मध्ये भवति, न्यूनातिन्यूनं एकः, अतः कस्यापि अनुरोधस्य आरम्भार्थं मानक-शेषे न्यूनातिन्यूनं 10 स्याट्-मुक्तं वा प्रो-मध्ये 100 स्याट्-मुक्तं वा आवश्यकं भवति। केवलं वास्तविक-व्ययः एव प्रभारितः भवति, अवशिष्टः यदा समाप्तः भवति तदा एव मुक्तः भवति। दीर्घ-अनुरोधः यावत् प्रचलति तावत् कालं यावत् स्वस्य धारणं धारयति; यदि धारितम् क्रेडिट्-विशेषाः कदापि न उपलभ्यन्ते तर्हि प्रवाहः स्थगितः भवति। 402 insufficient_balance दोषपूर्ण घटना, तथा यत् जनितम् तत् शुल्कं देयम्। यदि वास्तविकम् व्ययम् शेषराशिं भुकितुं शक्यं राशिभ्यः अधिकम् अस्ति, तर्हि पूर्णराशिः गृह्यते, शेषः च देयः भवति (owed_sats मध्ये अस्ति। nymbot वस्तु, ऋणात्मक-शेषं च)। यत् ऋणम् अस्ति तत् अग्रिम-क्रेडिट्-मध्ये प्रथमं दत्तं भवति यत् तत् शेषं प्राप्यते। यावत् तत् न दत्तं भवति तावत् तस्य शेषं किमपि न व्ययितुं शक्यतेः न ए. पि. ऐ. द्वारा, आप्-मध्ये प्रत्युत्तरं, स्थानान्तरं वा उपहारं वा।
  • न पर्याप्तं ऋणम्। यदि शेषराशिः धारणं पूरयितुं न शक्नोति तर्हि अनुरोधः निराकृता भवति। 402 सर्वं चलितुं पूर्वम्। त्रुटिः कथयति यत् कः शेषः न्यूनः अस्ति, अनुरोधस्य कति sats आवश्यकताः सन्ति तथा कति मुक्तानि सन्ति। लघुतरः max_tokens लघुतरं धारणं इति अर्थः।
  • असफलताः। यः अनुरोधः असफलः भवति तस्य मूल्यं किमपि न भवति, यावत् प्रदायकः असफलतायाः पूर्वं कृतस्य कार्यस्य शुल्कं न दत्तवान्, अथवा जाल-अन्वेषणं वा न दत्तवान्। nymbot/auto task check had already run; then that is what you pay, at least 0.05 credit. A stream you cut off is charged for the tokens the provider reports: Nymbot keeps reading the provider's stream for up to 25 seconds after you leave to get that count. If it does not arrive, the charge is estimated from what you sent and what was written, and for a model that reasons it includes the whole output allowance of the hold. A request whose connection drops still finishes and is charged.
  • जालपुटस्य अन्वेषणं करोतु। अन्वेषणस्य मूल्यं $0.008 भवति, यत् स्याट्-रूपेण परिवर्तितं भवति, यदा अपि अन्वेषणं प्रचलति, तदा प्रतिरूपं उत्तरं ददति वा असफलः भवति वा इति। तेन पठितानि पृष्ठानि अपि प्रतिरूपं प्रति निवेशरूपेण प्रेष्यन्ते, अतः ते स्वकीयाः टोकेन् इत्येतानि योजयन्ति।

प्रत्येकं प्रतिक्रिया कथयति यत् तस्य मूल्यं कियत् इति। जे. एस्. ओ. एन्. प्रतिक्रियाः एकं धरन्ति। nymbot यस्य शेषं दत्तम् आसीत्, क्रेडिट्स् तथा स्याट्स् मध्ये शुल्कं, किं अवशिष्टम् इति आक्षेपः।

व्यय-वस्तु

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

सशुल्क-प्रतिसादाः अपि एतान् शीर्षकान् (headers) वहन्ति, यत्र वदने (speech) इव JSON-रहित-प्रतिसादायाः मूल्यं दृष्टुं शक्यते:

शीर्षकम्अर्थः।
X-Nymbot-Cost-Satsअस्य अनुरोधस्य मूल्यं कियत् भवति, साट्स् मध्ये।
X-Nymbot-Balance-Satsयस्मात् राशिना प्रदायात् तस्मिन् शिल्पे सट्स-इकाइषु किम् अवशिष्टम्?
X-Request-Idअनुरोधस्य कृते एकं ऐ. डि., प्रत्येकस्मिन् प्रत्युत्तरे। यदि भवान् समर्थनं सम्पर्कयति तर्हि तत् उद्धरतु।

प्रतिmillions tokens इत्यस्य दरः, शुल्कं मार्जिनं च समाविष्टं विना, अत्र अस्ति प्रतिरूपाणां सूची डालर् तथा स्याट्स् मध्ये, तथा च मूल्यपत्रिकायदि बिट्कायिन् इत्यस्य मूल्यं पठितुं न शक्यते तर्हि देय-अनुरोधाः प्रत्यावर्तन्ते। 503 price_unavailable तेन सह। Retry-After: 60 न तु ऊहापोहः।

त्रुटयः।

प्रत्येकस्य दोषस्य आकारः समानः भवति, यः एकः ओपन्-ए. ए. ऐ. ग्राहकः पूर्वमेव जानाति। 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शरीरं वैधं जे. एस्. ओ. एन्. न अस्ति (invalid_json), आवश्यकं क्षेत्रं अनुपस्थितम् अस्ति (missing_required_parameter), मूल्यं दोषपूर्णम् अस्ति, अथवा अनुरोधः किमपि पृच्छति यत् माडेल् अथवा अन्तिमबिन्दुः न करोति, यथा उपकरणानि। nymbot/auto (unsupported_tool). param क्षेत्रस्य नामकरणं करोतु। अपि च। upstream_rejected यदा प्रदायकः प्रार्थनां निराकृतवान्।
401 authentication_errorकी अनुपस्थितः, अज्ञातः, निरस्तः अथवा समाप्तः अस्ति, अथवा हस्ताक्षरितः अनुरोधः अवैधः अथवा पुनः प्रयुज्यते।
402 insufficient_quotaशेषराशिः अनुरोधं पूरयितुं न शक्नोति। सङ्केतः। 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एकः स्वरः भाषा च यः वाच्ये भाषणे एकत्र न गच्छति (voice_language_mismatch, unsupported_language).
429 rate_limit_errorअस्मिन् कुञ्जिकायाम्, अस्मिन् निर्देशिकायाम्, अथवा असत्यानcredential-मानकान् युज्यमानान् अधिकिताः अनरोधाः सन्ति (rate_limit_exceeded), अथवा प्रदायकः दर-परिमितः अस्ति (upstream_rate_limited)। क्षणेभ्यः प्रतीक्षां करोतु। Retry-After.
500 api_errorSomething went wrong on Nymbot's side (internal_error).
502 api_errorप्रदायकः प्रत्युत्तरं न दत्तवान् (upstream_error), अथवा विद्युत्-सूचनापत्रं निर्मातुं न शक्यते (invoice_unavailable).
503 api_errorप्रदायकः अतिभारितः अस्ति (upstream_overloaded), बिट्कायिन् मूल्यं पठितुं न शक्यते (price_unavailable), अथवा सेवायाः कश्चन भागः अधः अस्ति (service_unavailable, media_hosting_unavailable). Retry-After पुनः कदा प्रयतितव्यं, कुत्र ज्ञातम् इति वदति।

द्वौ अपवादौ स्तः।

  • /api/v1/messages एन्थ्रोपिक् इत्यस्य त्रुटि-स्वरूपे उत्तरानि दीयतः, यतः एन्थ्रोपिक्-क्लैण्ट्स् इत्ययम् एव पार्स् करोति। {"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).
  • स्ट्रीमिङ्ग्-अनुरोधः यः प्रथम-बैट् इत्यस्य प्राक् विफलः भवति, सः उपरि स्थित्या सह सामान्यं जे. एस्. ओ. एन्. दोषं प्राप्नुयात्, न तु इवन्ट्-स्ट्रीम् इति। स्ट्रीम् इत्यस्य आरम्भस्य अनन्तरं विफलतां, तस्य अन्तिमबिन्दु-स्वस्वरूपे, स्ट्रीम्-इत्यस्य अन्तिम-इवन्ट्-रूपेण प्रेष्यते।

त्रुटि-सन्देशेषु कदापि अन्यस्य सेवायाः आन्तरिकविवरणानि न भवन्ति। प्रदायकस्य स्वीय-त्रुटिः भवन्तं प्राप्तुं प्राक् पुनः उच्चार्यते।

सीमाः।

परिमितिः।मूल्यम्।
कुञ्जीप्रति अनुरोधः120 प्रतिनिमेषम्। ततः परं, 429 तेन सह। Retry-After.
की विना निवेदनानिप्रतिनिमेषम् 120, प्रतिरूपस्य कृते, श्रव्य-देय-पद्धति-सूचीनां कृते, प्रतिदाय-टोकन्-परीक्षणानां कृते, प्रतिदान-अन्तिम-बिन्दूनां कृते च, यत् चाबि-विना अथवा प्रतिदान-विना आहूयते। तस्य उपरि, 429 तेन सह। Retry-After.
प्रमाणीकरणम् विफलम्कुञ्जीनां, हस्ताक्षरणां, भुगतानप्रमाणिकानां, धनप्रतिदानां च टोकनानां कृते प्रति-सङ्केतस्थानं प्रतिमिनिटम् ३०, येषां प्रमाणीकरणं न भवति। ततः अधिके, यत् सङ्केतस्थानं प्रमाणिकं वहति ततः प्रत्येकं अभ्यर्थना प्राप्नोति 429 तेन सह। Retry-After यावत् निमिषं समाप्तं न भवति। शरीरस्य पठनात् पूर्वं प्रमाणपत्राणि परीक्षितानि भवन्ति।
नूतनाः चाबिः60 प्रतिघण्टा प्रतिनिम् तथा 120 प्रतिघण्टा प्रति पता।
शीर्ष-सूचनापत्राणि60 प्रतिघण्टा प्रतिनिम् तथा 120 प्रतिघण्टा प्रति पता।
NWC वालेट-संयोगाः10 प्रतिघण्टा प्रति एन्. ऐ. एम्. तथा 30 प्रतिघण्टा प्रति पता। व्यालेट् रिले इत्यस्य उपयोगः करणीयः भवति। wss:// मानक-तन्त्रे।
मुद्रापत्राणां पुनर्भरणम्प्रति-टोकन् प्रति-निमेषम् 60 निवेदनानि।
सङ्केतः।प्रत्येकस्मिन् प्रति-पता-सीमायां ऐ. पी. वी. 6 सङ्केतः तस्य सम्पूर्णः/64 इति गण्यते, तथा च ऐ. पी. वी. 4-म्याप्ड् ऐ. पी. वी. 6 सङ्केतः तस्य ऐ. पी. वी. 4 सङ्केतः इति गण्यते।
जे. एस्. ओ. एन्. निवेदनं शरीरं४ MB; ६४ KB तव nym द्वारा हस्ताक्षरीतानां अनुरोधानां कृते।
बहुभागीय-अनुरोध-निकायः (अपलोडस्)३२ MB। संसोधनाय चित्रं २० MB पर्यन्तं भवितुं शक्नोति, ध्वनि-दस्तावेज़ः २५ MB पर्यन्तं भवितुं शक्नोति। अत्यन्तं ६४ भागाः, प्रत्येकस्मिन् ८ KB पर्यन्तं भाग-शीर्षकाः, तथा च १ तः ७० अक्षराणां सीमा; अन्यथा 400 invalid_multipart.
एकस्मिन् वार्तालाप-अनुरोधे चित्राणि।20. प्रत्येकः एकः अस्ति। https:// अथवा http:// सार्वजनिक-मेघगृहस्य (public host) लिंकः, अथवा एकः data:image/… यू. आर्. एल्.।
प्रति-पीढ्याः अनुरोधाः प्रतिमाः1 तः 4 पर्यन्तं (n)
निर्गम-टोकेन्स्प्रतिरूपस्य अधिकतमं परिमितम्। बृहत्तरम्। max_tokens तत् प्रति न्यूनं भवति, न निराकृतम्।
भाषण-निवेशःमानक-स्वरस्य कृते 800 अक्षराणि, औरा-2 इत्यस्य कृते 2,000 अक्षराणि।
प्रतिलेखनम्30 निमेषाणां ध्वनिमुद्रणं, 25 एम्. बी. इति। दीर्घकालं यावत् ध्वनिमुद्रणं निराकरोति। 413 यदा विस्पर् केवलं एकवारं श्रुतवान् तदा एव तस्य दीर्घता ज्ञातुं शक्यते, तदा अपि सः आवेष्टितः नास्ति।
अन्तर्निर्मिताः।प्रतिअनुरोधम् १०० निवेशानि।
वीडियो-कार्यानिप्रस्तुतीकरणानन्तरं 24 घण्टा यावत् रक्षितं भवति, एकघण्टायाः अनन्तरं रेण्डर् इत्यस्य त्यागः भवति। प्रतिनिम् एकवारं अधिकतमं 10 रेण्डरिङ्ग् भवति।
इतिहासं पृच्छतु।90 दिनानि यावत् रक्षितम्।
प्रत्येकं nym प्रति सक्रियकुञ्चिकाः25. केवलं नवीनतमानि 50 निरस्तानि चाबिः एव रक्षितानि भवन्ति।

चित्रस्य लिंकः सार्वजनिकं होस्टं प्रति निर्दिष्टुं अवश्यं भवेत्: निजी-वा स्थानिक-जालस्य उपरि अथवा Nymbot-इत्यस्य स्वस्यैवेक-स्थलैः उपरि स्थितं पतेः प्रेषणं वर्जितम् अस्ति। प्रदातारस्य गति-नियन्त्रणं (pacing) यत् अनुप्रयोगे प्रयुज्यते तत् अत्र अपि प्रयुज्यते, अतः एकस्य प्रदातारं प्रति अनुरोधनां विस्फोटः (burst) विफलतायाः स्थाने मन्दं कर्तुं शक्यते।

ए. पि. ऐ. किं द्रष्टुं शक्नोति?

ए. पि. ऐ. इतीदं एप्स्-प्रकारेण निजी नास्ति, तथा च कथं भवति इति यथार्थरूपेण ज्ञातुं योग्यम् अस्ति।

  • इदं एन्ड-टु-एण्ड्-एन्क्रिप्टेड् नास्ति। In the apps, a message is sealed on your device to keys only Nymbot holds and travels as a उपहारक्षेपबन्धनम्. An API request is ordinary HTTPS: it is encrypted on the way to Nymbot, and Nymbot's server reads it in the clear to handle it.
  • प्रार्थनानां उत्तरानां च सञ्चयः न भवति। ते तत्र प्रतिरूपे प्रविशन्ति तथा उत्तरं च पुनरागच्छति। यत् रक्ष्यते तत् पत्रकम् अस्ति: प्रत्येकस्य अनुरोधस्य समयः, प्रतिरूपं, प्रकारः, टोकन-संख्या, मूल्यम्, शेषः, कुंजीः च तथा सफलता वा, ९० दिनानि यावत्, यत् अस्ति अन्वेषणस्य इतिहासः भवन्तः दृष्टवन्तः। तस्यैव अनुरोधस्य उपयोग-अभिलेखः (समयः, प्रकारः, प्रारूपम्, टोकनानां संख्या, मूल्यम्, अवधिः च веб-खोजप्रयोगः वा सफलता वा इति) अनुप्रयोगस्य स्वकीयेन सह ९० दिनानि यावत् रक्ष्यते।
  • nym इत्यस्य कृते अन्यत् सर्वं लघु अस्ति अत्र च सूचीबद्धम्। ए. पि. ऐ. कुञ्जीः तेषां नाम, लघु-सङ्केतः, व्यय-परिमितिः, पुनःनिर्धारण-अवधिः, समाप्तिः तथा च यदा ते निर्मिताः, अन्तिमवारं च उपयुज्यन्ते, तथा च हेश्-रूपेण सञ्चिताः भवन्ति, कदापि चाबिः न भवन्ति, केवलं नवीनाः 50 निरस्त-चाबिः एव स्थापिताः भवन्ति। स्वयंचालितं शीर्षम् वॉलेट-सम्बन्धः कूटबद्धरूपेण सञ्चितः भवति, तस्य सीमा (threshold), धनराशिः, अन्तिमस्य उपरि-भरणस्य (top-up) च फलं तावत् सञ्चितानि भवन्ति। भिडियो-कार्याणि २४ घण्टापर्यन्तं रक्षितं भवति। प्रति-आह्वयानुसारं (per call) प्रदादक्षिणं केवलं ७ दिनानि यावत् Lightning-भुगतान-हॅशं (hash) तथा ३० दिनानि यावत् कूटबद्धं धन-प्रतिफल-टोकनम् (hashed refund token) एव उपैति, येन कोऽपि नाम्ना सह सम्बन्धः न भवति। यत् शुल्कं शेषराशिना न भुक्यते, तत् उपरि-भरणात् पूर्वं ऋणं रूपेण सञ्चितं भवति।
  • अनुप्रयोगस्य विलोपनं तं नश्यति। A यन्त्रस्य विलोपनम् प्रत्येकं ए. पि. ऐ. की निरस्तं च निष्कासयति, तथा च क्वैरी इतिवृत्तं, उपयोग-अभिलेखाः, व्यालेट्-सम्पर्कं, वीडियो-कार्यानि च निष्कासयति। शेषं शुल्कं च अद्यापि एन्. ऐ. एम्. इत्यत्र एव तिष्ठते।
  • प्रतिरूपस्य प्रदायकः भवतः निवेदनं पश्यति।यथा आप्-द्वारा भवति। केटलाग्-प्रतिरूपाणि तेषां निर्मातृषु प्रवर्तन्ते; मानक-मार्गाः, एम्बेडिङ्ग्-विशेषाः च क्लौड्फ्लेर् इत्यत्र प्रवर्तन्ते।
  • जनितं माध्यमं सार्वजनिकम् अस्ति। Pictures and video delivered as links are uploaded to public Blossom file hosts, where a file's address is its hash. Anyone with the link can open it, and Nymbot cannot take it down again. Ask for b64_json उत्पन्नं चित्रं प्रत्युत्तरे पुनः आगच्छति, कदापि अपलोडितं न भवति।
  • किं भवान् दत्तं चित्राणि जनित्रं अस्ति? एकं चित्रं यत्र भवान् अप्लोड् करोति। सम्पादनं करोतु।, अथवा अ-रूपेण प्रेषयतु। data: जनरेटर्-मध्ये यू. आर्. एल्. अस्ति। image_url, प्रथमं सार्वजनिक-ब्लासम्-होस्ट् इत्यत्र अप्लोड् भवति येन जनरेटर् तत् आनेतुं शक्नोति, अपि च तस्मिन् एव प्रयुज्यते। https:// सः लिंकः तस्यैव लिंकः रूपेण प्रेषितः। संवादांशात् प्रेषितानां चित्राणां गमनं प्रतिरूप-प्रदातां भवति, Blossom इत्यत्र न।
  • एकं की भवतः निम् इत्यनेन सह सम्बद्धम् अस्ति। सर्वं की-व्ययः भवतः निम् इत्यस्य शेषात् बहिः आगच्छति, अतः ए. पि. ऐ. इत्यस्य उपयोगः न भवति। अनामिकः।यदि भवान् इच्छां करोति यत् API भवतः दैनन्दिननामकात् पृथक् तिष्ठतु, तर्हि स्वकीयं शेषं धनं युक्तं पृथक् नामकात् प्रभैः (keys) निर्मान्तु।

यदि भवान् आप्-विशेषाणां सुरक्षां इच्छति तर्हि आप्-विशेषाणां उपयोगं करोतु। ए. पि. ऐ. तदा भवति यदा भवतः स्वोपकरणेषु प्रतिरूपाणि आवश्यकानि भवन्ति।

प्रत्येकं अन्तिमबिन्दुः

अन्तिमबिन्दुःकिं करोतिAuth
GET /api/v1/modelsप्रतिरूपाणां सूचीः।, मूल्यैः सहन किमपि
POST /api/v1/chat/completionsसंवादपूर्णपूर्णताःकी
POST /api/v1/responsesप्रतिक्रियाः ए. पि. ऐ.की
POST /api/v1/messagesएन्थ्रोपिक-सन्देशाःकी
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अन्तर्निर्मिताः।की अथवा विद्युत्-प्रज्ज्वलनम्।
GET /api/v1/credits/balance (अथवा POST)उभयोः सन्तुलनंकी
GET /api/v1/topup/payment-methodsवेतनं दातुम् उपायः।न किमपि
POST /api/v1/topup/create/btc-lightningविद्युद्वारणस्य सूचनापत्रम्।की
GET /api/v1/topup/status/{invoice_id}Checks and credits itकी
GET /api/v1/queries/historyप्रत्येकस्य अनुरोधस्य मूल्यं कियत् भवति?की अथवा निम्
GET /api/v1/accountलेखा-सारांशःन्याम्।
/api/v1/keysकी इत्येतान् निर्माति, परिवर्तयति, प्रत्याहरति च।न्याम्।
/api/v1/nwc-auto-topupस्वयंचालित टॉप-अपन्याम्।
GET /api/v1/l402/refunds, POST /api/v1/l402/refunds/redeemप्रतिदाय-चिह्नस्य परीक्षणं वा विमोचनं वा करोति।रिफ़ण्ड् टोकन्; रिडीम् कर्तुं निम्

“Nym” means a request signed by your Nostr key, described in खाताअनुरोधनां हस्ताक्षरम्ये साधनानि पूर्वमेव एतान् स्वरूपान् वदन्ति, तेषां कृते पश्यन्तु। साधनानि तथा SDKs, तथा च क्लाड् कोड्, कोडेक्स् तथा क्लैन् इत्यादीनां कोडिंग्-अभिकर्तृणां कृते पश्यन्तु। सङ्केतनसाधनानि.