مواد پر جائیں۔
Back to Nymbot

علم کی بنیاد ڈویلپرز

اے پی آئی کا جائزہ

ماڈل، جنریٹرز اور توازن آپ کو ایپ میں استعمال کرتے ہیں، اپنے کوڈ سے. API OpenAI اور Anthropic فارمیٹس سے بات کرتا ہے، لہذا زیادہ تر آلات اور SDKs ایک بنیادی URL اور ایک کلید کو تبدیل کرکے کام کرتے ہیں.

API کیا ہے

ایک HTTP API آن ہے nymbot.ai جو اوپن اے آئی یا اینتھروپک کلائنٹ کی بھیجی ہوئی درخواستوں کا جواب دیتا ہے۔ آپ کو ملتا ہے:

ایک ہی دو میں سے ادا کیا جاتا ہے توازن اپلی کیشن کے طور پر، اسی قیمت پر. API پر کوئی سائن اپ اور کوئی مفت اجازت نہیں ہے: ہر درخواست آپ کی خریداری کے کریڈٹ سے ادا کی جاتی ہے.

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.

بنیادی URLs

استعمال کریںبنیادی URL
OpenAI SDKs اور OpenAI متوافق آلاتhttps://nymbot.ai/api/v1
انتھروپک ایس ڈی کے اور کلاڈ کوڈhttps://nymbot.ai/api (SDK شامل کریں) /v1/messages خود)

ہر نقطہ زندگی کے تحت ہے /api/v1/ایک نامعلوم راستہ واپس آتا ہے 404 اور غلط طریقہ کار کے ساتھ کال کیا گیا ایک معروف راستہ واپس آتا ہے 405JSON کے طور پر.

API کسی بھی سائٹ سے cross-origin درخواستوں کا جواب دیتا ہے، لہذا ایک براؤزر صفحہ اسے کال کرسکتا ہے. جو بھی آپ ایک براؤزر کو بھیجتے ہیں وہ اسے کھولنے والے شخص کی طرف سے پڑھ سکتے ہیں، لہذا صرف ایک کلید کے ساتھ ایسا کریں جس میں ایک چھوٹا سا کلید ہے. کیپ. 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 اکاؤنٹ کی درخواستوں پر دستخط کرنا.

ہر جے ایس او این باڈی کو اس کے ساتھ بھیجیں Content-Type: application/jsonکسی بھی دوسری قسم کے ساتھ انکار کر دیا جاتا ہے 415، تو ایک سادہ ایچ ٹی ایم ایل فارم یا ایک text/plain کسی دوسری سائٹ سے درخواست اے پی آئی تک نہیں پہنچ سکتی۔ سی یو آر ایل کے ساتھ، پاس کریں -H "Content-Type: application/json" اس کے ساتھ -d.

API کلید

کلیدیں اپلی کیشن میں بنائی جاتی ہیں.Open آگ ویب ایپ کے سائیڈ بار میں، یا اینڈرائیڈ اور آئی او ایس کے مینو میں، اور ٹیپ کریں کلید بنائیںاسے ایک نام اور، اگر آپ چاہتے ہیں، ایک cap اور ایک اختتام کی تاریخ بتائیں.

کلید ایک بار دکھایا جاتا ہے. اس کو بند کرنے سے پہلے اسے محفوظ جگہ پر کاپی کریں: Nymbot صرف اس کا ایک انگوٹھا نشان رکھتا ہے، لہذا یہ آپ کو دوبارہ ظاہر نہیں کرسکتا ہے. ایک کھو گیا کلید کو واپس نہیں کیا جا سکتا ہے؛ اسے منسوخ کریں اور ایک اور بنائیں.

ایک چابی اس طرح نظر آتی ہے sk-nymbot- اس کے بعد 43 خطوط، اعداد و شمار، ڈش اور underscores.The app lists each key by its name and a short hint such as sk-nymbot-Qm7x…c2Lw.

  • ایک چابی آپ کے نیم سے تعلق رکھتی ہے۔ یہ آپ کے توازن خرچ کرتا ہے، اور صرف آپ کے نیم اسے بنانے، تبدیل یا منسوخ کر سکتے ہیں.
  • کیپس سیٹس میں ہیں۔ ایک کلید ایک خرچ کی حد ہوسکتا ہے، اور کیپ ہر دن، ہر ہفتے (نومبر) یا ہر ماہ (پہلے) 00:00 UTC پر دوبارہ قائم کر سکتے ہیں. یہ دونوں توازن، ایک معیاری کریڈٹ کے طور پر 10 sats اور ایک پرو کریڈٹ کے طور پر 100 کے طور پر شمار کیا جا سکتا ہے، لہذا اس کا مطلب یہ ہے کہ ایک درخواست خرچ کرتا ہے جس میں ایک ہی توازن ہے. 403 key_limit_reached، یہاں تک کہ اگر جواب کیپ کے نیچے آتا۔ غلطی بتاتی ہے کہ کیپ کتنی رہ گئی ہے اور کب ری سیٹ ہوتی ہے۔ لوورنگ max_tokens اس بدترین صورت حال کو کم کرتا ہے۔ ایک درخواست پر وہی معاوضہ لیا جاتا ہے جو اس کی اصل قیمت ہوتی ہے اور جو کیپ کے خلاف شمار ہوتا ہے، لہذا اگر فراہم کنندہ اس سے زیادہ ٹوکن کی اطلاع دیتا ہے جو الگ رکھے گئے تھے، تو آخری درخواست جو فٹ ہوتی ہے وہ کلید کو اس کی کیپ سے تھوڑا آگے لے جا سکتی ہے۔ پھر اگلے کو مسترد کر دیا جاتا ہے۔
  • خرچ شدہ کیپ صرف خرچ کو روکتی ہے۔ اس کی ٹوپی پر ایک کلید اب بھی بیلنس چیک کر سکتی ہے، اس کی ہسٹری پڑھ سکتی ہے، ماڈلز کی فہرست بنا سکتی ہے، ٹوکن شمار کر سکتی ہے، ٹاپ اپ کر سکتی ہے اور اس ویڈیو کو چیک کر سکتی ہے جو اس نے پہلے ہی شروع کر دی ہو۔
  • میعاد ختم ہونا اختیاری ہے۔ آپ کی تاریخ مقرر کرنے کے بعد، کلید کام کرنے سے روکتا ہے.
  • منسوخ کرنا فوری اور حتمی ہے۔ ایک منسوخ کلید اس کے اگلے درخواست کو ناکام کرتا ہے. یہ فہرست میں رہتا ہے، منسوخ کر دیا گیا ہے، لہذا اس کے خرچ کی تاریخ اب بھی معقول ہے.
  • آپ کے پاس 25 تک فعال چابیاں ہو سکتی ہیں، جن میں سے ہر ایک کا اپنا نام ہے۔ چابی کی ری سیٹ مدت کو تبدیل کرنے سے صفر پر ایک نیا پیریڈ شروع ہوتا ہے۔

ایک ہی شیٹ ہر کلید کے اس مدت کے اخراجات کو ظاہر کرتی ہے اور مجموعی طور پر، جب اسے آخری بار استعمال کیا گیا تھا، آپ کے بیلنس اور آپ کی حالیہ API درخواستیں دونوں۔ اس کے پیچھے کے اختتامی نکات درج ذیل ہیں۔ کلیدوں کا انتظام کرنا.

ایک درخواست کی تصدیق

ان میں سے کسی بھی ہیڈر میں کلید بھیجیں۔ وہ مساوی ہیں، اس لیے جو بھی آپ کا کلائنٹ ڈیفالٹ کے طور پر بھیجے اسے استعمال کریں:

ہیڈرکی طرف سے
Authorization: Bearer sk-nymbot-…اوپن اے آئی ایس ڈی کے، زیادہ تر ٹولز، کلاڈ کوڈ کے ساتھ ANTHROPIC_AUTH_TOKEN
x-api-key: sk-nymbot-…انتھروپک ایس ڈی کے
api-key: sk-nymbot-…ازور طرز کے کلائنٹ

ایک غائب، نامعلوم، منسوخ یا ختم ہونے والے کلید کی واپسی 401کوڈ کے ساتھ missing_api_key, invalid_api_key, revoked_api_key یا expired_api_keyفہرست ماڈل، آڈیو ماڈل اور آواز، اور ادائیگی کے طریقوں کو کوئی کلید کی ضرورت نہیں ہے.

تصاویر، ویڈیوز، باتیں، ٹرانسپیشن اور داخلات بھی ایک وقت میں ایک درخواست کے لئے Lightning پر کسی بھی کلید کے بغیر ادا کیا جا سکتا ہے: ایک کے بغیر درخواست بھیجیں اور اکاؤنٹ میں ادائیگی کریں 402 جواب دیں۔ دیکھیں۔ ایک کلید کے بغیر درخواست پر ادائیگی.

کلیدی انتظام، اکاؤنٹ کا خلاصہ اور خودکار ٹاپ اپ مستثنی ہیں: وہ کلید کے بجائے آپ کے این آئی ایم سے دستخط لیتے ہیں، لہذا لیک ہونے والی کلید مزید کلیدیں نہیں بنا سکتی۔ اکاؤنٹ کی درخواستوں پر دستخط کرنا.

آپ کی پہلی درخواست

کلید کو ماحولیاتی متغیر میں رکھیں، پھر کسی ماڈل سے کچھ پوچھیں۔ ان صفحات میں موجود مثالیں اسے یہاں سے پڑھتی ہیں 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 خرچ کرتا ہے معیاری balance (10 sats a credit). ہر دوسرے چیٹ ماڈل خرچ کرتا ہے پرو بیلنس (100 سیٹس ایک کریڈٹ)۔ معیاری امیج جنریٹر اور معیاری آواز معیاری کریڈٹ خرچ کرتی ہے۔ ہر دوسرا جنریٹر پرو خرچ کرتا ہے۔ ایمبیڈنگز معیاری کریڈٹ خرچ کرتی ہیں۔ ٹرانسکرپشن معیاری کریڈٹ خرچ کرتی ہے جب معیاری بیلنس اس کا احاطہ کر سکتا ہے، اور پرو کریڈٹ بصورت دیگر۔ ماڈلز کی فہرست بتاتی ہے کہ ہر ماڈل کے اخراجات میں کون سا توازن ہے۔
  • کتنا ہے ایک چیٹ کی درخواست کو ماڈل کی اصل میں پڑھنے اور لکھنے والے ٹوکن پر میٹر کیا جاتا ہے، فراہم کرنے والے کی شائع قیمتوں پر. اس قیمت میں 5٪ فیس شامل ہے اور پھر 1.5 کے ساتھ متغیر کی جاتی ہے، لہذا آپ فراہم کرنے والے کی فہرست کی قیمت کے 1.575 گنا ادا کرتے ہیں. یہ لائیو ویکیپیڈیا کی قیمت پر sats میں تبدیل کیا جاتا ہے اور ایک کریڈٹ کے ہزاروں میں چارج کیا جاتا ہے. پرو تصاویر، ویڈیوز اور باتیں ہر نسل، فی سیکنڈ یا ہر حروف، اور آڈیو کے سیکنڈ پر ٹرانسپیشن، اسی فیس اور مارجن کے ساتھ. معیاری تصویر ایک فلیٹ 5 معیاری کریڈٹ ہے اور معیاری آواز ایک فلیٹ 3 ہے.
  • کم از کم۔ ہر متغیر درخواست جو کم از کم 0.05 کریڈٹ کی لاگت کرتا ہے: معیاری توازن پر نصف، پرو پر 5 سیٹ.
  • ٹھہرو، پھر ٹھہرو۔ درخواست چلانے سے پہلے، اس کی زیادہ سے زیادہ قیمت آپ کے بیلنس سے لی جاتی ہے، اس کی بنیاد اس بات پر کہ آپ نے کیا بھیجا ہے اور سب سے زیادہ ٹوکن جو وہ لکھ سکتا ہے۔ سادہ اے ایس سی آئی آئی کے باہر کا متن اس کے یو ٹی ایف-8 بائٹس سے سائز کا ہوتا ہے، اور اے ایس سی آئی آئی کے ہندسوں اور پنکچوایشن کو ٹوکن کے طور پر شمار کیا جاتا ہے، لہذا کسی بھی اسکرپٹ، کوڈ اور نمبروں میں متن کو مکمل طور پر رکھا جاتا ہے۔ ہولڈ پورے کریڈٹ میں ہوتا ہے، کم از کم ایک، لہذا کسی بھی درخواست کو شروع کرنے کے لیے معیاری بیلنس پر کم از کم 10 سیٹس مفت یا پرو پر 100 سیٹس درکار ہوتے ہیں۔ صرف اصل لاگت وصول کی جاتی ہے۔ باقی اس کے ختم ہونے پر جاری کیا جاتا ہے۔ ایک طویل درخواست اس وقت تک برقرار رہتی ہے جب تک کہ یہ چلتا ہے۔ اگر ہولڈ کریڈٹ ویسے بھی دستیاب ہونا بند ہو جاتے ہیں تو، ایک اسٹریم اس کے ساتھ رک جاتا ہے۔ 402 insufficient_balance ‫‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسے‪ ،‬جیسowed_sats میں nymbot موضوع، اور منفی توازن). جو ادا کیا جاتا ہے سب سے پہلے اس توازن تک پہنچنے والے اگلے کریڈٹ سے ادا کیا جاتا ہے. جب تک یہ ادا نہیں کیا جاتا ہے، اس توازن پر کچھ بھی خرچ نہیں کیا جا سکتا: API کی طرف سے نہیں، اپلی کیشن میں جوابات، ایک ٹرانسفر یا ایک تحفہ.
  • کافی کریڈٹ نہیں اگر باقی رہائشی کی ادائیگی نہیں ہوسکتی ہے تو، درخواست سے انکار کیا جاتا ہے 402 کسی بھی چیز کو چلانے سے پہلے غلطی یہ بتاتا ہے کہ کس توازن مختصر ہے، درخواست کی ضرورت کتنی سیٹ ہے اور کتنی مفت ہیں. 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 ہے، جسے سیٹس میں تبدیل کیا جاتا ہے، جب بھی کوئی تلاش چلتی ہے، چاہے ماڈل اس کا جواب دے یا ناکام ہو۔ اس کے ذریعے پڑھے جانے والے صفحات بھی ماڈل کو ان پٹ کے طور پر بھیجے جاتے ہیں، لہذا وہ اپنے ٹوکن شامل کرتے ہیں۔

ہر جواب یہ بتاتا ہے کہ یہ کتنا خرچ کرتا ہے۔ JSON جوابات ایک nymbot اعتراض اس بیلنس کے ساتھ جس سے اسے ادا کیا گیا تھا، کریڈٹ اور سیٹس میں چارج، اور کیا بچا ہے:

لاگت آبجیکٹ

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

ادا شدہ جوابات میں یہ ہیڈر بھی ہوتے ہیں، جہاں جے ایس او این نہ ہونے والے ردعمل کی قیمت تلاش کی جا سکتی ہے، جیسے تقریر:

ہیڈرمعنی
X-Nymbot-Cost-Satsاس درخواست کی قیمت کتنی ہے، sats میں.
X-Nymbot-Balance-Satsبقایا پر جو کچھ بچا ہے اسے سیٹوں میں ادا کیا گیا تھا۔
X-Request-Idدرخواست کے لئے ایک ایڈ، ہر جواب پر. اگر آپ سپورٹ سے رابطہ کرتے ہیں تو اس کا حوالہ کریں.

فی ملین ٹوکن کی شرحیں، جن میں پہلے سے ہی فیس اور مارجن شامل ہیں، میں ہیں ماڈلز کی فہرست ڈالر اور سیٹس میں، اور قیمت کی شیٹاگر Bitcoin قیمت نہیں پڑھی جا سکتی ہے، ادائیگی کی درخواستوں کی واپسی 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 Header اس کے استعمال کے طریقوں کی فہرست کرتا ہے.
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)، بٹ کوائن کی قیمت نہیں پڑھی جا سکتی (price_unavailable)، یا سروس کا ایک حصہ نیچے ہے (service_unavailable, media_hosting_unavailable). Retry-After کہتا ہے جب دوبارہ کوشش کرنے کے لئے، جہاں یہ جانا جاتا ہے.

دو مستثنیات:

  • /api/v1/messages Anthropic کی غلطی فارمیٹ میں جوابات، کیونکہ یہ ہے کہ Anthropic کلائنٹ اسٹوریج: {"type": "error", "error": {"type": "authentication_error", "message": "…"}}اس قسم کی حالت کی پیروی کرتا ہے: invalid_request_error, authentication_error, billing_error (402), permission_error, not_found_error, request_too_large, rate_limit_error, api_error یا overloaded_error (503).
  • ایک اسٹریمنگ درخواست جو اپنے پہلے بائٹ سے پہلے ناکام ہو جاتی ہے اسے اوپر کی حیثیت کے ساتھ ایک عام جے ایس او این غلطی ملتی ہے، ایونٹ اسٹریم نہیں۔ اسٹریم شروع ہونے کے بعد ناکامی اس اینڈ پوائنٹ کی اپنی شکل میں اسٹریم کے آخری ایونٹ کے طور پر بھیجی جاتی ہے۔

غلطی کے پیغامات میں کسی دوسرے سروس کے اندرونی تفصیلات کبھی نہیں ہیں. ایک فراہم کنندہ کی اپنی غلطی آپ تک پہنچنے سے پہلے دوبارہ ترمیم کی جاتی ہے.

حدود

حد بندیقدر
کلید کی درخواستیں120 فی منٹ۔ اس سے اوپر، 429 کے ساتھ Retry-After.
کلید کے بغیر درخواستیں120 فی منٹ فی پتہ، ماڈل، آڈیو اور ادائیگی کے طریقہ کار کی لسٹنگ، ریفنڈ ٹوکن چیک، اور بغیر چابی یا ادائیگی کے کال کیے گئے اینڈ پوائنٹ کے لیے۔ اس کے اوپر، 429 کے ساتھ Retry-After.
تصدیق ناکامچابیاں، دستخط، ادائیگی کی اسناد اور رقم کی واپسی کے ٹوکن کے لیے 30 فی منٹ فی پتہ جو تصدیق نہیں کرتے ہیں۔ اس کے علاوہ، اس پتے سے ہر درخواست جس میں اسناد ہوتی ہے اسے مل جاتا ہے۔ 429 کے ساتھ Retry-After جب تک کہ منٹ ختم ہو جاتا ہے.آدمیات کو پڑھنے سے پہلے چیک کیا جاتا ہے.
نئے کلید60 فی گھنٹہ اور 120 فی گھنٹہ فی ایڈریس.
Top-up اکاؤنٹس60 فی گھنٹہ اور 120 فی گھنٹہ فی ایڈریس.
این ڈبلیو سی والیٹ کنکشن10 ایک گھنٹہ فی NM اور 30 ایک گھنٹہ فی ایڈریس. wss:// ایک معیاری بندرگاہ پر
ریفنڈ ٹوکن60 درخواستیں فی منٹ فی ٹوکن۔
ایڈریسایک IPv6 ایڈریس ہر ایڈریس کی حد میں اپنے کل /64 کے طور پر شمار ہوتا ہے، اور ایک IPv4 نقشہ IPv6 ایڈریس اس IPv4 ایڈریس کے طور پر.
JSON درخواست کے جسم4 ایم بی ؛ آپ کے این آئی ایم کے ساتھ دستخط شدہ درخواستوں کے لیے 64 کے بی۔
ملٹی پارٹ ریکویسٹ باڈی (اپ لوڈ)32 MB. ایک تصویر کو ترمیم کرنے کے لئے 20 MB تک ہوسکتا ہے، ایک آڈیو فائل 25 MB تک ہوسکتا ہے. زیادہ سے زیادہ 64 حصوں میں، ہر ایک میں زیادہ سے زیادہ 8 KB کے حصوں کے عنوانات، اور 1 سے 70 حروف کی حد ہے؛ دوسری صورت میں 400 invalid_multipart.
ایک چیٹ کی درخواست میں تصاویر20. ہر ایک ایک ہے https:// یا http:// عوامی میزبان سے لنک کریں، یا data:image/… یو آر ایل۔
نسل کی درخواست کے مطابق تصاویر1 سے 4 (n)
آؤٹ پٹ ٹوکنماڈل کے اپنے زیادہ سے زیادہ پر احاطہ کرتا ہے۔ ایک بڑا max_tokens اس سے انکار نہیں کیا گیا ہے، اس سے انکار کیا گیا ہے.
گفتگو میں داخلہمعیاری آواز کے لیے 800 حروف، آورا 2 کے لیے 2, 000۔
ٹرانسفر30 منٹ کی آڈیو، 25 ایم بی۔ ایک طویل ریکارڈنگ کے ساتھ انکار کر دیا جاتا ہے 413 اور اس کی مدت کو نہیں جانتا، یہاں تک کہ جب اس کی لمبائی سننے کے بعد ہی سنا جاتا ہے.
سرایتاتہر درخواست کے لئے 100 انٹرویو
ویڈیو کے کامجمع کرانے کے بعد 24 گھنٹے کے لیے رکھا جاتا ہے ؛ ایک رینڈر ایک گھنٹے کے بعد چھوڑ دیا جاتا ہے۔ زیادہ سے زیادہ 10 رینڈرنگ ایک ہی وقت میں فی نیم۔
استفسار کی تاریخ90 دن تک رکھا گیا۔
فعال چابیاں فی نیم25۔ صرف تازہ ترین 50 منسوخ کلیدوں کو محفوظ کیا جاتا ہے.

ایک تصویر کا لنک ایک عوامی میزبان کی طرف اشارہ کرنا چاہئے: ایک نجی یا مقامی نیٹ ورک پر ایک ایڈریس، یا Nymbot کے اپنے سائٹس پر انکار کیا جاتا ہے.

اے پی آئی کیا دیکھ سکتا ہے

اے پی آئی اس طرح سے نجی نہیں ہے جس طرح سے ایپس ہیں، اور یہ کس طرح کے بارے میں درست ہونے کے قابل ہے۔

  • یہ اینڈ ٹو اینڈ انکرپٹڈ نہیں ہے۔ In the apps, a message is sealed on your device to keys only Nymbot holds and travels as a آؤٹ Wrap. 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.
  • اشارے اور جوابات محفوظ نہیں کیے جاتے ہیں۔ وہ ماڈل کے ذریعے جاتے ہیں اور جواب واپس آتا ہے. جو محفوظ کیا جاتا ہے وہ اکاؤنٹ ہے: ہر درخواست کے لئے وقت، ماڈل، قسم، ٹوکن شمار، قیمت، توازن، کلید اور اگر یہ کامیاب ہوا، 90 دنوں کے لئے، یہ کیا ہے استفسار کی تاریخ آپ کو دکھاتا ہے۔ اسی درخواست (وقت، قسم، ماڈل، ٹوکن گنتی، لاگت، مدت اور چاہے اس نے ویب سرچ کا استعمال کیا ہو یا کامیاب ہوا ہو) کا استعمال ریکارڈ بھی ایپ کے اپنے ساتھ 90 دنوں کے لیے رکھا جاتا ہے۔
  • ایک نیم کے لئے باقی سب کچھ چھوٹا ہے اور یہاں درج کیا گیا ہے. API کلید انہیں ہیش کے طور پر محفوظ کیا جاتا ہے، کبھی بھی کلید نہیں، ان کے نام کے ساتھ، ایک مختصر اشارہ، اخراجات کی حد، دوبارہ ترتیب دینے کی مدت، میعاد ختم ہونے اور انہیں کب بنایا گیا اور آخری بار استعمال کیا گیا۔ صرف تازہ ترین 50 منسوخ شدہ چابیاں رکھی جاتی ہیں۔ خودکار ٹاپ اپ بٹوے کے کنکشن کو انکرپٹ کیا جاتا ہے، اس کی حد، رقم اور آخری ٹاپ اپ کے نتیجے کے ساتھ۔ ویڈیو جابز کو 24 گھنٹوں کے لیے رکھا جاتا ہے۔ فی کال ادا کی گئی درخواستوں میں صرف 7 دن کے لیے لائٹننگ پیمنٹ ہیش اور 30 دن کے لیے ہیشڈ ریفنڈ ٹوکن چھوڑ دیا جاتا ہے، جو کوئی این آئی ایم سے منسلک نہیں ہوتا ہے۔ بقایا رقم کو اس وقت تک واجب الادا رکھا جاتا ہے جب تک کہ ٹاپ اپ ان کی ادائیگی نہ کرے۔
  • اس اپلی کیشن کو ہٹا دیں. A آلہ مسح کریں ہر اے پی آئی کلید کو منسوخ اور حذف کرتا ہے، اور استفسار کی تاریخ، استعمال کے ریکارڈ، بٹوے کے کنکشن اور ویڈیو کے کاموں کو حذف کرتا ہے۔ بقایا رقم اور کوئی بھی چارج اب بھی این آئی ایم پر باقی رہتا ہے۔
  • ماڈل کا فراہم کنندہ آپ کی درخواست دیکھتا ہےکیتالیف ماڈل ان کے کارخانہ داروں پر چلتے ہیں؛ معیاری راستے اور داخلات Cloudflare پر چلتے ہیں.
  • پیدا شدہ میڈیا عوامی ہے. 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 اور پیدا شدہ تصویر جواب میں واپس آتی ہے اور کبھی اپ لوڈ نہیں کی جاتی ہے۔
  • وہ تصاویر جو آپ ایک جنریٹر فراہم کرتے ہیں. ایک تصویر جسے آپ اپ لوڈ کرتے ہیں ترمیم کریںیا بھیجیں A data: جنریٹر میں یو آر ایل image_url، کو پہلے عوامی بلوم میزبان پر اپ لوڈ کیا جاتا ہے تاکہ جنریٹر اسے حاصل کر سکے، اور یہی اس پر لاگو ہوتا ہے۔ https:// ایک چیٹ درخواست میں تصاویر ماڈل کے سپلائر کے لئے جائیں گے، Blossom نہیں.
  • ایک کلید آپ کے این آئی ایم سے منسلک ہوتی ہے۔ ہر چیز جو ایک کلید خرچ کرتا ہے، آپ کے نیم کے توازن سے آتا ہے، لہذا API کا استعمال نہیں ہے. anonimo کےاگر آپ API استعمال کرنا چاہتے ہیں تو آپ کے روزانہ نیم سے جدا رہنا چاہئے، اپنے توازن کے ساتھ ایک منفرد نیم سے کلید بنائیں.

اگر آپ کو ایپس کے تحفظ کی ضرورت ہو تو ایپس کا استعمال کریں۔ اے پی آئی اس وقت کے لیے ہے جب آپ کو اپنے ٹولز میں ماڈلز کی ضرورت ہو۔

ہر اختتامی نقطہ

اختتامی نقطہیہ کیا کرتا ہےآؤٹ
GET /api/v1/modelsنمونوں کی فہرستیںقیمتوں کے ساتھکوئی نہیں
POST /api/v1/chat/completionsCHAT مکمل کریںکلید
POST /api/v1/responsesجوابات APIکلید
POST /api/v1/messagesAnthropic پیغامکلید
POST /api/v1/messages/count_tokensinput 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}چیک کریں اور کریڈٹ کریںکلید
GET /api/v1/queries/historyہر درخواست کی قیمت کتنی ہےKey یا NIM
GET /api/v1/accountاکاؤنٹ کا خلاصہنیم
/api/v1/keysچابیاں بناتا ہے، تبدیل کرتا ہے اور منسوخ کرتا ہےنیم
/api/v1/nwc-auto-topupخودکار ٹاپ اپسنیم
GET /api/v1/l402/refunds, POST /api/v1/l402/refunds/redeemریفنڈ ٹوکن کو چیک یا ریڈیم کرتا ہےریفنڈ ٹوکن ؛ چھڑانے کے لیے nym

“Nym” means a request signed by your Nostr key, described in اکاؤنٹ کی درخواستوں پر دستخط کرناان آلات کے لئے جو پہلے سے ہی ان فارمیٹس سے بات کر رہے ہیں، دیکھیں آلات اور SDKs، اور کلاڈ کوڈ، کوڈیکس اور کلائن جیسے کوڈنگ ایجنٹوں کے لیے، دیکھیں کوڈنگ ٹولز.