Tarification

Chaque modèle coûte exactement ce que son créateur facture, en dollars américains. Vous payez depuis votre solde API, comptabilisé en crédits API : 1 000 crédits API = 1 $. Le solde API est indépendant de celui des applications Doitong. Il n'existe ni forfait, ni minimum, ni frais par modèle : un appel coûte son prix, débité du solde API lorsque la requête est acceptée.

En Russie (doitong.ru, api.doitong.ru ou ?currency=rub), les prix sont également affichés en roubles : le prix en USD × le taux USD/RUB × 1,3.

Unités#

Chaque modèle possède une unité de facturation, affichée sur sa page et dans GET https://api.doitong.com/v1/models/{model_id} :

Prix = quantité × crédits API par unité, arrondi à l'entier supérieur de crédits API (0,001 $), avec un minimum de 1. Les unités très bon marché peuvent avoir un prix fractionnaire par unité (0.4 crédits API par seconde) ; seul le total d'un appel est arrondi.

Certains modèles appliquent un tarif différent selon l'entrée : une vidéo avec son coûte plus cher que sans son, la 4K coûte plus cher que la 1K, etc. Ces règles sont indiquées sur chaque page de modèle. Un paramètre omis prend sa valeur par défaut, donc le prix affiché pour une entrée est celui que vous payez.

Prix exacts, mesurés, estimés et liés à l'utilisation#

Chaque prix possède un mode :

• exact : le prix est calculé à partir de votre entrée (secondes, images, mégapixels, caractères, étapes ou un prix fixe par vidéo ou appel).
• measured : le prix dépend des fichiers envoyés : durée d'une vidéo ou d'un audio d'entrée, taille d'une image d'entrée, fréquence d'images ou nombre d'images d'une vidéo. Les outils d'amélioration de résolution, de synchronisation labiale, de vidéo-à-vidéo, de transcription et audio sont tarifés ainsi. Avant l'exécution, l'API lit la durée, la résolution et la fréquence d'images du fichier (le devis fait de même), donc le devis correspond exactement à ce que l'exécution facture. La page du modèle indique ce qui est facturé ("Prix par seconde de votre vidéo d'entrée") et son calculateur utilise les valeurs de votre fichier. Un fichier illisible est refusé avec unmeasurable_input et rien n'est facturé.
• estimate : le coût du modèle dépend d'un élément que l'entrée ne permet pas de connaître à l'avance (jetons, temps de calcul). Un tel modèle facture un prix estimé fixe par exécution (par image de sortie lorsqu'il possède un nombre d'images), établi à partir du coût moyen des exécutions réelles de ce modèle. Vous connaissez tout de même le prix avant l'exécution : le devis correspond à ce que vous payez.
• metered : le modèle est facturé selon l'utilisation réelle, que seule l'exécution connaît : les jetons lus et écrits par un modèle de langage ou de vision, les secondes de parole générées par un modèle vocal ou le temps de traitement du modèle. Voir Facturation selon l'utilisation ci-dessous.

Les pages des modèles indiquent « Prix par exécution », « Prix par seconde de votre vidéo d'entrée » (et autres formulations similaires), « Prix estimé par exécution » ou « Facturation selon l'utilisation » ; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate et ?mode=metered les répertorient.

Facturation selon l'utilisation#

Un modèle metered possède un prix d'utilisation ("$0.01 par 1000 jetons", "$0.002 par seconde d'audio généré", "$0.00111 par seconde de temps de traitement") et un maximum par exécution : le coût maximal de l'exécution, déterminé par ce qu'indique votre requête (max_tokens, longueur du texte, résolution, nombre de sorties) et par les limites publiées du modèle. Il ne dépend jamais du contenu d'un fichier situé derrière une URL. Pour un modèle facturé au temps de traitement ou à la durée d'une session vocale, le maximum correspond à la durée maximale d'une requête (15 minutes pour les images, 30 pour l'audio, 60 pour la vidéo), et dépasse donc largement une exécution habituelle. Une entrée dont le maximum dépasserait la limite par exécution du modèle (texte très long) est refusée avec 422 invalid_input :

1. Le devis renvoie ce maximum dans credits (avec hold et typical, une exécution habituelle). Au démarrage de l'exécution, le maximum est débité du solde API ; c'est le montant que le solde et le budget de votre clé doivent couvrir.
2. Lorsque l'exécution réussit, la requête est régularisée selon l'utilisation indiquée par le modèle : utilisation × prix d'utilisation, arrondi à l'entier supérieur de crédits API. Le reste du maximum est automatiquement remboursé, une seule fois, sous la forme d'une ligne refund dans votre solde API.
3. Une exécution ne coûte jamais plus que son maximum, même si son utilisation le dépasserait. Une exécution échouée ou annulée est intégralement remboursée, comme toujours.

La plupart des exécutions coûtent bien moins que le maximum ; la page du modèle affiche « Jusqu'à $X par exécution » pour l'entrée du générateur et l'exécution habituelle (« à partir de » dans le catalogue). Pour les quelques modèles facturés au temps de traitement, l'utilisation correspond au temps de traitement du modèle (marqué 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"
}

Après l'exécution, le cost de la requête indique le montant retenu et celui correspondant à l'utilisation :

{
  "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 correspond au coût de l'exécution. settled.status vaut pending pendant l'intervalle entre le résultat et la régularisation, et no_usage dans le rare cas où le modèle n'a signalé aucune utilisation (le maximum constitue alors le prix).

Obtenir un devis avant l'exécution#

POST https://api.doitong.com/v1/quote/{model_id} accepte exactement le corps que vous enverriez à run et renvoie le prix de cette entrée : le prix exact, sauf pour un modèle facturé selon l'utilisation, pour lequel il s'agit du coût maximal de l'exécution. Il ne nécessite aucune clé et ne coûte rien :

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

Avec une clé, le devis renvoie également balance_credits et balance_usd (votre solde API), affordable et key_budget_remaining. Ajoutez ?currency=rub pour obtenir un montant en rub.

Objets de prix#

Chaque prix dans l'API possède la même structure :

• modèles : 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" } — avec rub, rub_display et from_rub en Russie ou avec ?currency=rub ;
• requêtes : cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (crédits API ; une requête facturée selon l'utilisation ajoute mode, held, typical et settled, voir Facturation selon l'utilisation) ;
• compte : GET https://api.doitong.com/v1/account renvoie credits (le solde API), balance: { "credits", "usd" } et storage (prix, utilisation et estimation mensuelle du stockage de fichiers).

Remboursements#

• Une requête invalide (tout 4xx avant le démarrage de l'exécution) n'est jamais facturée.
• Une requête qui se termine par failed (y compris timeout) est automatiquement intégralement remboursée sur le solde API.
• Une requête que vous annulez avant son démarrage est intégralement remboursée. Une fois que le modèle génère, l'annulation n'est qu'une demande : si le modèle termine, le résultat est livré et facturé.
• Une requête metered qui réussit récupère la part de son maximum qu'elle n'a pas utilisée.

L'objet de requête affiche tous ces montants : cost.credits, cost.charged et cost.refunded.

Stockage des fichiers#

Les fichiers de sortie sont conservés dans notre stockage. Vous choisissez la durée, dans le compte ou pour chaque exécution (?storage=) :

Le stockage permanent est facturé une fois par jour sur le solde API : Go conservés × prix mensuel ÷ nombre de jours du mois, sous forme de lignes de registre de type storage. Les fractions d'un crédit API sont reportées au jour suivant ; un mois totalise donc exactement Go × 100 crédits API (1 Go = 1024³ octets ; 10 Go conservés pendant un mois coûtent 1 000 crédits API). Le solde ne descend jamais sous zéro : lorsqu'il ne permet pas de payer, le jour concerné n'est pas facturé, vous recevez un e-mail et disposez de 30 jours pour recharger avant que les fichiers conservés deviennent temporaires et soient supprimés 7 jours plus tard. Détails : Fichiers.

Prix actuels#

Voici les modèles mis en avant. Les 1 496 modèles et leurs prix figurent dans le catalogue des modèles et dans GET /models (aucune clé requise).

Recharger#

Ajoutez de l'argent au solde API à l'adresse https://doitong.com/developers/dashboard#balance. Lorsque le solde est insuffisant, une exécution renvoie 402 insufficient_credits avec un top_up_url. Chaque clé API peut également être plafonnée par son propre budget en crédits API (voir Authentification).