قیمت‌گذاری

هزینه هر مدل دقیقاً برابر مبلغی است که سازنده مدل، به دلار آمریکا، دریافت می‌کند. پرداخت از موجودی API انجام می‌شود که با اعتبار API محاسبه می‌شود: ۱٬۰۰۰ اعتبار API = ⁨‎$۱⁩. موجودی API جدا از اعتبار برنامه‌های Doitong است. هیچ طرح، حداقل موجودی یا هزینه‌ای به‌ازای مدل وجود ندارد: هزینه هر فراخوانی برابر قیمت آن است و هنگام پذیرفته‌شدن درخواست از موجودی API کسر می‌شود.

در روسیه (doitong.ru، api.doitong.ru یا ?currency=rub) قیمت‌ها به روبل نیز نمایش داده می‌شوند: قیمت USD × نرخ USD/RUB × ۱٫۳.

واحدها#

هر مدل یک واحد صورتحساب دارد که در صفحه آن و در GET https://api.doitong.com/v1/models/{model_id} نمایش داده می‌شود:

قیمت = مقدار × اعتبار API به‌ازای هر واحد، گرد‌شده به بالا تا یک اعتبار API کامل (⁨‎$۰٫۰۰۱⁩)، و هرگز کمتر از 1 نیست. واحدهای بسیار ارزان ممکن است قیمت کسری داشته باشند (0.4 اعتبار API به‌ازای هر ثانیه)؛ فقط مجموع یک فراخوانی گرد می‌شود.

برخی مدل‌ها بسته به ورودی نرخ متفاوتی دارند: ویدیوی دارای صدا از ویدیوی بدون صدا گران‌تر است، 4K از 1K گران‌تر است و مانند این‌ها. این قوانین در صفحه هر مدل فهرست می‌شوند. پارامتری که وارد نکنید مقدار پیش‌فرض محسوب می‌شود، بنابراین قیمتی که برای یک ورودی می‌بینید همان قیمتی است که می‌پردازید.

قیمت‌های دقیق، اندازه‌گیری‌شده، برآوردی و مبتنی بر مصرف#

هر قیمت یک mode دارد:

• exact: قیمت از ورودی شما محاسبه می‌شود (ثانیه، تصویر، مگاپیکسل، نویسه، گام، یا یک قیمت ثابت برای هر ویدیو یا فراخوانی).
• measured: قیمت از فایل‌هایی که می‌فرستید پیروی می‌کند: طول ویدیوی یا صوت ورودی، اندازه تصویر ورودی، نرخ فریم یا تعداد فریم ویدیو. ارتقای وضوح، همگام‌سازی لب، ویدیو به ویدیو، رونویسی و ابزارهای صوتی به این روش قیمت‌گذاری می‌شوند. API پیش از اجرا طول، وضوح و نرخ فریم فایل را می‌خواند (اعلام قیمت نیز همین کار را می‌کند)، بنابراین اعلام قیمت دقیقاً همان هزینه اجراست. صفحه مدل مشخص می‌کند برای چه چیزی هزینه می‌پردازید ("قیمت به‌ازای هر ثانیه از ویدیوی ورودی شما") و ماشین‌حساب آن از اعداد فایل شما استفاده می‌کند. فایلی که خوانده نشود با unmeasurable_input رد می‌شود و هزینه‌ای دریافت نمی‌شود.
• estimate: هزینه خود مدل به چیزی وابسته است که ورودی از پیش نمی‌تواند مشخص کند (توکن، زمان محاسبه). چنین مدلی قیمت برآوردی ثابت برای هر اجرا دریافت می‌کند (وقتی تعداد تصویر دارد، به‌ازای هر تصویر خروجی) که بر اساس میانگین هزینه اجراهای واقعی آن مدل تعیین شده است. پیش از اجرا همچنان قیمت را می‌دانید: اعلام قیمت همان مبلغی است که می‌پردازید.
• metered: هزینه مدل بر اساس مصرف واقعی محاسبه می‌شود؛ چیزی که فقط خود اجرا می‌داند: توکن‌هایی که مدل زبانی یا بینایی می‌خواند و می‌نویسد، ثانیه‌های گفتاری که مدل صوتی تولید می‌کند، یا زمان پردازش مدل. به محاسبه بر اساس مصرف در ادامه مراجعه کنید.

صفحه مدل عبارت‌های «قیمت به‌ازای هر اجرا»، «قیمت به‌ازای هر ثانیه از ویدیوی ورودی شما» و موارد مشابه، «قیمت برآوردی به‌ازای هر اجرا» یا «محاسبه بر اساس مصرف» را نشان می‌دهد؛ GET https://api.doitong.com/v1/models?mode=measured، ?mode=estimate و ?mode=metered آن‌ها را فهرست می‌کنند.

محاسبه بر اساس مصرف#

یک مدل metered دارای قیمت مصرف ("$0.01 به‌ازای هر 1000 توکن"، "$0.002 به‌ازای هر ثانیه صوت تولیدشده"، "$0.00111 به‌ازای هر ثانیه زمان پردازش") و حداکثر هزینه هر اجرا است: بیشترین هزینه‌ای که اجرا می‌تواند داشته باشد، بر اساس درخواست شما (max_tokens، طول متن، وضوح و تعداد خروجی‌ها) و محدودیت‌های منتشرشده مدل. این مبلغ هرگز به محتوای فایلی که پشت URL قرار دارد وابسته نیست. برای مدلی که بر اساس زمان پردازش یا طول جلسه صوتی صورتحساب می‌شود، حداکثر برابر بیشترین زمان مجاز اجرای درخواست است (15 دقیقه برای تصویر، 30 برای صوت و 60 برای ویدیو)، بنابراین بسیار بیشتر از اجرای معمول است. ورودی‌ای که حداکثرش از سقف هر اجرای مدل بیشتر باشد (مثلاً متن بسیار طولانی)، با 422 invalid_input رد می‌شود:

1. اعلام قیمت این حداکثر را به‌صورت credits برمی‌گرداند (همراه با hold و typical، یعنی اجرای معمول). هنگام شروع اجرا، حداکثر از موجودی API کسر می‌شود و موجودی و بودجه کلید شما باید آن را پوشش دهند.
2. پس از موفقیت اجرا، درخواست بر اساس مصرف گزارش‌شده مدل تسویه می‌شود: مصرف × قیمت مصرف، گرد‌شده به بالا تا یک اعتبار API کامل. باقی‌مانده حداکثر به‌طور خودکار بازپرداخت می‌شود و یک بار به‌صورت ردیف refund در موجودی API ثبت می‌شود.
3. هزینه اجرا هرگز از حداکثر بیشتر نمی‌شود، حتی اگر مصرف چنین اقتضا کند. اجرای ناموفق یا لغوشده، مانند همیشه، به‌طور کامل بازپرداخت می‌شود.

هزینه بیشتر اجراها بسیار کمتر از حداکثر است؛ صفحه مدل برای ورودی سازنده و اجرای معمول عبارت «تا $X به‌ازای هر اجرا» را نشان می‌دهد («از» در فهرست). برای معدود مدل‌هایی که بر اساس زمان پردازش صورتحساب می‌شوند، مصرف همان زمان پردازش مدل است (با علامت 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" } — به‌علاوه rub، rub_display و from_rub در روسیه یا با ?currency=rub؛
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (اعتبار API؛ درخواست metered، 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 × ۱۰۰ اعتبار API است (1 GB = 1024³ بایت؛ نگهداری 10 GB برای یک ماه ۱٬۰۰۰ اعتبار API هزینه دارد). موجودی هرگز منفی نمی‌شود: وقتی امکان پرداخت نباشد، هزینه آن روز دریافت نمی‌شود، ایمیل دریافت می‌کنید و ۳۰ روز فرصت دارید موجودی را افزایش دهید؛ در غیر این صورت فایل‌های نگهداری‌شده موقت می‌شوند و ۷ روز بعد حذف می‌شوند. جزئیات: فایل‌ها.

قیمت‌های فعلی#

این‌ها مدل‌های منتخب هستند. همهٔ ۱٬۴۹۶ مدل و قیمت آن‌ها در کاتالوگ مدل‌ها و در GET /models موجود است (به کلید نیاز ندارد).

افزایش موجودی#

در https://doitong.com/developers/dashboard#balance به موجودی API پول اضافه کنید. وقتی موجودی کم باشد، اجرا با 402 insufficient_credits و یک top_up_url پاسخ می‌دهد. هر کلید API را می‌توان با بودجه‌ای جداگانه بر اساس اعتبار API نیز محدود کرد (به احراز هویت مراجعه کنید).