Precios

Cada modelo cuesta exactamente lo que cobra su creador, en dólares estadounidenses. Pagas con tu saldo de API, que se contabiliza en créditos de API: 1,000 créditos de API = $1. El saldo de API es independiente y está separado de los créditos de las aplicaciones de Doitong. No hay planes, mínimos ni cargos por modelo: una llamada cuesta su precio, descontado del saldo de API cuando se acepta la solicitud.

En Rusia (doitong.ru, api.doitong.ru o ?currency=rub), los precios también se muestran en rublos: el precio en USD × la tasa USD/RUB × 1.3.

Unidades#

Cada modelo tiene una unidad de facturación, que se muestra en su página y en GET https://api.doitong.com/v1/models/{model_id}:

Precio = cantidad × créditos de API por unidad, redondeado hacia arriba a un crédito de API entero ($0.001), nunca menos de 1. Las unidades muy económicas pueden tener un precio fraccionario por unidad (0.4 créditos de API por segundo); solo se redondea el total de una llamada.

Algunos modelos cobran una tarifa diferente según la entrada: el video con sonido cuesta más que sin sonido, 4K cuesta más que 1K, etc. Estas reglas se indican en la página de cada modelo. Un parámetro que omitas cuenta como su valor predeterminado, así que el precio que ves para una entrada es el precio que pagas.

Precios exactos, medidos, estimados y por uso#

Cada precio tiene un mode:

• exact: el precio se calcula a partir de tu entrada (segundos, imágenes, megapíxeles, caracteres, pasos o un precio fijo por video o llamada).
• measured: el precio depende de los archivos que envías: la duración de un video o audio de entrada, el tamaño de una imagen de entrada, la velocidad de fotogramas o la cantidad de fotogramas de un video. Los escaladores, las herramientas de sincronización labial, de video a video, de transcripción y de audio se cobran de esta manera. Antes de la ejecución, la API lee la duración, resolución y velocidad de fotogramas del archivo (la cotización hace lo mismo), por lo que la cotización es exactamente lo que cobra la ejecución. La página del modelo indica por qué pagas ("Precio por segundo de tu video de entrada") y su calculadora usa los datos de tu archivo. Un archivo que no se puede leer se rechaza con unmeasurable_input y no se cobra nada.
• estimate: el costo del modelo depende de algo que la entrada no puede indicar por adelantado (tokens, tiempo de procesamiento). Este tipo de modelo cobra un precio estimado fijo por ejecución (por imagen de salida cuando tiene una cantidad de imágenes), calculado a partir del costo promedio de ejecuciones reales de ese modelo. Aun así, conoces el precio antes de ejecutar: la cotización es lo que pagas.
• metered: al modelo se le cobra según el uso real, que solo conoce la ejecución: los tokens que un modelo de lenguaje o visión lee y escribe, los segundos de voz que genera un modelo de voz o el tiempo de procesamiento del modelo. Consulta Cobro por uso más abajo.

Las páginas de los modelos indican "Precio por ejecución", "Precio por segundo de tu video de entrada" (y similares), "Precio estimado por ejecución" o "Cobro por uso"; GET https://api.doitong.com/v1/models?mode=measured, ?mode=estimate y ?mode=metered los enumeran.

Cobro por uso#

Un modelo metered tiene un precio por uso ("$0.01 por cada 1000 tokens", "$0.002 por segundo de audio generado", "$0.00111 por segundo de tiempo de procesamiento") y un máximo por ejecución: lo máximo que puede costar la ejecución, según lo que indica tu solicitud (max_tokens, la longitud de tu texto, la resolución, la cantidad de salidas) y los límites publicados del modelo. Nunca depende del contenido de un archivo detrás de una URL. Para un modelo facturado por tiempo de procesamiento o por la duración de una sesión de voz, el máximo es lo más que puede durar una solicitud (15 minutos para imágenes, 30 para audio, 60 para video), por lo que está muy por encima de una ejecución típica. Una entrada cuyo máximo superaría el límite por ejecución del modelo (un texto muy largo) se rechaza con 422 invalid_input:

1. La cotización devuelve ese máximo como credits (con hold y typical, una ejecución habitual). Cuando comienza la ejecución, el máximo se descuenta del saldo de API, y es lo que deben cubrir el saldo y el presupuesto de tu clave.
2. Cuando la ejecución tiene éxito, la solicitud se liquida según el uso que el modelo informa: uso × precio por uso, redondeado hacia arriba a un crédito de API entero. El resto del máximo se reembolsa automáticamente, una vez, como una fila refund de tu saldo de API.
3. Una ejecución nunca cuesta más que su máximo, aunque su uso lo superara. Una ejecución fallida o cancelada se reembolsa por completo, como siempre.

La mayoría de las ejecuciones cuesta mucho menos que el máximo; la página del modelo muestra "Hasta $X por ejecución" para la entrada del creador y la ejecución típica ("desde" en el catálogo). En los pocos modelos facturados por tiempo de procesamiento, el uso es el tiempo de procesamiento del modelo (marcado 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"
}

Después de la ejecución, cost de la solicitud muestra lo retenido y el uso registrado:

{
  "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 es el costo de la ejecución. settled.status es pending durante el momento entre el resultado y la liquidación, y no_usage en el caso poco frecuente de que el modelo no informe ningún uso (entonces el máximo se mantiene como precio).

Cotización antes de ejecutar#

POST https://api.doitong.com/v1/quote/{model_id} recibe exactamente el cuerpo que enviarías a run y devuelve el precio de esa entrada: el precio exacto, excepto para un modelo con cobro por uso, donde es lo máximo que puede costar la ejecución. No necesita clave y no tiene costo:

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

Con una clave, la cotización también devuelve balance_credits y balance_usd (tu saldo de API), affordable y key_budget_remaining. Agrega ?currency=rub para obtener un importe en rub.

Objetos de precio#

Todos los precios de la API tienen la misma estructura:

• 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" } — además de rub, rub_display y from_rub en Rusia o con ?currency=rub;
• requests: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (créditos de API; una solicitud con cobro por uso agrega mode, held, typical y settled; consulta Cobro por uso);
• account: GET https://api.doitong.com/v1/account devuelve credits (el saldo de API), balance: { "credits", "usd" } y storage (precio, uso y estimación mensual del almacenamiento de archivos).

Reembolsos#

• Una solicitud no válida (cualquier 4xx antes de que comience la ejecución) nunca se cobra.
• Una solicitud que termina en failed (incluido timeout) se reembolsa por completo al saldo de API, automáticamente.
• Una solicitud que cancelas antes de que comience se reembolsa por completo. Una vez que el modelo está generando, cancelar solo es una solicitud: si el modelo termina, se entrega el resultado y se cobra.
• Una solicitud metered que tiene éxito recupera la parte de su máximo que no utilizó.

El objeto de la solicitud muestra todo: cost.credits, cost.charged y cost.refunded.

Almacenamiento de archivos#

Los archivos de salida se conservan en nuestro almacenamiento. Tú eliges, en la cuenta o por ejecución (?storage=):

El almacenamiento permanente se cobra una vez al día del saldo de API: GB conservados × el precio mensual ÷ los días del mes, como filas contables de tipo storage. Las fracciones de un crédito de API se trasladan al día siguiente, por lo que un mes suma exactamente GB × 100 créditos de API (1 GB = 1024³ bytes; conservar 10 GB durante un mes cuesta 1,000 créditos de API). El saldo nunca baja de cero: cuando no puede pagar, ese día no se cobra, recibes un correo electrónico y tienes 30 días para hacer una recarga antes de que los archivos conservados se vuelvan temporales y se eliminen 7 días después. Detalles: Archivos.

Precios actuales#

Estos son los modelos destacados. Todos los 1,496 modelos y sus precios están en el catálogo de modelos y en GET /models (no se necesita una clave).

Recarga#

Agrega dinero al saldo de API en https://doitong.com/developers/dashboard#balance. Cuando el saldo es demasiado bajo, una ejecución responde 402 insufficient_credits con un top_up_url. Cada clave de API también puede tener su propio presupuesto en créditos de API (consulta Autenticación).