Pular para o conteúdo

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.

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

Campos-chave:

CampoSignificado
availableMillicréditos disponíveis agora, após dívida; negativos quando em dívida
debtDí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.
spentTotal de milicréditos liquidados
expiredMillicredits que expiraram ou foram retirados
today_chargedMillicredits liquidados hoje
lotsLotes de crédito atualmente válidos e seu vencimento
GET /api/v1/billing/credits/plans

Um 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 planoCréditosPreçoBônus
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%
  • 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 possui recommended: 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, e total_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.
  1. 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 com quota_exceeded=true, um trabalho de mídia termina com error_code=insufficient_credits) e nada é cobrado. Iniciar um trabalho não altera o saldo.
  2. 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.
  3. 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.

GET /api/v1/billing/credits/operations?limit=20
GET /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=50
GET /api/v1/usage/summary

Os endpoints de uso retornam a contagem de arquivos, caracteres, tokens e o tempo de processamento da conta.

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.