Preise

Jedes Modell kostet genau das, was sein Anbieter dafür berechnet, in US-Dollar. Du zahlst aus deinem API-Guthaben, das in API-Credits angegeben wird: 1.000 API-Credits = 1 $. Das API-Guthaben ist ein eigenes Guthaben und von den Credits der Doitong-Apps getrennt. Es gibt keine Pläne, Mindestbeträge oder modellbezogenen Gebühren: Ein Aufruf kostet seinen Preis, der vom API-Guthaben abgebucht wird, sobald die Anfrage angenommen wurde.

In Russland (doitong.ru, api.doitong.ru oder ?currency=rub) werden Preise auch in Rubel angezeigt: USD-Preis × der USD/RUB-Kurs × 1,3.

Einheiten#

Jedes Modell hat eine Abrechnungseinheit, die auf seiner Seite und in GET https://api.doitong.com/v1/models/{model_id} angezeigt wird:

Preis = Menge × API-Credits pro Einheit, auf einen ganzen API-Credit aufgerundet (0,001 $), mindestens jedoch 1. Sehr günstige Einheiten können einen Bruchteil pro Einheit kosten (0.4 API-Credits pro Sekunde); nur die Summe eines Aufrufs wird gerundet.

Einige Modelle berechnen je nach Eingabe einen anderen Tarif: Video mit Ton kostet mehr als ohne, 4K mehr als 1K und so weiter. Diese Regeln sind auf jeder Modellseite aufgeführt. Ein ausgelassener Parameter zählt als sein Standardwert, daher entspricht der angezeigte Preis für eine Eingabe dem tatsächlich gezahlten Preis.

Exakte, gemessene, geschätzte und nutzungsabhängige Preise#

Jeder Preis hat einen mode:

• exact: Der Preis wird aus deiner Eingabe berechnet (Sekunden, Bilder, Megapixel, Zeichen, Schritte oder ein Pauschalpreis pro Video oder Aufruf).
• measured: Der Preis richtet sich nach den gesendeten Dateien: der Länge eines Eingabevideos oder -audios, der Größe eines Eingabebildes, der Bildrate oder Frame-Anzahl eines Videos. Upscaling, Lippensynchronisation, Video-zu-Video, Transkription und Audio-Tools werden auf diese Weise bepreist. Vor der Ausführung liest die API die Länge, Auflösung und Bildrate der Datei (das Angebot macht dasselbe), daher entspricht der Angebotspreis genau den Kosten der Ausführung. Die Modellseite gibt an, wofür du zahlst ("Preis pro Sekunde deines Eingabevideos"), und ihr Rechner verwendet die Werte deiner Datei. Eine Datei, die nicht gelesen werden kann, wird mit unmeasurable_input abgelehnt, ohne dass Kosten entstehen.
• estimate: Die eigenen Kosten des Modells hängen von etwas ab, das die Eingabe nicht im Voraus erkennen lässt (Token, Rechenzeit). Ein solches Modell berechnet einen festen geschätzten Preis pro Ausführung (pro Ausgabebild, wenn es eine Bildanzahl gibt), basierend auf den durchschnittlichen Kosten echter Ausführungen dieses Modells. Du kennst den Preis weiterhin vor der Ausführung: Der Angebotspreis ist der zu zahlende Preis.
• metered: Das Modell wird nach tatsächlicher Nutzung abgerechnet, die nur die Ausführung selbst kennt: die Token, die ein Sprach- oder Bildverarbeitungsmodell liest und schreibt, die Sekunden Sprache, die ein Sprachmodell erzeugt, oder die Verarbeitungszeit des Modells. Siehe unten Nach Nutzung abgerechnet.

Modellseiten nennen "Preis pro Ausführung", "Preis pro Sekunde deines Eingabevideos" (und ähnliche Angaben), "Geschätzter Preis pro Ausführung" oder "Nach Nutzung abgerechnet"; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate und ?mode=metered listet sie auf.

Nach Nutzung abgerechnet#

Ein metered-Modell hat einen Nutzungspreis ("$0.01 pro 1000 Token", "$0.002 pro Sekunde erzeugtem Audio", "$0.00111 pro Sekunde Verarbeitungszeit") und ein Maximum pro Ausführung: den höchsten Betrag, den die Ausführung kosten kann, basierend auf deiner Anfrage (max_tokens, der Länge deines Textes, der Auflösung, der Anzahl der Ausgaben) und den veröffentlichten Grenzen des Modells. Es hängt niemals vom Inhalt einer Datei hinter einer URL ab. Bei einem Modell, das nach Verarbeitungszeit oder der Länge einer Sprachsitzung abgerechnet wird, entspricht das Maximum der längsten möglichen Anfrage (15 Minuten für Bilder, 30 für Audio, 60 für Video), und liegt daher weit über einer typischen Ausführung. Eine Eingabe, deren Maximum über dem Limit pro Ausführung des Modells liegen würde (etwa ein sehr langer Text), wird mit 422 invalid_input abgelehnt:

1. Das Angebot gibt dieses Maximum als credits zurück (mit hold und typical, einer typischen Ausführung). Beim Start der Ausführung wird das Maximum vom API-Guthaben abgebucht; es muss durch das Guthaben und dein Schlüsselbudget gedeckt sein.
2. Wenn die Ausführung erfolgreich ist, wird die Anfrage auf die vom Modell gemeldete Nutzung abgerechnet: Nutzung × Nutzungspreis, aufgerundet auf einen ganzen API-Credit. Der übrige Teil des Maximums wird automatisch erstattet, einmalig als refund-Eintrag im API-Guthaben.
3. Eine Ausführung kostet niemals mehr als ihr Maximum, selbst wenn ihre Nutzung höher wäre. Eine fehlgeschlagene oder abgebrochene Ausführung wird wie immer vollständig erstattet.

Die meisten Ausführungen kosten deutlich weniger als das Maximum; die Modellseite zeigt für die Eingabe des Builders "Bis zu $X pro Ausführung" und die typische Ausführung ("ab" im Katalog). Bei den wenigen Modellen, die nach Verarbeitungszeit abgerechnet werden, entspricht die Nutzung der Verarbeitungszeit des Modells (mit approximate gekennzeichnet).

{
  "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"
}

Nach der Ausführung zeigt cost der Anfrage, welcher Betrag zurückgehalten wurde und wie hoch die Nutzung war:

{
  "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 sind die Kosten der Ausführung. settled.status ist in dem kurzen Zeitraum zwischen Ergebnis und Abrechnung pending und im seltenen Fall, dass das Modell überhaupt keine Nutzung gemeldet hat, no_usage (dann bleibt das Maximum der Preis).

Angebot vor der Ausführung#

POST https://api.doitong.com/v1/quote/{model_id} nimmt genau den Body entgegen, den du an run senden würdest, und gibt den Preis dieser Eingabe zurück: den exakten Preis, außer bei einem Modell, das nach Nutzung abgerechnet wird; dort ist es der höchste Betrag, den die Ausführung kosten kann. Es benötigt keinen Schlüssel und ist kostenlos:

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

Mit einem Schlüssel gibt das Angebot außerdem balance_credits und balance_usd (dein API-Guthaben), affordable und key_budget_remaining zurück. Füge ?currency=rub für einen rub-Betrag hinzu.

Preisobjekte#

Jeder Preis in der API hat dieselbe Struktur:

• Modelle: 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" } — zusätzlich rub, rub_display und from_rub in Russland oder mit ?currency=rub;
• Anfragen: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (API-Credits; eine metered-Anfrage fügt mode, held, typical und settled hinzu, siehe Nach Nutzung abgerechnet);
• Konto: GET https://api.doitong.com/v1/account gibt credits (das API-Guthaben), balance: { "credits", "usd" } und storage (Preis, Nutzung und monatliche Schätzung des Dateispeichers) zurück.

Erstattungen#

• Eine ungültige Anfrage (jeder 4xx-Fehler vor Beginn der Ausführung) wird niemals berechnet.
• Eine Anfrage, die mit failed endet (einschließlich timeout), wird automatisch vollständig auf das API-Guthaben erstattet.
• Eine Anfrage, die du vor ihrem Start abbrichst, wird vollständig erstattet. Sobald das Modell generiert, ist ein Abbruch nur eine Anfrage: Wenn das Modell fertig wird, wird das Ergebnis geliefert und berechnet.
• Eine erfolgreiche metered-Anfrage erhält den Teil ihres Maximums zurück, den sie nicht genutzt hat.

Das Anfrageobjekt zeigt alles: cost.credits, cost.charged und cost.refunded.

Dateispeicher#

Ausgabedateien werden in unserem Speicher aufbewahrt. Du wählst dies im Konto oder pro Ausführung (?storage=):

Dauerhafter Speicher wird einmal täglich vom API-Guthaben abgerechnet: gespeicherte GB × Monatspreis ÷ Anzahl der Tage im Monat, als Ledger-Zeilen mit dem Typ storage. Bruchteile eines API-Credits werden auf den nächsten Tag übertragen, sodass ein Monat genau GB × 100 API-Credits ergibt (1 GB = 1024³ Byte; 10 GB, die einen Monat gespeichert werden, kosten 1.000 API-Credits). Das Guthaben fällt niemals unter null: Wenn die Zahlung nicht möglich ist, wird dieser Tag nicht berechnet, du erhältst eine E-Mail und hast 30 Tage zum Aufladen, bevor die gespeicherten Dateien temporär werden und 7 Tage später gelöscht werden. Details: Dateien.

Aktuelle Preise#

Dies sind die vorgestellten Modelle. Alle 1.496 Modelle und ihre Preise sind im Modellkatalog und in GET /models (kein Schlüssel erforderlich) aufgeführt.

Aufladen#

Zahle unter https://doitong.com/developers/dashboard#balance Geld auf das API-Guthaben ein. Wenn das Guthaben zu niedrig ist, antwortet eine Ausführung mit 402 insufficient_credits und einer top_up_url. Jeder API-Schlüssel kann außerdem mit einem eigenen Budget in API-Credits begrenzt werden (siehe Authentifizierung).