Cennik

Każdy model kosztuje dokładnie tyle, ile pobiera jego twórca, w dolarach amerykańskich. Płacisz z salda API, które jest wyrażone w kredytach API: 1000 kredytów API = 1 $. Saldo API jest niezależne od kredytów aplikacji Doitong. Nie ma planów, opłat minimalnych ani opłat za poszczególne modele: wywołanie kosztuje podaną cenę, pobieraną z salda API po zaakceptowaniu żądania.

W Rosji (doitong.ru, api.doitong.ru lub ?currency=rub) ceny są również wyświetlane w rublach: cena USD × kurs USD/RUB × 1,3.

Jednostki#

Każdy model ma jedną jednostkę rozliczeniową, widoczną na jego stronie i w GET https://api.doitong.com/v1/models/{model_id}:

Cena = ilość × kredyty API za jednostkę, zaokrąglona w górę do pełnego kredytu API (0,001 $), nigdy mniej niż 1. Bardzo tanie jednostki mogą mieć ułamkową cenę za jednostkę (0.4 kredytu API za sekundę); zaokrąglana jest tylko suma wywołania.

Niektóre modele mają inną stawkę zależnie od danych wejściowych: wideo z dźwiękiem kosztuje więcej niż bez dźwięku, 4K więcej niż 1K itd. Te zasady są wymienione na stronie każdego modelu. Pominięty parametr ma wartość domyślną, więc cena wyświetlona dla danych wejściowych jest ceną, którą zapłacisz.

Ceny dokładne, mierzone, szacowane i zależne od wykorzystania#

Każda cena ma mode:

• exact: cena jest obliczana na podstawie danych wejściowych (sekund, obrazów, megapikseli, znaków, kroków albo jednej stałej ceny za wideo lub wywołanie).
• measured: cena zależy od przesłanych plików: długości wejściowego wideo lub audio, rozmiaru wejściowego obrazu, liczby klatek lub częstotliwości klatek wideo. Dotyczy to upscalerów, synchronizacji ruchu ust, wideo-do-wideo, transkrypcji i narzędzi audio. Przed uruchomieniem API odczytuje długość, rozdzielczość i liczbę klatek pliku (wycena robi to samo), więc wycena dokładnie odpowiada opłacie za uruchomienie. Strona modelu podaje, za co płacisz ("Cena za sekundę wejściowego wideo"), a kalkulator korzysta z danych pliku. Plik, którego nie można odczytać, jest odrzucany z unmeasurable_input i opłata nie jest pobierana.
• estimate: koszt modelu zależy od czegoś, czego dane wejściowe nie pozwalają z góry określić (tokenów, czasu obliczeń). Taki model pobiera stałą szacowaną cenę za uruchomienie (za wynikowy obraz, gdy określa liczbę obrazów), ustaloną na podstawie średniego kosztu rzeczywistych uruchomień tego modelu. Cenę nadal znasz przed uruchomieniem: wycena jest kwotą do zapłaty.
• metered: model jest rozliczany według rzeczywistego wykorzystania, znanego dopiero po uruchomieniu: tokenów odczytanych i zapisanych przez model językowy lub wizyjny, sekund mowy wygenerowanych przez model głosowy albo czasu przetwarzania modelu. Zobacz poniżej Rozliczanie według wykorzystania.

Strony modeli zawierają „Cena za uruchomienie”, „Cena za sekundę wejściowego wideo” (i podobne), „Szacowana cena za uruchomienie” lub „Rozliczanie według wykorzystania”; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate i ?mode=metered wyświetlają ich listy.

Rozliczanie według wykorzystania#

Model metered ma cenę zależną od wykorzystania („$0.01 za 1000 tokenów”, „$0.002 za sekundę wygenerowanego audio”, „$0.00111 za sekundę czasu przetwarzania”) oraz maksimum za uruchomienie: najwyższą kwotę, jaką może kosztować uruchomienie, wynikającą z treści żądania (max_tokens, długości tekstu, rozdzielczości, liczby wyników) i opublikowanych limitów modelu. Nigdy nie zależy ona od zawartości pliku wskazanego URL-em. W przypadku modelu rozliczanego za czas przetwarzania lub długość sesji głosowej maksimum to najdłuższy czas działania żądania (15 minut dla obrazów, 30 dla audio, 60 dla wideo), więc znacznie przewyższa typowe uruchomienie. Dane wejściowe, dla których maksimum przekroczyłoby limit modelu na uruchomienie (bardzo długi tekst), są odrzucane z 422 invalid_input:

1. Wycena zwraca to maksimum jako credits (wraz z hold i typical, czyli typowym uruchomieniem). Po rozpoczęciu uruchomienia maksimum jest pobierane z salda API i właśnie tę kwotę musi pokrywać saldo oraz budżet klucza.
2. Po pomyślnym zakończeniu uruchomienia żądanie jest rozliczane według wykorzystania zgłoszonego przez model: wykorzystanie × cena za wykorzystanie, zaokrąglone w górę do pełnego kredytu API. Pozostała część maksimum jest automatycznie zwracana jednorazowo jako wiersz refund salda API.
3. Uruchomienie nigdy nie kosztuje więcej niż jego maksimum, nawet jeśli wykorzystanie by to uzasadniało. Nieudane lub anulowane uruchomienie zawsze otrzymuje pełny zwrot.

Większość uruchomień kosztuje znacznie mniej niż maksimum; strona modelu pokazuje „Do $X za uruchomienie” dla danych wejściowych kreatora i typowego uruchomienia („od” w katalogu). W przypadku nielicznych modeli rozliczanych za czas przetwarzania wykorzystaniem jest czas przetwarzania modelu (oznaczony jako 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"
}

Po uruchomieniu cost żądania pokazuje pobraną kwotę i kwotę wynikającą z wykorzystania:

{
  "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 to koszt uruchomienia. settled.status ma wartość pending przez chwilę między wynikiem a rozliczeniem, a no_usage w rzadkim przypadku, gdy model nie zgłosił żadnego wykorzystania (wtedy maksimum pozostaje ceną).

Wycena przed uruchomieniem#

POST https://api.doitong.com/v1/quote/{model_id} przyjmuje dokładnie treść, którą wysłasz do run, i zwraca cenę tych danych wejściowych: cenę dokładną, z wyjątkiem modelu rozliczanego według wykorzystania, dla którego jest to maksymalny koszt uruchomienia. Nie wymaga klucza i nic nie kosztuje:

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": []
}

Z kluczem wycena zwraca również balance_credits i balance_usd (saldo API), affordable oraz key_budget_remaining. Dodaj ?currency=rub, aby uzyskać kwotę rub.

Obiekty cen#

Każda cena w API ma ten sam kształt:

• 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" } — oraz rub, rub_display i from_rub w Rosji lub z ?currency=rub;
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (kredyty API; żądanie metered dodaje mode, held, typical i settled, zobacz Rozliczanie według wykorzystania);
• account: GET https://api.doitong.com/v1/account zwraca credits (saldo API), balance: { "credits", "usd" } oraz storage (cenę przestrzeni dyskowej, wykorzystanie i miesięczne oszacowanie).

Zwroty#

• Nieprawidłowe żądanie (dowolne 4xx przed rozpoczęciem uruchomienia) nigdy nie jest obciążane.
• Żądanie kończące się statusem failed (w tym timeout) otrzymuje automatyczny pełny zwrot na saldo API.
• Żądanie anulowane przed rozpoczęciem otrzymuje pełny zwrot. Gdy model zacznie generowanie, anulowanie jest tylko żądaniem: jeśli model zakończy pracę, wynik zostanie dostarczony, a opłata pobrana.
• Pomyślne żądanie metered otrzymuje zwrot niewykorzystanej części maksimum.

Obiekt żądania pokazuje wszystko: cost.credits, cost.charged i cost.refunded.

Przestrzeń dyskowa plików#

Pliki wynikowe są przechowywane w naszej przestrzeni dyskowej. Wybierasz ją na koncie lub dla każdego uruchomienia (?storage=):

Za przechowywanie bezterminowe opłata jest pobierana raz dziennie z salda API: przechowywane GB × cena miesięczna ÷ liczba dni w miesiącu, jako wiersze księgi rodzaju storage. Ułamki kredytu API są przenoszone na kolejny dzień, więc miesiąc daje dokładnie 100 kredytów API × GB (1 GB = 1024³ bajtów; 10 GB przechowywane przez miesiąc kosztuje 1000 kredytów API). Saldo nigdy nie spada poniżej zera: gdy nie można pobrać opłaty, ten dzień nie jest obciążany, otrzymasz wiadomość e-mail i masz 30 dni na doładowanie, zanim przechowywane pliki staną się tymczasowe i zostaną usunięte 7 dni później. Szczegóły: Pliki.

Bieżące ceny#

To wyróżnione modele. Wszystkie 1496 modeli i ich ceny znajdują się w katalogu modeli oraz w GET /models (klucz nie jest wymagany).

Doładowanie#

Dodaj środki do salda API pod adresem https://doitong.com/developers/dashboard#balance. Gdy saldo jest zbyt niskie, uruchomienie zwraca 402 insufficient_credits z top_up_url. Każdy klucz API można również ograniczyć własnym budżetem w kredytach API (zobacz Uwierzytelnianie).