Saltearse al contenido

Créditos y uso

Los servicios facturables se liquidan en créditos de cuenta. Las cantidades se expresan en milicréditos (millicredits); 1000 milicréditos equivalen a 1 crédito. Las cantidades que envíe en las solicitudes deben ser números enteros; las cantidades en saldos y registros pueden incluir un decimal (0,1 milicrédito). credit_precision en las respuestas es 4, lo que significa como máximo 4 decimales una vez convertidos a créditos.

GET /api/v1/billing/credits/balance
Ventana de terminal
curl https://omnidoc.top/api/v1/billing/credits/balance \
-H "X-API-Key: $OMNIDOC_API_KEY"

Campos clave:

CampoSignificado
availableMillicréditos disponibles ahora, después de la deuda; negativos cuando se está endeudado
debtDeuda en milicréditos: la parte del costo real de los trabajos completados que superó el saldo. Los créditos que llegan posteriormente (recargas, subvenciones diarias, códigos canjeables, reembolsos, etc.) se aplican primero a saldar la deuda.
spentTotal de milicréditos liquidados
expiredMillicréditos que expiraron o fueron retirados
today_chargedMillicréditos liquidados hoy
lotsLotes de crédito actualmente válidos y su fecha de vencimiento
GET /api/v1/billing/credits/plans

Un punto de acceso público que no requiere inicio de sesión y devuelve los paquetes en oferta (purchase_plans, indexados por código de plan). Ahora en oferta:

Código del planCréditosPrecioBono
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4 (recomendado)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • El “bono” se calcula sobre el precio de 10.000 créditos por 29,90 ¥ y corresponde al campo bonus_percent; el paquete recomendado tiene recommended: true. Ninguno de los dos campos aparece cuando no está definido.
  • price_fen (en fen, 1/100 de yuan) es la unidad oficial para el precio, y total_millicredits (milicréditos) para los créditos. Los créditos adquiridos no caducan; los paquetes pueden volver a comprarse y se entregan en una sola remesa cada vez.
  1. El saldo se verifica frente a un umbral antes de iniciar un trabajo : el saldo (después de la deuda) debe ser superior al umbral del trabajo; por ejemplo, “páginas × 2 créditos” para la traducción PDF, la longitud del texto fuente para otros archivos (al menos 2 créditos), y para audio, video y voz, el costo calculado a partir de la duración o los caracteres medidos por el servidor (precios en audio, video y voces ). Con una clave API que tenga un presupuesto, el presupuesto restante de la clave también debe superar el umbral. De lo contrario, la respuesta es 402 (un trabajo de traducción de archivo finaliza como fallido con quota_exceeded=true, un trabajo multimedia finaliza con error_code=insufficient_credits) y no se cobra nada. Iniciar un trabajo no modifica el saldo.
  2. El uso real se cobra al finalizar : la traducción de archivos (incluidas las imágenes), el texto enriquecido por lotes, las operaciones con documentos, el audio, el video y el habla se cobran íntegramente según el uso real al completarse. El presupuesto de una clave API solo participa en la verificación antes del inicio y nunca reduce el cargo por un trabajo completado; si eso hace que el presupuesto utilizado de la clave supere su límite, la clave no podrá iniciar nuevos trabajos hasta que se aumente el límite. Los trabajos fallidos o cancelados no se cobran.
  3. El saldo puede quedar negativo : la parte del costo real que supera el saldo se registra como deuda y el saldo aparece como negativo; los abonos que lleguen posteriormente saldan primero la deuda. No se pueden iniciar nuevos trabajos mientras el saldo sea negativo; recárguelo.

Los clientes nunca solicitan “cuánto debería cobrarse”; el servidor calcula el importe liquidado en función de lo entregado.

GET /api/v1/billing/credits/operations?limit=20
GET /api/v1/billing/credits/operations/{operation_id}
GET /api/v1/billing/credits/jobs/{job_id}

Un registro contiene el ID de la operación, el estado, la base de facturación y los importes cobrados y reembolsados. Con una clave API especificada, las operaciones incluyen únicamente aquellas iniciadas por dicha clave.

GET /api/v1/usage?limit=50
GET /api/v1/usage/summary

Los puntos finales de uso devuelven el recuento de archivos, caracteres y tokens de la cuenta, así como el tiempo de procesamiento.

Consultar el saldo, el estado de los trabajos, el uso, los registros de liquidación, las listas de resultados y las direcciones de descarga no consume créditos.