פּרײַזן

יעדער מאָדעל קאָסט פּונקט אַזוי פֿיל ווי דער פאַבריקאַנט פֿון דעם מאָדעל רעכנט פֿאַר אים, אין יו־עס דאָלאַרן. איר צאָלט פֿון אײַער 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: דער פּרײַז גייט נאָך די פֿײַלן וואָס איר שיקט: די לענג פֿון אַן אַרײַנגעגעבענעם ווידעא אָדער אַודיאָ, די גרייס פֿון אַן אַרײַנגעגעבענעם בילד, דער ראַם־קורס אָדער ראַם־צאָל פֿון אַ ווידעא. Upscalers, lip sync, video-to-video, טראַנסקריפּציע און אַודיאָ־כלים ווערן געפּרײַזט אַזוי. פֿאַרן לויפֿ לייענט דער 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 קרעדיטן; אַ metered בקשה לייגט צו 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 קרעדיטן (זעט אויטענטיפֿיקאַציע).