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.
Verifique el saldo
Sección titulada «Verifique el saldo»GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"Campos clave:
| Campo | Significado |
|---|---|
available | Millicréditos disponibles ahora, después de la deuda; negativos cuando se está endeudado |
debt | Deuda 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. |
spent | Total de milicréditos liquidados |
expired | Millicréditos que expiraron o fueron retirados |
today_charged | Millicréditos liquidados hoy |
lots | Lotes de crédito actualmente válidos y su fecha de vencimiento |
Paquetes de créditos
Sección titulada «Paquetes de créditos»GET /api/v1/billing/credits/plansUn 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 plan | Créditos | Precio | Bono |
|---|---|---|---|
credits_3000_v4 | 3,000 | ¥9.90 | — |
credits_10000_v4 | 10,000 | ¥29.90 | — |
credits_25000_v4 | 25,000 | ¥69 | 8% |
credits_50000_v4 (recomendado) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- El “bono” se calcula sobre el precio de 10.000 créditos por 29,90 ¥ y corresponde al campo
bonus_percent; el paquete recomendado tienerecommended: 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, ytotal_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.
Ciclo de carga
Sección titulada «Ciclo de carga»- 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 conquota_exceeded=true, un trabajo multimedia finaliza conerror_code=insufficient_credits) y no se cobra nada. Iniciar un trabajo no modifica el saldo. - 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.
- 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.
Operaciones y registros
Sección titulada «Operaciones y registros»GET /api/v1/billing/credits/operations?limit=20GET /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=50GET /api/v1/usage/summaryLos puntos finales de uso devuelven el recuento de archivos, caracteres y tokens de la cuenta, así como el tiempo de procesamiento.
Las consultas son gratuitas
Sección titulada «Las consultas son gratuitas»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.