Créditos e uso
Os serviços cobráveis são liquidados em créditos de conta. Os valores são expressos em milicréditos (millicredits); 1000 milicréditos equivalem a 1 crédito. Os valores enviados nas solicitações devem ser números inteiros; os valores nos saldos e registros podem ter uma casa decimal (0,1 milicrédito). credit_precision nas respostas é 4, ou seja, no máximo 4 casas decimais após a conversão para créditos.
Verifique o saldo
Seção intitulada “Verifique o saldo”GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"Campos-chave:
| Campo | Significado |
|---|---|
available | Millicréditos disponíveis agora, após dívida; negativos quando em dívida |
debt | Dívida em milicréditos: a parcela do custo real dos trabalhos concluídos que excedeu o saldo. Créditos recebidos posteriormente (recargas, subsídios diários, códigos de resgate, reembolsos etc.) são utilizados para quitar a dívida primeiro. |
spent | Total de milicréditos liquidados |
expired | Millicredits que expiraram ou foram retirados |
today_charged | Millicredits liquidados hoje |
lots | Lotes de crédito atualmente válidos e seu vencimento |
Pacotes de créditos
Seção intitulada “Pacotes de créditos”GET /api/v1/billing/credits/plansUm ponto de extremidade público que não requer login e retorna os pacotes à venda (purchase_plans, indexados pelo código do plano). À venda agora:
| Código do plano | Créditos | Preço | Bônus |
|---|---|---|---|
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% |
- O “Bônus” é calculado com base no preço de 10.000 créditos por ¥29,90 e corresponde ao campo
bonus_percent; o pacote recomendado possuirecommended: true. Nenhum dos campos é exibido quando não está definido. price_fen(em fen, 1/100 de yuan) é a referência oficial para o preço, etotal_millicredits(milicréditos) para os créditos. Os créditos adquiridos não expiram; os pacotes podem ser comprados novamente e chegam todos de uma só vez em cada compra.
Ciclo de vida do carregamento
Seção intitulada “Ciclo de vida do carregamento”- O saldo é verificado em relação a um limite antes de iniciar um trabalho : o saldo (após débitos) deve estar acima do limite do trabalho; por exemplo, “páginas × 2 créditos” para tradução PDF, o tamanho do texto de origem para outros arquivos (no mínimo 2 créditos) e, para áudio, vídeo e fala, o custo calculado com base na duração ou no número de caracteres medidos pelo servidor (preços em áudio, vídeo e vozes ). Com uma chave API que possui orçamento, o saldo restante da chave também deve estar acima do limite. Caso contrário, a resposta é
402(um trabalho de tradução de arquivo termina como falha comquota_exceeded=true, um trabalho de mídia termina comerror_code=insufficient_credits) e nada é cobrado. Iniciar um trabalho não altera o saldo. - O uso efetivo é cobrado quando finalizado : a tradução de arquivos (incluindo imagens), texto rico em lote, operações com documentos, áudio, vídeo e fala são cobrados integralmente pelo uso efetivo ao serem concluídos. O orçamento de uma chave API participa apenas da verificação antes do início e nunca reduz a cobrança por um trabalho concluído; se isso fizer com que o orçamento utilizado pela chave ultrapasse seu limite, a chave não poderá iniciar novos trabalhos até que o limite seja aumentado. Trabalhos falhos ou cancelados não são cobrados.
- O saldo pode ficar negativo : a parte do custo real que excede o saldo é registrada como dívida e o saldo passa a ser negativo; créditos que chegarem posteriormente quitam a dívida primeiro. Novos trabalhos não podem iniciar enquanto o saldo estiver negativo; faça um aporte.
Os clientes nunca solicitam “quanto deve ser cobrado”; o servidor calcula o valor final com base no que foi entregue.
Operações e registros
Seção intitulada “Operações e registros”GET /api/v1/billing/credits/operations?limit=20GET /api/v1/billing/credits/operations/{operation_id}GET /api/v1/billing/credits/jobs/{job_id}Um registro contém o ID da operação, o status, a base de cobrança e os valores cobrados e reembolsados. Listadas com uma chave API, as operações incluem apenas aquelas iniciadas por essa chave.
GET /api/v1/usage?limit=50GET /api/v1/usage/summaryOs endpoints de uso retornam a contagem de arquivos, caracteres, tokens e o tempo de processamento da conta.
As consultas são gratuitas
Seção intitulada “As consultas são gratuitas”Consultar o saldo, o status do trabalho, o consumo, os registros de liquidação, as listas de resultados e os endereços de download não consome créditos.