Precios

Cada modelo cuesta exactamente lo que cobra su creador, en dólares estadounidenses. Pagas desde tu saldo de API, que se cuenta en créditos de API: 1000 créditos de API = 1 $. El saldo de API es independiente del saldo de las aplicaciones de Doitong. No hay planes, mínimos ni tarifas por modelo: una llamada cuesta su precio, que se descuenta 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 baratas 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 aparecen en la página de cada modelo. Un parámetro que omitas cuenta como su valor predeterminado, por lo 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 el número de fotogramas de un video. Los escaladores, las herramientas de sincronización labial, video a video, transcripción y audio tienen este precio. Antes de ejecutar, la API lee la duración, la resolución y la velocidad de fotogramas del archivo (la cotización hace lo mismo), por lo que la cotización coincide exactamente con 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 pueda leer se rechaza con unmeasurable_input y no se cobra nada.
• estimate: el coste propio del modelo depende de algo que la entrada no puede indicar de antemano (tokens, tiempo de cómputo). Ese modelo cobra un precio estimado fijo por ejecución (por imagen de salida cuando tiene un número de imágenes), establecido a partir del coste medio 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 propia 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 enumera.

Cobro por uso#

Un modelo metered tiene un precio de uso ("$0.01 por 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 indique tu solicitud (max_tokens, la longitud de tu texto, la resolución, el número 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 la duración máxima que puede tener una solicitud (15 minutos para imágenes, 30 para audio, 60 para video), por lo que está muy por encima de una ejecución habitual. 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 empieza 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 termina correctamente, la solicitud se liquida según el uso que el modelo informa: uso × precio de 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 del 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 recibe un reembolso completo, como siempre.

La mayoría de las ejecuciones cuestan 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 habitual ("desde" en el catálogo). Para los pocos modelos facturados por tiempo de procesamiento, el uso es el tiempo de procesamiento del modelo (marcado como 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, el cost de la solicitud muestra lo retenido y el importe correspondiente al uso:

{
  "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 lo que costó 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).

Cotizar antes de ejecutar#

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

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. Añade ?currency=rub para obtener un importe en rub.

Objetos de precio#

Todos los precios de la API tienen la misma estructura:

• modelos: 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;
• solicitudes: cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 } (créditos de API; una solicitud metered añade mode, held, typical y settled; consulta Cobro por uso);
• cuenta: GET https://api.doitong.com/v1/account devuelve credits (el saldo de API), balance: { "credits", "usd" } y storage (precio del almacenamiento de archivos, uso y estimación mensual).

Reembolsos#

• Una solicitud no válida (cualquier 4xx antes de que empiece la ejecución) nunca se cobra.
• Una solicitud que termina en failed (incluido timeout) recibe automáticamente un reembolso completo en el saldo de API.
• Una solicitud que canceles antes de que empiece recibe un reembolso completo. Una vez que el modelo está generando, cancelar es solo una solicitud: si el modelo termina, se entrega el resultado y se cobra.
• Una solicitud metered que termina correctamente recupera la parte de su máximo que no utilizó.

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

Almacenamiento de archivos#

Los archivos de salida se conservan en nuestro almacenamiento. Puedes elegirlo en la cuenta o por ejecución (?storage=):

El almacenamiento permanente se cobra una vez al día del saldo de API: GB conservados × precio mensual ÷ días del mes, como filas del libro mayor 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; 10 GB conservados durante un mes cuestan 1000 créditos de API). El saldo nunca baja de cero: cuando no puede pagar, ese día no se cobra, recibes un correo y tienes 30 días para recargar antes de que los archivos conservados pasen a ser temporales y se eliminen 7 días después. Detalles: Archivos.

Precios actuales#

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

Recargar#

Añade 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).