قیمتیں

ہر ماڈل کی قیمت بالکل اتنی ہی ہوتی ہے جتنی اس کے بنانے والا اس کے لیے امریکی ڈالرز میں وصول کرتا ہے۔ ادائیگی آپ اپنے API بیلنس سے کرتے ہیں، جسے API کریڈٹس میں شمار کیا جاتا ہے: 1,000 API کریڈٹس = ⁨$1⁩۔ API بیلنس الگ بیلنس ہے، جو Doitong ایپس کے کریڈٹس سے جدا ہے۔ کوئی پلان، کم از کم رقم یا فی ماڈل فیس نہیں ہے: کال کی قیمت اتنی ہی ہوتی ہے، اور درخواست قبول ہونے پر API بیلنس سے منہا ہو جاتی ہے۔

روس میں (doitong.ru، api.doitong.ru، یا ?currency=rub) قیمتیں روبل میں بھی دکھائی جاتی ہیں: USD قیمت × USD/RUB ریٹ × 1.3۔

اکائیاں#

ہر ماڈل کی ایک بلنگ اکائی ہوتی ہے، جو اس کے صفحے اور GET https://api.doitong.com/v1/models/{model_id} میں دکھائی جاتی ہے:

قیمت = مقدار × فی اکائی API کریڈٹس، پورے API کریڈٹ تک اوپر کی طرف گول کی جاتی ہے (⁨$0.001⁩)، اور کبھی 1 سے کم نہیں ہوتی۔ بہت سستی اکائیوں کی فی اکائی قیمت اعشاری ہو سکتی ہے (0.4 API کریڈٹس فی سیکنڈ)؛ صرف پوری کال کا مجموعہ گول کیا جاتا ہے۔

کچھ ماڈلز ان پٹ کے لحاظ سے مختلف ریٹ وصول کرتے ہیں: آواز والی ویڈیو بغیر آواز والی ویڈیو سے مہنگی ہوتی ہے، 4K، 1K سے مہنگا ہوتا ہے، وغیرہ۔ یہ قواعد ہر ماڈل کے صفحے پر درج ہوتے ہیں۔ جو پیرامیٹر آپ چھوڑ دیتے ہیں اسے اس کی ڈیفالٹ قدر شمار کیا جاتا ہے، اس لیے ان پٹ کے لیے نظر آنے والی قیمت ہی آپ کی ادا کردہ قیمت ہوتی ہے۔

درست، پیمائش شدہ، تخمینی اور استعمال کی قیمتیں#

ہر قیمت کا ایک mode ہوتا ہے:

• exact: قیمت آپ کے ان پٹ سے نکالی جاتی ہے (سیکنڈ، تصاویر، میگا پکسلز، حروف، مراحل، یا فی ویڈیو یا کال ایک مقررہ قیمت)۔
• measured: قیمت آپ کی بھیجی ہوئی فائلوں کے مطابق ہوتی ہے: ان پٹ ویڈیو یا آڈیو کی لمبائی، ان پٹ تصویر کا سائز، ویڈیو کا فریم ریٹ یا فریموں کی تعداد۔ اپ اسکیلرز، لپ سنک، ویڈیو سے ویڈیو، ٹرانسکرپشن اور آڈیو ٹولز کی قیمت اسی طرح مقرر ہوتی ہے۔ رَن سے پہلے API فائل کی لمبائی، ریزولوشن اور فریم ریٹ پڑھتی ہے (کوٹ بھی یہی کرتا ہے)، اس لیے کوٹ بالکل وہی قیمت ہوتی ہے جو رَن وصول کرتا ہے۔ ماڈل کا صفحہ بتاتا ہے کہ آپ کس چیز کی ادائیگی کرتے ہیں ("Price per سیکنڈ of your input ویڈیو") اور اس کا کیلکولیٹر آپ کی فائل کے نمبرز استعمال کرتا ہے۔ جو فائل پڑھی نہ جا سکے اسے unmeasurable_input کے ساتھ مسترد کر دیا جاتا ہے اور کوئی رقم وصول نہیں کی جاتی۔
• estimate: ماڈل کی اپنی لاگت کا انحصار ایسی چیز پر ہوتا ہے جو ان پٹ پہلے سے نہیں بتا سکتا (ٹوکنز، کمپیوٹ ٹائم)۔ ایسا ماڈل ہر رَن کے لیے ایک مقررہ تخمینی قیمت وصول کرتا ہے (جب تصویر کی تعداد ہو تو فی آؤٹ پٹ تصویر)، جو اس ماڈل کے حقیقی رَنز کی اوسط لاگت سے مقرر کی جاتی ہے۔ رَن سے پہلے بھی قیمت معلوم ہوتی ہے: کوٹ ہی آپ کی ادا کردہ رقم ہے۔
• metered: ماڈل سے حقیقی استعمال کے حساب سے رقم وصول کی جاتی ہے، جسے صرف رَن خود جانتا ہے: زبان یا وژن ماڈل کے پڑھے اور لکھے گئے ٹوکنز، وائس ماڈل کے تیار کردہ تقریر کے سیکنڈ، یا ماڈل کا پروسیسنگ ٹائم۔ نیچے استعمال کے حساب سے وصولی دیکھیں۔

ماڈل کے صفحات پر "Price per run"، "Price per سیکنڈ of your input ویڈیو" (اور اسی طرح)، "Estimated price per run" یا "Charged by usage" لکھا ہوتا ہے؛ GET https://api.doitong.com/v1/models?mode=measured، ?mode=estimate اور ?mode=metered انہیں فہرست میں دکھاتے ہیں۔

استعمال کے حساب سے وصولی#

metered ماڈل کی استعمال کی قیمت ہوتی ہے ("$0.01 per 1000 tokens"، "$0.002 per سیکنڈ of generated audio"، "$0.00111 per سیکنڈ of processing time") اور فی رَن زیادہ سے زیادہ قیمت ہوتی ہے: آپ کی درخواست (max_tokens، آپ کے متن کی لمبائی، ریزولوشن، آؤٹ پٹس کی تعداد) اور ماڈل کی شائع کردہ حدود کے مطابق رَن کی زیادہ سے زیادہ لاگت۔ یہ کبھی URL کے پیچھے موجود فائل کے مواد پر منحصر نہیں ہوتی۔ پروسیسنگ ٹائم یا وائس سیشن کی لمبائی کے حساب سے بل والے ماڈل کے لیے زیادہ سے زیادہ قیمت اتنی ہوتی ہے جتنی دیر درخواست چل سکتی ہے (تصاویر کے لیے 15 منٹ، آڈیو کے لیے 30، ویڈیو کے لیے 60)، اس لیے یہ عام رَن سے کافی زیادہ ہوتی ہے۔ جس ان پٹ کی زیادہ سے زیادہ قیمت ماڈل کی فی رَن حد سے زیادہ ہو (مثلاً بہت لمبا متن)، اسے 422 invalid_input کے ساتھ مسترد کر دیا جاتا ہے:

1. کوٹ اس زیادہ سے زیادہ قیمت کو credits کے طور پر واپس کرتا ہے (hold اور typical کے ساتھ، جو عام رَن کو ظاہر کرتا ہے)۔ رَن شروع ہونے پر زیادہ سے زیادہ رقم API بیلنس سے منہا کی جاتی ہے، اور یہی رقم بیلنس اور آپ کے کلیدی بجٹ میں موجود ہونی چاہیے۔
2. رَن کامیاب ہونے پر درخواست کو ماڈل کی بتائی ہوئی استعمال شدہ مقدار کے مطابق حتمی کیا جاتا ہے: استعمال × استعمال کی قیمت، جسے پورے API کریڈٹ تک اوپر کی طرف گول کیا جاتا ہے۔ زیادہ سے زیادہ رقم کا باقی حصہ خودکار طور پر واپس کیا جاتا ہے، ایک بار، آپ کے API بیلنس کی refund قطار کے طور پر۔
3. رَن کی قیمت کبھی اس کی زیادہ سے زیادہ قیمت سے زیادہ نہیں ہوتی، چاہے استعمال اس سے زیادہ بنتا ہو۔ ناکام یا منسوخ شدہ رَن کی پوری رقم ہمیشہ واپس کی جاتی ہے۔

زیادہ تر رَن زیادہ سے زیادہ قیمت سے بہت کم خرچ ہوتے ہیں؛ ماڈل کا صفحہ بلڈر کے ان پٹ کے لیے "Up to $X per run" اور عام رَن (کیٹلاگ میں "from") دکھاتا ہے۔ پروسیسنگ ٹائم کے حساب سے بل والے چند ماڈلز کے لیے استعمال ماڈل کا پروسیسنگ ٹائم ہوتا ہے (جسے approximate سے نشان زد کیا جاتا ہے)۔

{
  "object": "quote",
  "credits": 621,
  "usd": "0.621",
  "mode": "metered",
  "label": "Charged by usage",
  "hold": { "credits": 621, "usd": "0.621" },
  "typical": { "credits": 10, "usd": "0.01" },
  "settlement": "usage",
  "display": "$0.01 / 1000 tokens",
  "breakdown": "up to 62.035 × 1000 tokens × $0.01"
}

رَن کے بعد، درخواست کی cost دکھاتی ہے کہ کتنی رقم روکی گئی اور استعمال کی لاگت کتنی بنی:

{
  "cost": { "credits": 621, "usd": "0.621", "charged": 621, "refunded": 611, "mode": "metered", "held": 621,
            "typical": 10, "settled": { "status": "settled", "credits": 10, "usd": "0.01", "quantity": 1,
            "unit": "1000_tokens", "unit_usd": "0.01", "source": "billed_usage", "approximate": false } }
}

charged − refunded رَن کی اصل لاگت ہے۔ settled.status نتیجے اور حتمی تصفیے کے درمیان لمحے کے لیے pending ہوتا ہے، اور نایاب صورت میں no_usage ہوتا ہے جب ماڈل نے بالکل کوئی استعمال رپورٹ نہ کیا ہو (تب زیادہ سے زیادہ رقم ہی قیمت رہتی ہے)۔

رَن سے پہلے کوٹ#

POST https://api.doitong.com/v1/quote/{model_id} بالکل وہی باڈی لیتا ہے جو آپ run کو بھیجتے، اور اس ان پٹ کی قیمت واپس کرتا ہے: درست قیمت، سوائے ایسے ماڈل کے جو استعمال کے حساب سے وصولی کرتا ہے، جہاں یہ رَن کی زیادہ سے زیادہ ممکنہ قیمت ہوتی ہے۔ اس کے لیے کلید درکار نہیں اور کوئی لاگت نہیں:

curl -X POST "https://api.doitong.com/v1/quote/flux/schnell" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A lighthouse at dusk", "num_images": 2}'

{
  "object": "quote",
  "model": "flux/schnell",
  "credits": 6,
  "usd": "0.006",
  "unit": "megapixel",
  "quantity": 2,
  "unit_credits": 3,
  "mode": "exact",
  "label": "Price per run",
  "display": "$0.003 / megapixel",
  "breakdown": "2 MP (2 images) × 3 API credits",
  "input": { "prompt": "A lighthouse at dusk", "num_images": 2 },
  "warnings": []
}

کلید کے ساتھ کوٹ balance_credits اور balance_usd (آپ کا API بیلنس)، affordable اور key_budget_remaining بھی واپس کرتا ہے۔ rub رقم کے لیے ?currency=rub شامل کریں۔

قیمت کی آبجیکٹس#

API میں ہر قیمت کی ساخت ایک جیسی ہوتی ہے:

• models: price: { "credits": 112, "usd": "0.112", "unit": "second", "display": "$0.112 / second", "credits_display": "112 API credits / second", "from_credits": 560, "from_usd": "0.56", "mode": "exact" } — روس میں یا ?currency=rub کے ساتھ rub، rub_display اور from_rub بھی شامل ہوتے ہیں؛
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (API کریڈٹس؛ میٹرڈ درخواست میں mode، held، typical اور settled بھی شامل ہوتے ہیں، استعمال کے حساب سے وصولی دیکھیں)؛
• account: GET https://api.doitong.com/v1/account credits (API بیلنس)، balance: { "credits", "usd" } اور storage (فائل اسٹوریج کی قیمت، استعمال اور ماہانہ تخمینہ) واپس کرتا ہے۔

رقم واپسی#

• غلط درخواست (رَن شروع ہونے سے پہلے کوئی بھی 4xx) پر کبھی رقم وصول نہیں کی جاتی۔
• failed پر ختم ہونے والی درخواست (بشمول timeout) کی پوری رقم خودکار طور پر API بیلنس میں واپس کر دی جاتی ہے۔
• رَن شروع ہونے سے پہلے منسوخ کی گئی درخواست کی پوری رقم واپس کی جاتی ہے۔ ماڈل کے جنریٹ کرنا شروع کرنے کے بعد منسوخی صرف ایک درخواست ہوتی ہے: اگر ماڈل مکمل کرتا ہے تو نتیجہ فراہم کیا جاتا ہے اور رقم وصول کی جاتی ہے۔
• کامیاب metered درخواست کو اس کی زیادہ سے زیادہ قیمت کا وہ حصہ واپس ملتا ہے جو استعمال نہیں ہوا۔

درخواست کی آبجیکٹ تمام تفصیل دکھاتی ہے: cost.credits، cost.charged اور cost.refunded۔

فائل اسٹوریج#

آؤٹ پٹ فائلیں ہمارے اسٹوریج میں رکھی جاتی ہیں۔ آپ اکاؤنٹ یا فی رَن (?storage=) میں انتخاب کرتے ہیں:

مستقل اسٹوریج کی رقم روزانہ ایک بار API بیلنس سے وصول کی جاتی ہے: رکھی گئی GB × ماہانہ قیمت ÷ ماہ کے دن، storage قسم کی لیجر قطاروں کے طور پر۔ API کریڈٹ کے حصے اگلے دن تک منتقل کیے جاتے ہیں، اس لیے ایک ماہ کی کل قیمت بالکل GB × 100 API کریڈٹس بنتی ہے (1 GB = 1024³ bytes؛ ایک ماہ تک رکھی گئی 10 GB کی قیمت 1,000 API کریڈٹس ہے)۔ بیلنس کبھی صفر سے کم نہیں ہوتا: جب ادائیگی ممکن نہ ہو تو اس دن رقم وصول نہیں کی جاتی، آپ کو ای میل ملتی ہے، اور رکھی گئی فائلوں کے عارضی بننے اور 7 دن بعد حذف ہونے سے پہلے ٹاپ اَپ کرنے کے لیے آپ کے پاس 30 دن ہوتے ہیں۔ تفصیلات: فائلیں۔

موجودہ قیمتیں#

یہ نمایاں ماڈلز ہیں۔ تمام 1,496 ماڈلز اور ان کی قیمتیں ماڈل کیٹلاگ اور GET /models میں موجود ہیں (کلید کی ضرورت نہیں)۔

ٹاپ اَپ#

https://doitong.com/developers/dashboard#balance پر API بیلنس میں رقم شامل کریں۔ جب بیلنس بہت کم ہو تو رَن 402 insufficient_credits کے ساتھ top_up_url واپس کرتا ہے۔ ہر API کلید کی اپنی API کریٹس میں بجٹ کی حد بھی مقرر کی جا سکتی ہے (توثیق دیکھیں)۔