תמחור

כל מודל עולה בדיוק כפי שגובה יצרן המודל עבורו, בדולרים אמריקניים. התשלום מתבצע מ־יתרת ה־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.ru/v1/models/{model_id}:

מחיר = כמות × מספר קרדיטי API ליחידה, בעיגול כלפי מעלה לקרדיט API שלם (⁨‏0.001 ‏$⁩), ולעולם לא פחות מ־1. יחידות זולות מאוד יכולות לקבל מחיר חלקי ליחידה (0.4 קרדיטי API לשנייה); רק הסכום הכולל של קריאה מעוגל.

חלק מהמודלים גובים תעריף שונה בהתאם לקלט: וידאו עם קול עולה יותר מווידאו ללא קול, 4K עולה יותר מ־1K וכן הלאה. כללים אלה מופיעים בעמוד של כל מודל. פרמטר שלא ציינת נחשב לערך ברירת המחדל שלו, ולכן המחיר שמוצג עבור קלט הוא המחיר שתשלם.

מחירים מדויקים, נמדדים, משוערים ומחירי שימוש#

לכל מחיר יש mode:

• exact: המחיר מחושב מהקלט שלך (שניות, תמונות, מגה־פיקסלים, תווים, שלבים, או מחיר קבוע אחד לכל וידאו או קריאה).
• measured: המחיר נקבע לפי הקבצים שאתה שולח: אורך וידאו או אודיו בקלט, גודל תמונת הקלט, קצב הפריימים או מספר הפריימים של וידאו. כלי הגדלת רזולוציה, סנכרון שפתיים, וידאו־לווידאו, תמלול וכלי אודיו מתומחרים כך. לפני ההרצה ה־API קורא את אורך הקובץ, הרזולוציה וקצב הפריימים שלו (וכך עושה גם הצעת המחיר), ולכן הצעת המחיר היא בדיוק הסכום שההרצה תחייב. בעמוד המודל מצוין על מה משלמים ("מחיר לשנייה של וידאו הקלט שלך"), והמחשבון שלו משתמש במספרים של הקובץ. קובץ שלא ניתן לקרוא נדחה עם unmeasurable_input ולא מתבצע חיוב.
• estimate: העלות של המודל עצמו תלויה במשהו שהקלט אינו יכול לספק מראש (טוקנים, זמן חישוב). מודל כזה גובה מחיר משוער קבוע להרצה (לכל תמונת פלט כאשר יש לו מספר תמונות), שנקבע לפי העלות הממוצעת של הרצות אמיתיות של אותו מודל. המחיר עדיין ידוע לפני ההרצה: הצעת המחיר היא הסכום שתשלם.
• metered: המודל מחויב לפי שימוש בפועל, שרק ההרצה עצמה יודעת: הטוקנים שמודל שפה או ראייה קורא וכותב, שניות הדיבור שמודל קולי מייצר, או זמן העיבוד של המודל. ראו חיוב לפי שימוש בהמשך.

בעמודי המודלים מופיעים "מחיר להרצה", "מחיר לשנייה של וידאו הקלט שלך" (וניסוחים דומים), "מחיר משוער להרצה" או "חיוב לפי שימוש"; GET https://api.doitong.ru/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.ru/v1/quote/{model_id} מקבל בדיוק את גוף הבקשה שהיית שולח ל־run ומחזיר את מחיר הקלט: המחיר המדויק, למעט מודל המחויב לפי שימוש, שבו זהו הסכום המרבי שההרצה יכולה לעלות. אין צורך במפתח והוא אינו עולה דבר:

curl -X POST "https://api.doitong.ru/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. הוסף ?currency=rub כדי לקבל סכום 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; בקשה מחויבת לפי שימוש מוסיפה mode, held, typical ו־settled, ראו חיוב לפי שימוש);
• account: GET https://api.doitong.ru/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³ בתים; אחסון של 10 GB למשך חודש עולה 1,000 קרדיטי API). היתרה לעולם אינה יורדת מתחת לאפס: כשאין אפשרות לשלם, אותו יום אינו מחויב, נשלח אליך אימייל, ויש לך 30 ימים לטעינה לפני שהקבצים הנשמרים יהפכו לזמניים ויימחקו 7 ימים לאחר מכן. פרטים: קבצים.

מחירים נוכחיים#

אלה המודלים המומלצים. כל 1,496 המודלים והמחירים שלהם נמצאים בקטלוג המודלים וב-GET /models (אין צורך במפתח).

טעינה#

הוסף כסף ליתרת ה־API בכתובת https://doitong.ru/developers/dashboard#balance. כשהיתרה נמוכה מדי, הרצה מחזירה 402 insufficient_credits עם top_up_url. אפשר גם להגביל כל מפתח API בתקציב משלו בקרדיטי API (ראו אימות).