Баға белгілеу

Әр модельдің құны оны жасаушы белгілеген бағамен, АҚШ долларымен дәл бірдей. Төлем 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 моделінде пайдалану бағасы ("1000 токенге $0.01", "жасалған аудионың әр секундына $0.002", "өңдеу уақытының әр секундына $0.00111") және әр орындауға арналған ең жоғары баға бар: сұрауыңызда көрсетілген мәндерге (max_tokens, мәтін ұзындығы, ажыратымдылық, шығыстар саны) және модель жариялаған шектеулерге сәйкес орындау құнының ең жоғары сомасы. Ол URL артындағы файл мазмұнына ешқашан байланысты емес. Өңдеу уақытымен немесе дауыс сеансының ұзақтығымен есептелетін модельде ең жоғары мән — сұрау орындалуы мүмкін ең ұзақ уақыт (кескіндер үшін 15 минут, аудио үшін 30, бейне үшін 60), сондықтан әдеттегі орындаудан әлдеқайда жоғары. Ең жоғары құны модельдің бір орындауға арналған шегінен асатын кіріс (өте ұзын мәтін) 422 invalid_input арқылы қабылданбайды:

1. Есеп credits ретінде осы ең жоғары соманы қайтарады (hold және typical — әдеттегі орындау мәндерімен). Орындау басталғанда ең жоғары сома API теңгерімінен шегеріледі және оны теңгеріміңіз бен кілт бюджетіңіз жабуы тиіс.
2. Орындау сәтті аяқталғанда, сұрау модель хабарлаған нақты пайдалануға сәйкес реттеледі: пайдалану × пайдалану бағасы, бүтін API кредитіне дейін жоғары қарай дөңгелектеледі. Ең жоғары соманың қалған бөлігі автоматты түрде қайтарылады, бір рет API теңгеріміңіздегі refund жолы ретінде.
3. Пайдалануы бұдан жоғары болса да, орындау ешқашан ең жоғары сомадан қымбат болмайды. Сәтсіз немесе тоқтатылған орындау, әдеттегідей, толық қайтарылады.

Көп орындаудың құны ең жоғары сомадан әлдеқайда төмен; модель бетінде құрастырушы кірісі мен әдеттегі орындау үшін "Әр орындауға $X дейін" (каталогта "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.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 мәндерін де қайтарады. 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.ru/v1/account credits (API теңгерімі), balance: { "credits", "usd" } және storage (файлдарды сақтау орнының бағасы, пайдаланылуы және айлық болжамы) мәндерін қайтарады.

Қайтарымдар#

• Жарамсыз сұрау (орындау басталғанға дейінгі кез келген 4xx) үшін ешқашан төлем алынбайды.
• failed күйімен аяқталған сұрау (timeout қоса) API теңгеріміне автоматты түрде толық қайтарылады.
• Басталмай тұрып тоқтатқан сұрау толық қайтарылады. Модель генерацияны бастағаннан кейін тоқтату тек сұрау болып қалады: модель аяқтаса, нәтиже жеткізіліп, төлем алынады.
• Сәтті орындалған metered сұрауына пайдаланылмаған ең жоғары соманың бөлігі қайтарылады.

Сұрау нысаны бәрін көрсетеді: cost.credits, cost.charged және cost.refunded.

Файлдарды сақтау#

Шығыс файлдары сақтау орнымызда сақталады. Оларды аккаунтта немесе әр орындау үшін (?storage=) таңдайсыз:

Мәңгі сақтаудың ақысы API теңгерімінен күніне бір рет алынады: сақталған ГБ × айлық баға ÷ айдағы күн саны, storage түріндегі есеп жолдары ретінде. API кредитінің бөлшектері келесі күнге өткізіледі, сондықтан бір айда жалпы сома дәл ГБ × 100 API кредитін құрайды (1 ГБ = 1024³ байт; бір ай сақталған 10 ГБ құны 1 000 API кредиті). Теңгерім ешқашан нөлден төмен түспейді: төлеу мүмкін болмаған күні ақы алынбайды, электрондық хат аласыз және сақталған файлдар уақытша болып, 7 күннен кейін жойылғанға дейін 30 күн ішінде теңгерімді толықтыра аласыз. Толығырақ: Файлдар.

Ағымдағы бағалар#

Бұл — ұсынылған модельдер. Барлық 1 496 модель және олардың бағасы модельдер каталогында және GET /models ішінде бар (кілт қажет емес).

Толықтыру#

API теңгерімін https://doitong.ru/developers/dashboard#balance мекенжайында толықтырыңыз. Теңгерім тым төмен болғанда, орындау 402 insufficient_credits және top_up_url мәнімен жауап береді. Әр API кілтіне API кредиттерімен көрсетілетін жеке бюджет шегін де орнатуға болады (Аутентификация бөлімін қараңыз).