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 aucun forfait, 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 : prix USD × 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 $), jamais inférieur à 1. Les unités très peu coûteuses 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, le prix affiché pour une entrée est donc celui que vous payez.

Prix exacts, mesurés, estimés et fondés sur 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 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'agrandissement, de synchronisation labiale, de vidéo à vidéo, de transcription et d'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), le devis correspond donc exactement au prix de l'exécution. La page du modèle indique ce que vous payez ("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 aucun frais n'est facturé.
• estimate : le coût propre au 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 applique un prix estimé fixe par exécution (par image de sortie lorsqu'il dispose d'un nombre d'images), défini à 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, connue uniquement par l'exécution elle-même : 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 équivalents), "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 liste.

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, calculé d'après ce qu'indique votre requête (max_tokens, la longueur de votre texte, la résolution, le nombre de sorties) et 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é selon le 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) ; il est donc bien supérieur à une exécution typique. Une entrée dont le maximum excéderait la limite par exécution du modèle (un 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 cette somme 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 rapporté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 forme de 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 selon le 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 la somme retenue et celle 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#

Tous les prix de l'API ont la même forme :

• 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" } — plus 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 metered 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 intégralement remboursée sur le solde API, automatiquement.
• Une requête que vous annulez avant son démarrage est intégralement remboursée. Une fois que le modèle génère, une annulation n'est qu'une demande : si le modèle termine, le résultat est remis et facturé.
• Une requête metered qui réussit récupère la partie de son maximum qu'elle n'a pas utilisée.

L'objet de requête affiche tous ces éléments : 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 par exécution (?storage=) :

Le stockage permanent est facturé une fois par jour depuis le solde API : Go conservés × prix mensuel ÷ nombre de jours du mois, sous forme de lignes comptables de type storage. Les fractions de 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 devient jamais négatif : lorsqu'il ne permet pas le paiement, cette journée n'est pas facturée, vous recevez un e-mail et disposez de 30 jours pour effectuer un rechargement 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 à la une. Les 1 496 modèles et leurs prix figurent dans le catalogue des modèles et dans GET /models (aucune clé requise).

Rechargement#

Ajoutez des fonds 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 limitée par son propre budget en crédits API (voir Authentification).