مواد ڏانهن وڃو
واپس Nymbot

علم جو بنياد ترقی ڪندڙ

API جو جائزو

ماڊل، جنریٽر ۽ بیلنس جیڪی توہان ایپ ۾ استعمال ڪندا آہیو، توہان جی پنھنجی ڪوڊ مان۔ API اوپن ای ای ۽ اینٿروپڪ فارمیٽ ڳالھائیندو آھی، تنہنڪری اڪثر اوزار ۽ SDK بنیادی یو آر ایل ۽ ڪنجی کی تبدیل ڪندی ڪم ڪندا آھن

API ڇا آھی

تی ھڪ HTTP API nymbot.ai اهو ئي سوال جواب ڏيندو جيڪو OpenAI يا Anthropic کان اڳي موڪليو ويو آهي.

هڪ ٻئي سان ادا ڪيو وڃي ٿو. توازن ان جي طور تي، اهو ئي قیمت تي آهي. ۽ ان جي API تي ڪو واپار نه آهي: هر درخواست توهان جو خريد ڪيو آهي.

جيڪي API نه ڪندو آھي سو Nymbot جي پاڻيءَ مان ڪجھ به شامل نه ڪندو آھي. توهان جا پيغام توهان انهن کي موڪلڻ جي طور تي موڪليندا آهن: نه Nymbot نظام سافٽ، نه يادگيريءَ، نه تاریخ يا زبان تڪڙو.

بنیادی یو آر ایل

استعمال ڪریوبنیادی یو آر ایل
اوپنائی SDKs ۽ اوپنائی-مطابقت وارا اوزارhttps://nymbot.ai/api/v1
انٽرويوشن SDK ۽ ڪلائوڊ ڪوڊhttps://nymbot.ai/api SDK شامل آهي. /v1/messages پاڻ ئی)

ہر آخری نقطی ھیٺ رھندو آھی /api/v1/ہڪ اڻ سڃاتل رستو موٽندو آھی 404 ۽ ہڪ سڃاتل رستو غلط طریقی سان سڏیو ویندو آھی 405جسن جی طئور تی

API ڪنھن بہ سائیٽ کان پار-اصل درخواستن جو جواب ڏئی ٿو، تنہنڪری ہڪ براؤزر پیج ان کی ڪال ڪری سگہی ٿو جیڪو ڪجھ بہ توہان ہڪ براؤزر ڏانہن موڪلی سگہو ٿا جیڪو بہ ان کی کولیندو آھی، جیتوڻیڪ، تنہنڪری اہو صرف ہڪ ڪنجی سان ڪیو جنہن ۾ ہڪ نن isڙو بٽڻ آھی ڪیپتوهان جي nymm سان دستخط ڪيل انڌا (ڪيلز، حساب جو خلاصو، NWC Auto-top-up and refund redemption) هڪ استثناء آهي: هڪ براؤزر ۾ اهي رڳو Nymbot جي پنهنجي سائٹس تي جواب ڏيندا آهن. حساب ڪرڻ جي درخواست.

هر JSON جسم کي موڪليو. Content-Type: application/jsonڪنھن ٻئی قسم سان انڪار ڪیو ویندو آھی 415هڪ HTML فارم يا هڪ text/plain ان کان سواءِ ٻيو ڪوبه مسئلو ڪونهي، جنهن جي باري ۾ ڪوبه مسئلو ڪونهي. -H "Content-Type: application/json" هن سان گڏ -d.

API چابیون

چابیون ایپ ۾ ٺاہیا ویا آھن۔ کولیو ای۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔ ویب ایپ جی سائڊبار ۾، یا اینڊرائیڊ ۽ آئی او ایس تی مینو ۾، ۽ ٽیپ ڪریو ڪنجی ٺاہیوان کي هڪ اسم ۽، جيڪڏھن اوھين گھرندا آھيو، هڪ cap ۽ هڪ گذاري تاريخ.

اهو هڪ ڀيرو ڏيکاريو ويو آهي. ان کي انڌا ڪرڻ کان اڳ ان کي امن ۾ ڪپي: Nymbot صرف ان جي هڪ انگشت پڌري ڪري ٿو، پوءِ اهو توهان کي واپس نه ڏيکاريندو آهي.

ہڪ چابی ھن طرح نظر اچی ٿی sk-nymbot- ان کان پوء 43 اکر، عدد، ڊش ۽ آنڊرسڪر۔ ایپ ہر ھڪ ڪنجی کی ان جی نالی ۽ ھڪ مختصر اشارو سان لسٽ ڪری ٿی sk-nymbot-Qm7x…c2Lw.

  • ھڪ ڪنجی توھان جی نیم سان تعلق رکی ٿی اھو توہان جو بیلنس خرچ ڪری ٿو، ۽ صرف توہان جو NIM ان کی ٺاہی سگہی ٿو، تبدیل ڪری سگہی ٿو یا رد ڪری سگہی ٿو۔ ڪو بہ ماڻہو جیڪو ڪنجی رکی ٿو ان سان خرچ ڪری سگہی ٿو، تنہنڪری ان کی پاسورڊ وانگر علاج ڪریو
  • توهان کي شرط آهي. ھڪ ڪنجی جی خرچ جی حد ٿی سگہی ٿی، ۽ ڪیپ ہر روز، ہر ہفتی (سومر) یا ہر مہینی (پہریون)، 00:00 UTC تی ری سیٽ ڪری سگہی ٿی۔ اھو ٻنھی بیلنس کی شمار ڪری ٿو، ہڪ معیاری ڪریڊٽ 10 سیٽ ۽ ہڪ پرو ڪریڊٽ 100 جی طئور تی، تنہنڪری ان جو مطلب اھو آھی جیڪو بہ بیلنس ہڪ درخواست خرچ ڪری ٿی 403 key_limit_reached، جیتوڻیڪ جواب ڪیپ جی ہیٺان اچی چڪو ھوندو ؛ غلطی ٻڌائی ٿی تہ ڪیترو بچی ویو آھی ۽ ڪیپ ڪڏھن ری سیٽ ٿئی ٿو max_tokens اھو بدترین صورت کی گھٽ ڪری ٿو۔ ہڪ درخواست تی چارج ڪیو ویندو آھی تہ ان جی اصل قیمت ڇا آھی ۽ اھو ڪیپ جی خلاف شمار ڪیو ویندو آھی، تنہنڪری جیڪڏھن مہیا ڪندڙ وڌیڪ ٽوڪن جی رپورٽ ڪری ٿو جیڪی ڌار ڪیا ویا آھن، آخری درخواست جیڪا فٽ ٿی سگہی ٿی ڪنجی کی ان جی ڪیپ کان ٿورو اڳتی وٺی سگہی ٿی ؛ ایندڙ کی پوء رد ڪیو ویندو آھی
  • ھڪ خرچ ٿیل ڪیپ صرف خرچ کی روڪی ٿی ان جی ڪیپ تی ہڪ ڪنجی اڃا تائین بیلنس چیڪ ڪری سگہی ٿی، ان جی تاریخ پڙھائی سگہی ٿی، ماڊل لسٽ ڪری سگہی ٿی، ٽوڪن ڳڻپ ڪری سگہی ٿی، مٿی ڪری سگہی ٿی ۽ ہڪ ویڊیو تی چیڪ ڪری سگہی ٿی جیڪا اڳ ۾ ئی شروع ٿی چڪی آھی
  • Expiry هڪ اختياري آهي. توھان جی سیٽ ڪیل تاریخ کان پوء، ڪنجی ڪم ڪرڻ بند ڪری ٿی
  • رد ڪرڻ فوری ۽ آخری آھی ھڪ رد ڪیل ڪنجی پنھنجی ایندڙ درخواست کی ناڪام ڪری ٿی اھو لسٽ ۾ رہی ٿو، نشان لڳل آھی رد ڪیو ویو، تنہنڪری ان جی خرچ جی تاریخ اڃا تائین سمجھ ۾ اچی ٿی
  • توھان وٽ 25 تائین فعال ڪنجیون ٿی سگہن ٿیون، ہر ہڪ پنھنجی نالی سان۔ ڪنجی جی ری سیٽ مدت کی تبدیل ڪرڻ صفر تی نئون دور شروع ڪری ٿو

ساھی شیٽ ظاھر ڪری ٿی ہر ڪنجی جی خرچ کی ھن عرصی ۾ ۽ مجموعی طئور تی جڏھن اھو آخری ڀیرو استعمال ڪیو ویو، ٻئی توہان جی بیلنس، ۽ توہان جی تازو API درخواستون چابیون منظم ڪرڻ.

درخواست جی تصدیق ڪرڻ

انھن مان ڪنھن ھڪ ھیڊر ۾ ڪنجی موڪلیو۔ اھی برابر آھن، تنہنڪری جیڪو بہ توہان جو گراہڪ ڊیفالٽ ذریعی موڪلی ٿو استعمال ڪریو

ہیڊرپاران موڪلیو ویو
Authorization: Bearer sk-nymbot-…اوپنائی SDKs، اڪثر اوزار، ڪلائوڊ ڪوڊ سان ANTHROPIC_AUTH_TOKEN
x-api-key: sk-nymbot-…اینٿروپڪ SDKs
api-key: sk-nymbot-…Azure-Style مشتري

گم ٿيندڙ، نٿا ڄاڻن، ڦيرائي يا ختم ٿيندڙ کلیدون موٽڻ 401ڪوڊ سان missing_api_key, invalid_api_key, revoked_api_key یا expired_api_keyماڊل لسٽنگ، آڊیو ماڊل ۽ آواز ۽ ادائگی جی طریقن کی ڪا ڪنجی جی ضرورت ناہی

انځورون، ویډیو، ڳالھائڻ، تڪڙو ۽ داخل ٿيڻ تي Lightning تي هڪ وقت ۾ هڪ درخواست تي ڪنهن به کلید کانسواءِ نه ادا ڪري سگھجي: درخواست کي ڪنهن به کانسواءِ نه موڪليو ۽ حساب ۾ ادا ڪري سگھجي. 402 جواب۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔۔ چابی کان سواء فی درخواست ادا ڪرڻ.

اہم انتظام، اڪائونٽ جو خلاصو ۽ خودڪار ٽاپ اپ استثنا آھن اہی ڪنجی جی بدران توہان جی NIM مان دستخط وٺندا آھن، تنہنڪری ہڪ لیک ٿیل ڪنجی وڌیڪ ڪنجی نہ ٺاہی سگہی حساب ڪرڻ جي درخواست.

اوھان جو اولين درخواست

توهان کي توهان جي باري ۾ معلومات حاصل ڪرڻ جي ضرورت آهي ۽ توهان جي باري ۾ معلومات حاصل ڪرڻ جي ضرورت آهي. 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 جي خاص رستو آهي، معيار توازن مان ادا ڪيو ويو آهي. anthropic/claude-sonnet-5ان کي استعمال ڪرڻ لاء، Pro Balance. نموني نموني هر هڪ ID.

ھڪ درخواست جی قیمت ڪیتری آھی

API صرف اهو ڪم ڪري ٿو جو اپليٽ.

  • ڪہڙو توازن۔ nymbot/auto خرچ ڪريو معیار بیلنس (10 سیٽ ھڪ ڪریڊٽ) ہر ٻیو چیٽ ماڊل خرچ ڪری ٿو پرو بیلنس (100 سیٽ ھڪ ڪریڊٽ)۔ معیاری تصویر جنریٽر ۽ معیاری آواز معیاری ڪریڊٽ خرچ ڪری ٿو ہر ٻیو جنریٽر پرو خرچ ڪری ٿو ایمبیڊنگ معیاری ڪریڊٽ خرچ ڪری ٿو ٽرانسڪرپشن معیاری ڪریڊٽ خرچ ڪری ٿو جڏھن معیاری بیلنس ان کی پورو ڪری سگہی ٿو، ۽ پرو ڪریڊٽ ٻی صورت ۾۔ ماڊل لسٽ ٻڌائی ٿی تہ ہر ماڊل خرچ ڪری ٿو
  • ڪھڙي مقدار. ہڪ چیٽ جی درخواست ٽوڪن تی ماپ ڪئی وئی آھی جیڪا ماڊل اصل ۾ پڙھندی ۽ لکی ٿی، مہیا ڪندڙ جی شایع ٿیل قیمتن تی. ان قیمت ۾ 5 سیڪڙو فیس شامل ڪئی وئی آھی ۽ پوء ان کی 1. 5 سان ضرب ڪیو ویندو آھی، تنہنڪری توہان فراہم ڪندڙ جی لسٽ جی قیمت جو 1 ڀیرا <ID1] ادا ڪیو ٿا اہو لائیو بٽڪوئن جی قیمت تی سیٽ ۾ تبدیل ٿی ویندو آھی ۽ ڪریڊٽ جی ہزارین حصن ۾ چارج ڪیو ویندو آھی پرو تصویرن، ویڊیو ۽ تقریر جی قیمت فی نسل، فی سیڪنڊ یا فی ڪردار، ۽ نقل فی سیڪنڊ آڊیو، ساڳئی فیس ۽ مارجن سان
  • گھٽ ۾ گھٽ هر تعقيب ڪرڻ جي درخواست کي وڌيڪ 0.05 اعتبار خرچ ڪيو آهي: هڪ معيار توازن تي نصف مقرر ڪيو ويو آهي، 5 پرو تي ادا ڪيو ويو آهي.
  • رکو، پوء آباد ٿیو۔ ان کان اڳ، هڪ درخواست ڪاري ٿو، جيڪو وڌيڪ خرچ ٿئي ٿو، اهو توهان جي تڪڙ مان رکيل آهي، جيڪي توهان موڪليو آهي ۽ جيڪو وڌيڪ تڪڙ ڪاري ٿو. ASCII ان جي UTF-8 بائتي مان ڪاري ٿو ۽ ASCII اکيون ۽ تڪڙ ڪاري ٿو هر هڪ تڪڙ جي طور تي حساب ڪن ٿا، پوءِ هر سکرپٹ، کوڊ ۽ اکيون ۾ ڪاري ٿو. ان کي پورو اعتبارن ۾ رکيل آهي، ٿورو هڪ، پوءِ هر درخواست شروع ڪرڻ لاء معيار تڪڙ تي 10 تڪڙ جي ضرورت آهي يا پرو تي 100 تڪڙ جي ضرورت آهي. صرف حقيقت ۾ خرچ ڪيو وڃي ٿو. ان کي ختم ڪرڻ کان پوءِ ٻيو ڪجهه آزاد ڪيو وڃي ٿو. هڪ اوږد درخواست ان کي ختم ڪرڻ تائين رکندو آهي. 402 insufficient_balance توهان کي توهان جي ايئرپورٽ جي ضرورت آهي، توهان جي ايئرپورٽ جي ضرورت آهي، توهان جي ايئرپورٽ جي ضرورت آهي.owed_sats ان ۾ nymbot اهو ڪم، ۽ منفي توازن). جيڪو ادا ڪيو ويو آهي، ته اولين کان ان توازن کي حاصل ڪرڻ کان پوءِ ادا ڪيو وڃي ٿو. تائين ادا ڪيو ويندو، ان توازن تي ڪجھه خرچ نه ڪيو وڃي ٿو: API، اپليڪيشن ۾ جواب، transfer يا gift.
  • ڪافی ڪریڊٽ نہ جيڪڏھن اھو ڪم نه ٿيندو آھي، توھان جي درخواست قبول ڪري سگھندؤ. 402 ڪجھ بہ ھلڻ کان اڳ۔ غلطی ٻڌائی ٿی تہ ڪہڙو بیلنس ننڍو آھی، درخواست کی ڪیتری سیٽ جی ضرورت آھی ۽ ڪیترا مفت آھن max_tokens مطلب آھی ھڪ ننڍی ہولڊ
  • ناڪامیون۔ ھڪ درخواست جیڪا ناڪام ٿئی ٿی ڪجھ بہ خرچ نٿو ڪری، جیستائین مہیا ڪندڙ ان ڪم لاء بل نہ ڪیو جیڪو ھن ناڪام ٿیڻ کان اڳ ڪیو، یا ویب ڳولا یا nymbot/auto ڪم جی چیڪ اڳ ۾ ئی ہلی چڪو ہو ؛ پوء اھو آھی جیڪو توہان ادا ڪیو ٿا، گھٽ ۾ گھٽ 0. 05 ڪریڊٽ. ہڪ وہڪرو جیڪو توہان ڪٽی ڇڏیو آھی ان لاء چارج ڪیو ویندو آھی ٽوڪن لاء مہیا ڪندڙ رپورٽ ڪری ٿو Nymbot توہان جی وڃڻ کان پوء 25 سیڪنڊن تائین مہیا ڪندڙ جی وہڪرو کی پڙھندو رہی ٿو اھو ڳڻپ حاصل ڪرڻ لاء. جیڪڏھن اھو نٿو اچی، چارج جو اندازو لڳایو ویو آھی جیڪو توہان موڪلیو آھی ۽ جیڪو لکیو ویو آھی، ۽ ھڪڙی ماڊل لاء جیڪو سبب آھی ان ۾ ہولڊ جو س out و آئوٽ الاؤنس شامل آھی
  • ویب ڳولا ھڪ ڳولا جی قیمت $0.008 آھی، جنہن کی سیٽس ۾ تبدیل ڪیو ویو آھی، جڏھن بہ ڪا ڳولا ہلی ٿی، ڇا ماڊل پوء جواب ڏئی ٿو یا ناڪام ٿئی ٿو

ہر جواب ٻڌائی ٿو تہ ان جی قیمت ڪیتری آھی۔ JSON جوابن ۾ ھڪ آھی nymbot اهو مقصد جيڪو ان مان ادا ڪيو ويو آهي، قرضن ۽ sats ۾ ادا ڪيو ويو آهي، ۽ جيڪي رهندو آهي:

قیمت آبجیکٹ

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

ادا ڪیل جوابن ۾ اہی ہیڊر پڻ ھوندا آھن، جیڪو اھو آھی جتی جواب جی قیمت کی ڳولڻو آھی جیڪو JSON ناہی، جہڙوڪ تقریر:

ہیڊرمعنی
X-Nymbot-Cost-Satsڇا اهو درخواست خرچ ڪيو آهي, in sats.
X-Nymbot-Balance-Satsجنہن بیلنس مان ادا ڪیو ویو، ان تی ڇا بچی ویو آھی، سیٽس ۾
X-Request-Idدرخواست لاء ھڪ سڃاڻپ، ہر جواب تی ان جو حوالو ڏیو جیڪڏھن توہان سپورٽ سان رابطو ڪریو

فی ملین ٽوڪن جی شرح، اڳ ۾ ئی فیس ۽ مارجن سمیت، ۾ آھن ماڊل لسٽ ڊالر ۽ سیٽس ۾، ۽ قیمت واری شیٽجیڪڏھن بٽڪوئن جی قیمت پڙھائی نہ ٿی سگہی، ادا ڪیل درخواستون واپس ڪیون ویندیون آھن 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جسم صحیح JSON نہ آھی (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اھو ھنڌ تي، ھن ورڊ کان، يا اُن جي تصديق ڪرڻ جي ڪوشش نه ڪئي وئي آهي (rate_limit_exceededاُن جو مطلب آهي ته اُن کانسواءِ ڪو اُجورو نه آهي.upstream_rate_limited). ھن وقت تائین انتظار ڪریو Retry-After.
500 api_errorNymbot جی پاسی تی ڪجھ غلط ٿی ویوinternal_error).
502 api_errorفراہم ڪندڙ جواب واپس نہ ڪیو (upstream_error)، یا بجلی جی انوائس نہ ٿی سگہی (invoice_unavailable).
503 api_errorفراہم ڪندڙ اوور لوڊ ٿیل آھی (upstream_overloaded) Bitcoin قیمت نه پڙهي سگھي ٿو (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).
  • ھڪ وہڪرو درخواست جیڪا ان جی پہرین بائیٽ کان اڳ ناڪام ٿئی ٿی مٿی ڏنل حالت سان گڏ ہڪ عام JSON غلطی حاصل ڪری ٿی، نہ تہ ہڪ واقعا وہڪرو. وہڪرو شروع ٿیڻ کان پوء ہڪ ناڪامیء کی وہڪرو جی آخری واقعی جی طئور تی موڪلیو ویندو آھی، ان آخری نقطی جی پنھنجی فارمیٽ ۾

غلطی واری پیغام ۾ ڪڏھن بہ ڪنھن ٻئی خدمت جی اندرونی تفصیل شامل نہ ھوندی آھی۔ ھڪ مہیا ڪندڙ جی پنھنجی غلطی توہان تائین پھچڻ کان اڳ وری لفظ ڪئی ویندی آھی

محدود

حدقدر
درخواست جو کلید120 فی منٽ۔ ان کان وڌیڪ، 429 سان گڊ Retry-After.
ڪو به کلید نه آهي.120 فی منٽ فی پتو، ماڊل لاء، آڊیو ۽ ادائگی جی طریقی جی لسٽنگ، واپسی ٽوڪن چیڪ، ۽ ادا ڪیل آخری پوائنٽون بغیر چابی یا ادائیگی جی ڪال ڪیون ویون 429 سان گڊ Retry-After.
تصدیق ڪرڻ ۾ ناڪام30 منٽ هر اديب تي کلیدون، دستاويز، ادا ڪرڻ جي تصديق ۽ واپس ڪرڻ جي تڪينن لاء، جيڪي تصديق نه ڪندا آھن. 429 سان گڊ Retry-After جیستائین منٽ ختم نہ ٿئی۔ جسم کی پڙھڻ کان اڳ ثبوت چیڪ ڪیا ویا آھن
نیون چابیون60 ڪلاڪ فی نیم ۽ 120 ڪلاڪ فی پتو
ٽاپ اپ انوائس60 ڪلاڪ فی نیم ۽ 120 ڪلاڪ فی پتو
NWC پيٽنگ رابطن10 هڪ ساعت تي NIM ۽ 30 هڪ ساعت تي ايڊري. wss:// هڪ معيار بندر.
واپسی ٽوڪن60 درخواستون ہڪ منٽ فی ٽوڪن
پتا------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ -ہڪ IPv6 پتو ہر ہر پتی جی حد ۾ ان جی پوری/64 جی حساب سان شمار ڪری ٿو، ۽ ہڪ IPv4-ماپ ٿیل IPv6 پتو ان جی IPv4 پتو جی طئور تی
JSON درخواست جسم4 MB; 64 KB توهان جي nym سان دستاويز لاء.
ملٽی پارٽ درخواست جسم (اپ لوڊ)32 MB. هڪ تصویر کي ترميم ڪرڻ لاء 20 MB تائين، هڪ آڈیو فائل کي 25 MB تائين. وڌيڪ 64 حصن، هر هڪ کي وڌيڪ 8 KB حصن جي عنوانن ۽ 1 تائين 70 حُڪم جي حد آهي. 400 invalid_multipart.
ھڪ چیٽ جی درخواست ۾ تصویرن20. ہر ہڪ ہڪ آھی https:// یا http:// عوامی میزبان ڏانہن لنڪ، یا ہڪ data:image/… یو آر ایل
تصویر فی نسل جی درخواست1 کان 4 (n)
انٽرويوٽ Tokensماڊل جی پنھنجی وڌ ۾ وڌ تی ڪیپ ڪیو ویو max_tokens ان کی ھیٺ ڪیو ویو آھی، انڪار نہ ڪیو ویو آھی
ڳالھائڻ ۾ داخلمعیاری آواز لاء 800 اکر، آورا 2 لاء 2, 000
ٽرانسڪرپشن30 منٽ جو آواز، 25 ایم بی۔ ھڪ ڊگھی ریڪارڊنگ سان انڪار ڪیو ویندو آھی 413 ۽ چارج نہ ڪیو ویو آھی، جیتوڻیڪ جڏھن ان جی ڊیگہہ صرف ھڪ ڀیرو معلوم ٿئی ٿی وسپر ان کی ٻڌی ڇڏیو آھی
ایمبیڊڊڊ100 انپٽ فی درخواست
ویڊیو جابسانھن کی جمع ڪرائڻ کان پوء 24 ڪلاڪن لاء رکیو ویندو آھی ھڪ ڪلاڪ کان پوء ہڪ رینڊر ڇڏی ڏنو ویندو آھی وڌ ۾ وڌ 10 رینڊرنگ ھڪ ئی وقت فی نیم
سوال جی تاریخ90 ڏینھن لاء رکیو ویو
فعال چابیون فی نیم25. صرف نئین 50 رد ٿیل چابیون رکیا ویا آھن

هڪ تصویر ڏانھن لڪ ڏيکارڻ جي ضرورت آهي ته هڪ عام میزبان تي: هڪ شخصي يا محلي شبهو، يا Nymbot جي خاص سائٹس ۾، هڪ ورڊ جي قبول نه ڪيو ويندو آهي.

API ڇا ڏسی سگہی ٿو

API نجی نہ آھی طریقی سان ایپس آھن، ۽ اھو صحیح ہجڻ جی لائق آھی تہ ڪیئن

  • اہو آخر کان آخر تائین انڪرپٽ ٿیل ناہی ائپس ۾، ہڪ پیغام توہان جی ڊوائس تی بند ڪیو ویو آھی چابیون صرف Nymbot رکی ٿو ۽ سفر ڪری ٿو تحفن جی لپیھڪ API درخواست عام HTTPS آھی: اھو Nymbot جی رستی تی انڪرپٽ ٿیل آھی، ۽ Nymbot جو سرور ان کی سنڀالڻ لاء صاف ۾ پڙھندو آھی
  • توهان جي جوابن ۽ جوابن کي محفوظ نه ڪيو ويندو. اھی ماڊل ڏانہن ویندا آھن ۽ جواب واپس منتقل ٿی ویندو آھی ڇا رکیو ویندو آھی بل: ہر درخواست لاء وقت ماڊل قسم ٽوڪن ڳڻپ قیمت بیلنس چابی ۽ ڇا اھو ڪامیاب ٿیو 90 ڏینھن لاء، جیڪو آھی سوال جی تاریخ توہان کی ڏیکاری ٿو۔ ساڳئی درخواست جو استعمال رڪارڊ (وقت، قسم، ماڊل، ٽوڪن ڳڻپ، قیمت، مدت ۽ ڇا اہو ویب ڳولا استعمال ڪیو یا ڪامیاب ٿیو) پڻ ایپ جی پنھنجی سان گڏ 90 ڏینھن لاء رکیو ویندو آھی
  • NIM لاء رکیل سڀ ڪجھ ننڍو آھی ۽ ھتی درج ٿیل آھی API چابیون انهن کي هش جي طور تي ذخير ڪيو وڃي ٿو، هرگز کلید، انهن جي نام، هڪ مختصر نصيحت، خرچ cap، reset period، expiration ۽ جڏهن انهن کي پيدا ڪيو ويو ۽ آخري استعمال ڪيو ويو آهي. اتوماتي Top-Up پرس جی ڪنیڪشن کی انڪرپٽ ڪیو ویندو آھی، ان جی حد، رقم ۽ آخری ٽاپ اپ جی نتیجی سان۔ ویڊیو جابز کی 24 ڪلاڪن لاء رکیو ویندو آھی۔ فی ڪال ادا ڪیل درخواستون صرف 7 ڏینھن لاء لائٽنگ پیمینٽ ہیش ۽ 30 ڏینھن لاء ہیشڊ ریفنڊ ٽوڪن ڇڏی ڏین ٿیون، جیڪی ڪنھن nym سان ڳنڍیل نہ آھن
  • ان اپليڪيشن کي بند ڪري ڇڏيندو. A جهاز Wipe ہر API ڪنجی کی رد ڪری ٿو ۽ ختم ڪری ٿو، ۽ سوال جی تاریخ، استعمال جا رڪارڊ، پرس ڪنیڪشن ۽ ویڊیو جابس کی ختم ڪری ٿو۔ بیلنس ۽ ڪو بہ چارج اڃا تائین NIM تی رہی ٿو
  • ماڊل فراہم ڪندڙ توھان جی درخواست ڏسی ٿوجیئن تہ ایپ مان ٿیندو آھی۔ فہرست ماڊل پنھنجی میڪرز تی ھلندا آھن معیاری رستا ۽ ایمبیڊنگ ڪلائوڊ فلیئر تی ھلندا آھن
  • ان جي پيدا ڪيل میڈیا عام آهي. لنڪ طئور ڊلیور ڪیل تصویرن ۽ ویڊیو کی عوامی Blossom فائل میزبانن تی اپ لوڊ ڪیو ویندو آھی جتی ھڪ فائل جو پتو ان جو ہیش ھوندو آھی۔ ڪو بہ لنڪ سان ان کی کولی سگہی ٿو ۽ Nymbot ان کی وری ھیٺ نٿو وٺی سگہی b64_json ۽ پيدا ڪيل تصویر جواب ۾ موٽندي آهي ۽ هرگز اپ لوڊ نه ڪيو وڃي ٿو.
  • اھڙی طرح تصویرون آھن جیڪی توہان ہڪ جنریٽر ڏیو ٿا ھڪ تصویر جنھن تی توھان اپ لوڊ ڪیو آھی سنواریويا اُن کي موڪليو وڃي. data: جنریٽر ۾ یو آر ایل image_url، پہرین ھڪ عوامی Blossom میزبان ڏانہن اپ لوڊ ڪیو ویو آھی تنہنڪری جنریٽر ان کی حاصل ڪری سگہی ٿو، ۽ اھو ئی ان تی لاڳو ٿئی ٿو https:// لنڪ کی ھن لنڪ طئور منتقل ڪیو ویو آھی چیٽ جی درخواست ۾ تصویرون ماڊل جی فراہم ڪندڙ ڏانہن وڃن ٿیون نہ تہ Blossom ڏانہن
  • ھڪ ڪنجی توھان جی نیم سان ڳنڍیل آھی سڀ ڪجھ جیڪو ہڪ اہم خرچ ڪری ٿو توہان جی NIM جی بیلنس مان اچی ٿو، تنہنڪری API استعمال نہ آھی گمنامجیڪڏھن توہان چاہیو ٿا تہ API جو استعمال توہان جی روزمرہ جی NIM کان الڳ رکیو وڃی، چابیون ٺاہیو ہڪ الڳ NIM کان ان جی پنھنجی بیلنس سان

جیڪڏھن توہان کی ایپس جی حفاظت جی ضرورت آھی، ایپس استعمال ڪریو API ان وقت لاء آھی جڏھن توہان کی پنھنجی اوزارن ۾ ماڊلز جی ضرورت آھی

ہر آخری نقطی

اختتامی نقطیاهو ڇا ڪري ٿوآٿس
GET /api/v1/modelsماڊل لسٽ، قیمتن سانڪو به
POST /api/v1/chat/completionsچادر کي ختم ڪرڻڪنجی
POST /api/v1/responsesجواب ۾ APIڪنجی
POST /api/v1/messagesantropological پيغامڪنجی
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}ویڊیو شروع ڪریو، لسٽ ۽ چیڪ ڪریوڪنجی، یا روشني شروع ڪرڻ لاء 1
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}چیڪ ڪریو ۽ ان کی ڪریڊٽ ڏیوڪنجی
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چنيسر يا چنيسر کي واپس ڪرڻ جي ضرورت آهي.اُن کي واپس ڪرڻ جي ضرورت آهي.

& ldquo; Nym & rdquo ؛ جو مطلب آھی توھان جی Nostr ڪنجی پاران دستخط ٿیل درخواست، جنہن ۾ بیان ڪیو ویو آھی حساب ڪرڻ جي درخواستانھن اوزارن لاء جیڪی اڳ ۾ ئی ھن فارمیٽ کی ڳالھائین ٿا، ڏسو سامان ۽ SDKsمثال طور، Claude Code، Codex ۽ Cline جي لاء، ڏسو. ڪوڊنگ جا اوزار.